cobalt/site/docs/reference/starboard/configuration-public.md

layout: doc title: “Starboard Configuration Reference Guide”

Architecture Configuration

Properties
`SB_HAS_QUIRK_DOES_NOT_STACK_ALIGN_OVER_16_BYTES` Some platforms will not align variables on the stack with an alignment greater than 16 bytes. Platforms where this is the case should define the following quirk. By default, this property is undefined.
`SB_HAS_QUIRK_THREAD_AFFINITY_UNSUPPORTED` Some platforms do not have thread affinity support. Platforms where this is the case should define the following quirk. By default, this property is undefined.

Compiler Configuration

Properties
`SB_C_FORCE_INLINE` The platform's annotation for forcing a C function to be inlined. The default value in the Stub implementation is `__inline__ __attribute__((always_inline))`
`SB_C_INLINE` The platform's annotation for marking a C function as suggested to be inlined. The default value in the Stub implementation is `inline`
`SB_C_NOINLINE` The platform's annotation for marking a C function as forcibly not inlined. The default value in the Stub implementation is `__attribute__((noinline))`
`SB_EXPORT_PLATFORM` The platform's annotation for marking a symbol as exported outside of the current shared library. The default value in the Stub implementation is `__attribute__((visibility("default")))`
`SB_IMPORT_PLATFORM` The platform's annotation for marking a symbol as imported from outside of the current linking unit.

Extensions Configuration

Properties
`SB_HAS_STD_UNORDERED_HASH` Do not use <unordered_map> and <unordered_set> for the hash table types. The default value in the Stub implementation is `0`
`SB_HAS_LONG_LONG_HASH` GCC/Clang doesn't define a long long hash function, except for Android and Game consoles. The default value in the Stub implementation is `0`
`SB_HAS_STRING_HASH` GCC/Clang doesn't define a string hash function, except for Game Consoles. The default value in the Stub implementation is `0`
`SB_HAS_HASH_USING` Desktop Linux needs a using statement for the hash functions. The default value in the Stub implementation is `0`
`SB_HAS_HASH_VALUE` Set this to 1 if hash functions for custom types can be defined as a hash_value() function. Otherwise, they need to be placed inside a partially-specified hash struct template with an operator(). The default value in the Stub implementation is `0`
`SB_HAS_HASH_WARNING` Set this to 1 if use of hash_map or hash_set causes a deprecation warning (which then breaks the build). The default value in the Stub implementation is `1`
`SB_HASH_MAP_INCLUDE` The location to include hash_map on this platform. The default value in the Stub implementation is `<ext/hash_map>`
`SB_HASH_NAMESPACE` C++'s hash_map and hash_set are often found in different namespaces depending on the compiler. The default value in the Stub implementation is `__gnu_cxx`
`SB_HASH_SET_INCLUDE` The location to include hash_set on this platform. The default value in the Stub implementation is `<ext/hash_set>`

Filesystem Configuration

Properties
`SB_HAS_QUIRK_FILESYSTEM_ZERO_FILEINFO_TIME` Some operating systems constantly return zero values for creation, access and modification time for files and directories. When this quirk is defined, we need to ignore corresponded time values in applications as well as take this fact into account in unit tests. By default, this property is undefined.
`SB_HAS_QUIRK_FILESYSTEM_COARSE_ACCESS_TIME` On some platforms the file system stores access times at a coarser granularity than other times. When this quirk is defined, we assume the access time is of 1 day precision. By default, this property is undefined.
`SB_HAS_QUIRK_HASH_FILE_NAME` On some platforms the file system cannot access extremely long file names. We do not need this feature on stub. By default, this property is undefined.

Graphics Configuration

Properties
`SB_HAS_NV12_TEXTURE_SUPPORT` Indicates whether or not the given platform supports rendering of NV12 textures. These textures typically originate from video decoders. The default value in the Stub implementation is `0`
`SB_HAS_VIRTUAL_REALITY` The default value in the Stub implementation is `1`

I/O Configuration

Properties
`SB_HAS_ON_SCREEN_KEYBOARD` Whether the current platform implements the on screen keyboard interface. The default value in the Stub implementation is `0`
`SB_HAS_SPEECH_SYNTHESIS` Whether the current platform has speech synthesis. The default value in the Stub implementation is `1`

Media Configuration

Properties
`SB_HAS_QUIRK_SUPPORT_INT16_AUDIO_SAMPLES` The implementation is allowed to support kSbMediaAudioSampleTypeInt16 only when this macro is defined. By default, this property is undefined.

Memory Configuration

Properties
`SB_CAN_MAP_EXECUTABLE_MEMORY` Whether this platform can map executable memory. Implies SB_HAS_MMAP. This is required for platforms that want to JIT. The default value in the Stub implementation is `1`

Network Configuration

Properties
`SB_HAS_IPV6` Specifies whether this platform supports IPV6. The default value in the Stub implementation is `1`
`SB_HAS_PIPE` Specifies whether this platform supports pipe. The default value in the Stub implementation is `1`

System Header Configuration

Any system headers listed here that are not provided by the platform will be emulated in starboard/types.h.

Properties
`SB_HAS_SYS_TYPES_H` Whether the current platform provides the standard header sys/types.h. The default value in the Stub implementation is `0`
`SB_HAS_SSIZE_T` Whether the current platform provides ssize_t. The default value in the Stub implementation is `1`
`SB_IS_WCHAR_T_UTF32` Type detection for wchar_t. The default value in the Stub implementation is `1`
`SB_IS_WCHAR_T_UTF16` The default value in the Stub implementation is `1`
`SB_IS_WCHAR_T_UNSIGNED` Chrome only defines this for ARMEL. Chrome has an exclusion for iOS here, we should too when we support iOS. The default value in the Stub implementation is `1`
`SB_HAS_QUIRK_SOCKET_BSD_HEADERS` This quirk is used to switch the headers included in starboard/shared/linux/socket_get_interface_address.cc for darwin system headers. It may be removed at some point in favor of a different solution. By default, this property is undefined.
`SB_HAS_QUIRK_NO_GMTIME_R` Some platforms don't support gmtime_r. Platforms where this is the case should define the following quirk. By default, this property is undefined.

Timing API

Properties
`SB_HAS_TIME_THREAD_NOW` Whether this platform has an API to retrieve how long the current thread has spent in the executing state. The default value in the Stub implementation is `1`