Difference between revisions of "RetailOS"
| Line 28: | Line 28: | ||
We have found some 'secret' options that can be set by creating specially named files. See [[RetailOS_Options|Options]]. | We have found some 'secret' options that can be set by creating specially named files. See [[RetailOS_Options|Options]]. | ||
| + | |||
| + | == RTXC == | ||
| + | |||
| + | === Services / Syscalls === | ||
| + | |||
| + | This table comes from cross-referencing RetailOS, publicly available RTXC PDFs and publicly availble RTXC binaries with debug symbols. | ||
| + | |||
| + | {| class="wikitable" | ||
| + | |- | ||
| + | ! Name !! Number !! Description | ||
| + | |- | ||
| + | | void KS_pend(SEMA sema) || 0x03 || Semaphore DONE -> PENDING. | ||
| + | |- | ||
| + | | RTXCMSG *KS_receive(MBOX mailbox, TASK task) || 0x05 || Receive from mailbox. | ||
| + | |- | ||
| + | | KSRC KS_enqueue[w](QUEUE queue, void *entry) || 0x0c || Push into FIFO (and block if full with 'w' variant). | ||
| + | |- | ||
| + | | void KS_dequeue[w](QUEUE queue, void *dest) || 0x0d || Pop from FIFO (and block if empty with 'w' variant). | ||
| + | |- | ||
| + | | void KS_execute(TASK task) || 0x15 || Start a task from its beginning address. | ||
| + | |- | ||
| + | | KSRC KS_deftask(TASK task, PRIORITY priority, char *stack, size_t stacksize, void (*entry)(void)) || 0x16 || Define the attributes of an inactive task. | ||
| + | |- | ||
| + | | TASK KS_alloc_task(void) || 0x17 || Allocate the next available Task Control Block from the pool of free TCBs. | ||
| + | |} | ||
| + | |||
== External links == | == External links == | ||
* [https://web.archive.org/web/19990220054659/http://www.rtxc.com/Products/RTXC/Services.htm RTXC Kernel Services (1999)] | * [https://web.archive.org/web/19990220054659/http://www.rtxc.com/Products/RTXC/Services.htm RTXC Kernel Services (1999)] | ||
Revision as of 22:54, 18 February 2023
The stock operating system running on non-iOS iPods. It runs everything from device drivers to the clickwheel user interface.
Contents
Naming
The only 'official' name seems to be 'RetailOS', found in the Nano 3G WTF. It is also referred to as 'osos' per the file name in the resource partition of the firmware bundle.
Architecture
RetailOS is a small, embedded, single-user, single-binary, real time operating system. With time it acquire more and more complex functionality, like PowerVR drivers and being able to load external applications ('eApps') which are used for games.
The core of the system is based on RTXC 3.2, with the end-user interface based on intellectual property from a company called Pixo. [1]
Security
As evidenced by the success of the Notes vulnerability, at least up to Nano 4G there was no kind of security hardening, and in fact all processes, including games, seem to be running in ARM system mode. This should make exploitation of newer RetailOS bugs trivial.
Boot chain
RetailOS is loaded by the second-stage bootloader (stored on NOR/NAND depending on the device generation), from NAND into DRAM.
While other stages of the boot chain (eg. the bootloader, WTF mode in newer devices, the diagnostics tool) are based around EFI firmware volumes and an EFI runtime, RetailOS is a single binary blob without any built-in modularity.
eApp Signing
Not yet documented fully. Each game seems to ship with a Manifest.plist.p7p which is a PKCS#7 signature for the main Manifest.plist.
Options
We have found some 'secret' options that can be set by creating specially named files. See Options.
RTXC
Services / Syscalls
This table comes from cross-referencing RetailOS, publicly available RTXC PDFs and publicly availble RTXC binaries with debug symbols.
| Name | Number | Description |
|---|---|---|
| void KS_pend(SEMA sema) | 0x03 | Semaphore DONE -> PENDING. |
| RTXCMSG *KS_receive(MBOX mailbox, TASK task) | 0x05 | Receive from mailbox. |
| KSRC KS_enqueue[w](QUEUE queue, void *entry) | 0x0c | Push into FIFO (and block if full with 'w' variant). |
| void KS_dequeue[w](QUEUE queue, void *dest) | 0x0d | Pop from FIFO (and block if empty with 'w' variant). |
| void KS_execute(TASK task) | 0x15 | Start a task from its beginning address. |
| KSRC KS_deftask(TASK task, PRIORITY priority, char *stack, size_t stacksize, void (*entry)(void)) | 0x16 | Define the attributes of an inactive task. |
| TASK KS_alloc_task(void) | 0x17 | Allocate the next available Task Control Block from the pool of free TCBs. |
