RTEMS 4.0.0 On-Line Library

Configuring a System POSIX API Configuration Table

RTEMS C User's Guide

21.3: POSIX API Configuration Table

The POSIX API Configuration Table is used to configure the managers which constitute the POSIX API for a particular application. For example, the user can configure the maximum number of threads for this application. The POSIX API Configuration Table is defined in the following C structure:

typedef struct {
  void       *(*thread_entry)(void *);
} posix_initialization_threads_table;

typedef struct {
  int                                 maximum_threads;
  int                                 maximum_mutexes;
  int                                 maximum_condition_variables;
  int                                 maximum_keys;
  int                                 maximum_queued_signals;
  int                                 number_of_initialization_tasks;
  posix_initialization_threads_table *User_initialization_tasks_table;
} posix_api_configuration_table;

maximum_threads: is the maximum number of threads that can be concurrently active (created) in the system including initialization threads.
maximum_mutexes: is the maximum number of mutexes that can be concurrently active in the system.
maximum_condition_variables: is the maximum number of condition variables that can be concurrently active in the system.
maximum_keys: is the maximum number of keys that can be concurrently active in the system.
maximum_queued_signals: is the maximum number of queued signals that can be concurrently pending in the system.
number_of_initialization_threads: is the number of initialization threads configured. At least one initialization threads must be configured.
User_initialization_threads_table: is the address of the Initialization Threads Table. This table contains the information needed to create and start each of the initialization threads. The format of each entry in this table is defined in the posix_initialization_threads_table structure.

RTEMS C User's Guide