| # Starboard Shared Implementations |
| |
| `src/starboard/shared` and subdirectories contain all implementation code that |
| could concievably be shared between platforms. |
| |
| ## Organization |
| |
| As much code as possible is pushed into the shared directory. Each subdirectory |
| `foo` means "files in here depend on *foo*." |
| |
| All source locations are specified relative to `src/starboard/`. |
| |
| * `shared/iso/` - Implementation files that follow ISO C and C++ standards, but |
| standards that are either new, or have historically had poor support on a |
| variety of embedded platforms. Platforms that are ISO-compliant with the |
| latest standards should be able to use these. |
| * `shared/libevent/` - libevent-specific implementation files, for platforms |
| that can build and run libevent. See `shared/libevent/README.md` for more |
| information. |
| * `shared/posix/` - POSIX-specific implementation files. Starboard |
| implementations may pull some or all of this directory to implement Starboard |
| APIs, if the platform is POSIX-compliant. |
| * `shared/pthread/` - pthread-specific implementation files, for platforms that |
| provide a *reasonable* implementation of POSIX threads. This is called out |
| separately from POSIX, because we've found that there are some platforms that |
| are fairly POSIX-y, except in their threading APIs. |
| * `shared/starboard/` - Implementations of Starboard API functions that only |
| rely on other Starboard API functions. Code in here should be reusable on any |
| platform that implements the needed APIs. |
| |
