Library:Dolphin SDK
| Vendor | Nintendo |
|---|---|
| Platforms | Platform:Nintendo GameCube |
| Versions | Dated releases 2001-2004; each library embeds its build date ("<< Dolphin SDK - AI\trelease build: Sep 5 2002 05:34:25 (0x2301) >>") |
| On this wiki | Facts · Code · Notes · Topics |
Nintendo's official GameCube SDK: C libraries named after their subsystem (OS, DVD, GX, PAD, SI, VI, AI, AR/ARQ, DSP, CARD, EXI, GBA, MTX, DB) linked statically into every licensed GameCube game, plus the startup code __start. Function names such as OSInit, OSLink, DVDOpen, GXBegin and PADRead are the same in every game, so they are the first thing to identify in a stripped DOL.
Overview
The Dolphin SDK is a set of static libraries (os.a, dvd.a, gx.a, ...) that every licensed Platform:Nintendo GameCube game links. There is no system library on the console: the OS code (threads, interrupts, caches, the arena allocator, the REL dynamic linker) lives inside each game's Format:DOL executable. The homebrew library libogc re-implements a similar API but is a different code base, with different code.
Libraries
As split in Software:The Legend of Zelda: The Wind Waker (config/GZLE01/splits.txt, 2002 SDK): os (23 files: OSInit, OSAlloc, OSArena, OSCache, OSContext, OSError, OSFont, OSInterrupt, OSLink, OSMessage, OSMutex, OSReset, OSRtc, OSSync, OSThread, OSTime...), gx (15), card (14, memory card), dvd (8), gba (6, Game Boy Advance link), gf, mtx (5, matrix/vector math with paired singles), dsp (3), ai, ar, base (PPCArch), db, exi, gd, pad, si, vi. In that game the SDK occupies the end of .text (0x802A01B0-0x80328880), followed by the CodeWarrior runtime and MSL.
Identification
- Version strings: each library has a global string
__<LIB>Version=<< Dolphin SDK - <LIB>\trelease build: <date> <time> (0x2301) >>(a tab after the library name), e.g.<< Dolphin SDK - AI\trelease build: Sep 5 2002 05:34:25 (0x2301) >>in The Wind Waker (src/dolphin/ai/ai.c). The date dates the SDK; debug builds saydebug build. Unverified: the hex value in parentheses is the compiler's__MWERKS__version. - Names are plain C (
OSLink,__OSModuleInit,DVDReadAsyncPrio), never mangled, and the same across games, so a symbol map from one decompilation names most SDK functions of another game of the same SDK vintage. __init_registersis a fixed 7-instruction function (byte signature fact of this page) that loads r1, r2 and r13; finding it gives_SDA2_BASE_and_SDA_BASE_.- OS report strings (
OSLink: unknown relocation type %3d) and fixed low-memory addresses (0x800030C8module list,0x800000F8bus clock) are characteristic; see Platform:Nintendo GameCube#Low memory (OS globals).
REL linker
OSLink/OSLinkFixed (os/OSLink.c) load Format:REL relocatable modules: they add the module to the list at 0x800030C8, convert offsets to pointers, assign BSS, then apply relocations against the DOL (module 0) and every loaded module in both directions. See the REL page for the format and its relocation types.
Startup
__start and its helpers (__init_registers, __init_hardware, __init_data, __check_pad3) sit in .init at the beginning of the DOL; see Platform:Nintendo GameCube#Boot and startup.
Code & repositories
- https://github.com/zeldaret/tww @
8b93b372dc8e841f12ddfb7e0215626f62b05417· license: CC0-1.0
Matching decompilation of The Wind Waker for all GameCube releases (GZLE01, GZLP01, GZLJ01, D44J01), CC0-1.0. Decompiled JSystem (JKernel archives and Yaz0/Yay0 decoders), Dolphin SDK (OS, OSLink REL linker, DVD, GX), CodeWarrior runtime; config/<ID>/build.sha1, symbols.txt and splits.txt map every build.
Tested on: Read at commit 8b93b37: config/GZLE01 (build.sha1, config.yml, symbols.txt, splits.txt), include/dolphin/os/OSLink.h, src/dolphin/os/OSLink.c, src/dolphin/os/__start.c, include/JSystem/JKernel/JKRArchive.h, src/JSystem/JKernel/JKRDecomp.cpp, JKRArchivePri.cpp, JKRCompArchive.cpp; no game files used. · checked 2026-10-17; last activity 2026-10-14