RTEMS Documentation Project RTEMS Classic API Guide
6.a3cfaea
  • 1. Preface
  • 2. Overview
    • 2.1. Introduction
    • 2.2. Real-time Application Systems
    • 2.3. Real-time Executive
    • 2.4. RTEMS Application Architecture
    • 2.5. RTEMS Internal Architecture
    • 2.6. User Customization and Extensibility
    • 2.7. Portability
    • 2.8. Memory Requirements
    • 2.9. Audience
    • 2.10. Conventions
    • 2.11. Manual Organization
  • 3. Key Concepts
    • 3.1. Introduction
    • 3.2. Objects
      • 3.2.1. Object Names
      • 3.2.2. Object Ids
      • 3.2.3. Local and Global Scope
        • 3.2.3.1. Object ID Format
      • 3.2.4. Object ID Description
    • 3.3. Communication and Synchronization
    • 3.4. Locking Protocols
      • 3.4.1. Priority Inversion
      • 3.4.2. Immediate Ceiling Priority Protocol (ICPP)
      • 3.4.3. Priority Inheritance Protocol
      • 3.4.4. Multiprocessor Resource Sharing Protocol (MrsP)
      • 3.4.5. O(m) Independence-Preserving Protocol (OMIP)
    • 3.5. Thread Queues
    • 3.6. Time
    • 3.7. Timer and Timeouts
    • 3.8. Memory Management
  • 4. RTEMS Data Types
    • 4.1. Introduction
    • 4.2. List of Data Types
      • 4.2.1. BSP_output_char_function_type
      • 4.2.2. BSP_polling_getchar_function_type
      • 4.2.3. Timer_Classes
      • 4.2.4. rtems_api_configuration_table
      • 4.2.5. rtems_asr
      • 4.2.6. rtems_asr_entry
      • 4.2.7. rtems_assert_context
      • 4.2.8. rtems_attribute
      • 4.2.9. rtems_device_driver
      • 4.2.10. rtems_device_driver_entry
      • 4.2.11. rtems_device_major_number
      • 4.2.12. rtems_device_minor_number
      • 4.2.13. rtems_driver_address_table
      • 4.2.14. rtems_event_set
      • 4.2.15. rtems_exception_frame
      • 4.2.16. rtems_extensions_table
      • 4.2.17. rtems_fatal_code
      • 4.2.18. rtems_fatal_extension
      • 4.2.19. rtems_fatal_source
      • 4.2.20. rtems_id
      • 4.2.21. rtems_initialization_tasks_table
      • 4.2.22. rtems_interrupt_attributes
      • 4.2.23. rtems_interrupt_entry
      • 4.2.24. rtems_interrupt_handler
      • 4.2.25. rtems_interrupt_level
      • 4.2.26. rtems_interrupt_lock
      • 4.2.27. rtems_interrupt_lock_context
      • 4.2.28. rtems_interrupt_per_handler_routine
      • 4.2.29. rtems_interrupt_server_action
      • 4.2.30. rtems_interrupt_server_config
      • 4.2.31. rtems_interrupt_server_control
      • 4.2.32. rtems_interrupt_server_entry
      • 4.2.33. rtems_interrupt_server_request
      • 4.2.34. rtems_interrupt_signal_variant
      • 4.2.35. rtems_interval
      • 4.2.36. rtems_isr
      • 4.2.37. rtems_isr_entry
      • 4.2.38. rtems_message_queue_config
      • 4.2.39. rtems_mode
      • 4.2.40. rtems_mp_packet_classes
      • 4.2.41. rtems_mpci_entry
      • 4.2.42. rtems_mpci_get_packet_entry
      • 4.2.43. rtems_mpci_initialization_entry
      • 4.2.44. rtems_mpci_receive_packet_entry
      • 4.2.45. rtems_mpci_return_packet_entry
      • 4.2.46. rtems_mpci_send_packet_entry
      • 4.2.47. rtems_mpci_table
      • 4.2.48. rtems_multiprocessing_table
      • 4.2.49. rtems_name
      • 4.2.50. rtems_object_api_class_information
      • 4.2.51. rtems_option
      • 4.2.52. rtems_packet_prefix
      • 4.2.53. rtems_rate_monotonic_period_states
      • 4.2.54. rtems_rate_monotonic_period_statistics
      • 4.2.55. rtems_rate_monotonic_period_status
      • 4.2.56. rtems_regulator_attributes
      • 4.2.57. rtems_regulator_deliverer
      • 4.2.58. rtems_regulator_statistics
      • 4.2.59. rtems_signal_set
      • 4.2.60. rtems_stack_allocate_hook
      • 4.2.61. rtems_stack_allocate_init_hook
      • 4.2.62. rtems_stack_free_hook
      • 4.2.63. rtems_status_code
      • 4.2.64. rtems_task
      • 4.2.65. rtems_task_argument
      • 4.2.66. rtems_task_begin_extension
      • 4.2.67. rtems_task_config
      • 4.2.68. rtems_task_create_extension
      • 4.2.69. rtems_task_delete_extension
      • 4.2.70. rtems_task_entry
      • 4.2.71. rtems_task_exitted_extension
      • 4.2.72. rtems_task_priority
      • 4.2.73. rtems_task_restart_extension
      • 4.2.74. rtems_task_start_extension
      • 4.2.75. rtems_task_switch_extension
      • 4.2.76. rtems_task_terminate_extension
      • 4.2.77. rtems_task_visitor
      • 4.2.78. rtems_tcb
      • 4.2.79. rtems_time_of_day
      • 4.2.80. rtems_timer_information
      • 4.2.81. rtems_timer_service_routine
      • 4.2.82. rtems_timer_service_routine_entry
      • 4.2.83. rtems_vector_number
  • 5. Scheduling Concepts
    • 5.1. Introduction
    • 5.2. Background
      • 5.2.1. Scheduling Algorithms
      • 5.2.2. Priority Scheduling
      • 5.2.3. Scheduling Modification Mechanisms
        • 5.2.3.1. Task Priority and Scheduling
        • 5.2.3.2. Preemption
        • 5.2.3.3. Timeslicing
        • 5.2.3.4. Manual Round-Robin
      • 5.2.4. Dispatching Tasks
      • 5.2.5. Task State Transitions
    • 5.3. Uniprocessor Schedulers
      • 5.3.1. Deterministic Priority Scheduler
      • 5.3.2. Simple Priority Scheduler
      • 5.3.3. Earliest Deadline First Scheduler
      • 5.3.4. Constant Bandwidth Server Scheduling (CBS)
    • 5.4. SMP Schedulers
      • 5.4.1. Earliest Deadline First SMP Scheduler
      • 5.4.2. Deterministic Priority SMP Scheduler
      • 5.4.3. Simple Priority SMP Scheduler
      • 5.4.4. Arbitrary Processor Affinity Priority SMP Scheduler
    • 5.5. Directives
      • 5.5.1. rtems_scheduler_ident()
      • 5.5.2. rtems_scheduler_ident_by_processor()
      • 5.5.3. rtems_scheduler_ident_by_processor_set()
      • 5.5.4. rtems_scheduler_get_maximum_priority()
      • 5.5.5. rtems_scheduler_map_priority_to_posix()
      • 5.5.6. rtems_scheduler_map_priority_from_posix()
      • 5.5.7. rtems_scheduler_get_processor()
      • 5.5.8. rtems_scheduler_get_processor_maximum()
      • 5.5.9. rtems_scheduler_get_processor_set()
      • 5.5.10. rtems_scheduler_add_processor()
      • 5.5.11. rtems_scheduler_remove_processor()
  • 6. Initialization Manager
    • 6.1. Introduction
    • 6.2. Background
      • 6.2.1. Initialization Tasks
      • 6.2.2. The Idle Task
      • 6.2.3. Initialization Manager Failure
    • 6.3. Operations
      • 6.3.1. Initializing RTEMS
      • 6.3.2. Global Construction
    • 6.4. Directives
      • 6.4.1. rtems_initialize_executive()
  • 7. Task Manager
    • 7.1. Introduction
    • 7.2. Background
      • 7.2.1. Task Definition
      • 7.2.2. Task Control Block
      • 7.2.3. Task Memory
      • 7.2.4. Task Name
      • 7.2.5. Task States
      • 7.2.6. Task Priority
      • 7.2.7. Task Mode
      • 7.2.8. Task Life States
      • 7.2.9. Accessing Task Arguments
      • 7.2.10. Floating Point Considerations
      • 7.2.11. Building a Task Attribute Set
      • 7.2.12. Building a Mode and Mask
    • 7.3. Operations
      • 7.3.1. Creating Tasks
      • 7.3.2. Obtaining Task IDs
      • 7.3.3. Starting and Restarting Tasks
      • 7.3.4. Suspending and Resuming Tasks
      • 7.3.5. Delaying the Currently Executing Task
      • 7.3.6. Changing Task Priority
      • 7.3.7. Changing Task Mode
      • 7.3.8. Task Deletion
      • 7.3.9. Setting Affinity to a Single Processor
      • 7.3.10. Transition Advice for Removed Notepads
      • 7.3.11. Transition Advice for Removed Task Variables
    • 7.4. Directives
      • 7.4.1. rtems_task_create()
      • 7.4.2. rtems_task_construct()
      • 7.4.3. rtems_task_ident()
      • 7.4.4. rtems_task_self()
      • 7.4.5. rtems_task_start()
      • 7.4.6. rtems_task_restart()
      • 7.4.7. rtems_task_delete()
      • 7.4.8. rtems_task_exit()
      • 7.4.9. rtems_task_suspend()
      • 7.4.10. rtems_task_resume()
      • 7.4.11. rtems_task_is_suspended()
      • 7.4.12. rtems_task_set_priority()
      • 7.4.13. rtems_task_get_priority()
      • 7.4.14. rtems_task_mode()
      • 7.4.15. rtems_task_wake_after()
      • 7.4.16. rtems_task_wake_when()
      • 7.4.17. rtems_task_get_scheduler()
      • 7.4.18. rtems_task_set_scheduler()
      • 7.4.19. rtems_task_get_affinity()
      • 7.4.20. rtems_task_set_affinity()
      • 7.4.21. rtems_task_iterate()
      • 7.4.22. RTEMS_TASK_STORAGE_SIZE()
    • 7.5. Deprecated Directives
      • 7.5.1. ITERATE_OVER_ALL_THREADS - Iterate Over Tasks
    • 7.6. Removed Directives
      • 7.6.1. TASK_GET_NOTE - Get task notepad entry
      • 7.6.2. TASK_SET_NOTE - Set task notepad entry
      • 7.6.3. TASK_VARIABLE_ADD - Associate per task variable
      • 7.6.4. TASK_VARIABLE_GET - Obtain value of a per task variable
      • 7.6.5. TASK_VARIABLE_DELETE - Remove per task variable
  • 8. Interrupt Manager
    • 8.1. Introduction
    • 8.2. Background
      • 8.2.1. Processing an Interrupt
      • 8.2.2. RTEMS Interrupt Levels
      • 8.2.3. Disabling of Interrupts by RTEMS
    • 8.3. Operations
      • 8.3.1. Establishing an ISR
      • 8.3.2. Directives Allowed from an ISR
    • 8.4. Directives
      • 8.4.1. rtems_interrupt_catch()
      • 8.4.2. rtems_interrupt_disable()
      • 8.4.3. rtems_interrupt_enable()
      • 8.4.4. rtems_interrupt_flash()
      • 8.4.5. rtems_interrupt_local_disable()
      • 8.4.6. rtems_interrupt_local_enable()
      • 8.4.7. rtems_interrupt_is_in_progress()
      • 8.4.8. rtems_interrupt_lock_initialize()
      • 8.4.9. rtems_interrupt_lock_destroy()
      • 8.4.10. rtems_interrupt_lock_acquire()
      • 8.4.11. rtems_interrupt_lock_release()
      • 8.4.12. rtems_interrupt_lock_acquire_isr()
      • 8.4.13. rtems_interrupt_lock_release_isr()
      • 8.4.14. rtems_interrupt_lock_interrupt_disable()
      • 8.4.15. RTEMS_INTERRUPT_LOCK_DECLARE()
      • 8.4.16. RTEMS_INTERRUPT_LOCK_DEFINE()
      • 8.4.17. RTEMS_INTERRUPT_LOCK_INITIALIZER()
      • 8.4.18. RTEMS_INTERRUPT_LOCK_MEMBER()
      • 8.4.19. RTEMS_INTERRUPT_LOCK_REFERENCE()
      • 8.4.20. RTEMS_INTERRUPT_ENTRY_INITIALIZER()
      • 8.4.21. rtems_interrupt_entry_initialize()
      • 8.4.22. rtems_interrupt_entry_install()
      • 8.4.23. rtems_interrupt_entry_remove()
      • 8.4.24. rtems_interrupt_handler_install()
      • 8.4.25. rtems_interrupt_handler_remove()
      • 8.4.26. rtems_interrupt_vector_is_enabled()
      • 8.4.27. rtems_interrupt_vector_enable()
      • 8.4.28. rtems_interrupt_vector_disable()
      • 8.4.29. rtems_interrupt_is_pending()
      • 8.4.30. rtems_interrupt_raise()
      • 8.4.31. rtems_interrupt_raise_on()
      • 8.4.32. rtems_interrupt_clear()
      • 8.4.33. rtems_interrupt_get_priority()
      • 8.4.34. rtems_interrupt_set_priority()
      • 8.4.35. rtems_interrupt_get_affinity()
      • 8.4.36. rtems_interrupt_set_affinity()
      • 8.4.37. rtems_interrupt_get_attributes()
      • 8.4.38. rtems_interrupt_handler_iterate()
      • 8.4.39. rtems_interrupt_server_initialize()
      • 8.4.40. rtems_interrupt_server_create()
      • 8.4.41. rtems_interrupt_server_handler_install()
      • 8.4.42. rtems_interrupt_server_handler_remove()
      • 8.4.43. rtems_interrupt_server_set_affinity()
      • 8.4.44. rtems_interrupt_server_delete()
      • 8.4.45. rtems_interrupt_server_suspend()
      • 8.4.46. rtems_interrupt_server_resume()
      • 8.4.47. rtems_interrupt_server_move()
      • 8.4.48. rtems_interrupt_server_handler_iterate()
      • 8.4.49. rtems_interrupt_server_entry_initialize()
      • 8.4.50. rtems_interrupt_server_action_prepend()
      • 8.4.51. rtems_interrupt_server_entry_destroy()
      • 8.4.52. rtems_interrupt_server_entry_submit()
      • 8.4.53. rtems_interrupt_server_entry_move()
      • 8.4.54. rtems_interrupt_server_request_initialize()
      • 8.4.55. rtems_interrupt_server_request_set_vector()
      • 8.4.56. rtems_interrupt_server_request_destroy()
      • 8.4.57. rtems_interrupt_server_request_submit()
  • 9. Clock Manager
    • 9.1. Introduction
    • 9.2. Background
      • 9.2.1. Required Support
      • 9.2.2. Time and Date Data Structures
      • 9.2.3. Clock Tick and Timeslicing
      • 9.2.4. Delays
      • 9.2.5. Timeouts
    • 9.3. Operations
      • 9.3.1. Announcing a Tick
      • 9.3.2. Setting the Time
      • 9.3.3. Obtaining the Time
      • 9.3.4. Transition Advice for the Removed rtems_clock_get()
    • 9.4. Directives
      • 9.4.1. rtems_clock_set()
      • 9.4.2. rtems_clock_get_tod()
      • 9.4.3. rtems_clock_get_tod_timeval()
      • 9.4.4. rtems_clock_get_realtime()
      • 9.4.5. rtems_clock_get_realtime_bintime()
      • 9.4.6. rtems_clock_get_realtime_timeval()
      • 9.4.7. rtems_clock_get_realtime_coarse()
      • 9.4.8. rtems_clock_get_realtime_coarse_bintime()
      • 9.4.9. rtems_clock_get_realtime_coarse_timeval()
      • 9.4.10. rtems_clock_get_monotonic()
      • 9.4.11. rtems_clock_get_monotonic_bintime()
      • 9.4.12. rtems_clock_get_monotonic_sbintime()
      • 9.4.13. rtems_clock_get_monotonic_timeval()
      • 9.4.14. rtems_clock_get_monotonic_coarse()
      • 9.4.15. rtems_clock_get_monotonic_coarse_bintime()
      • 9.4.16. rtems_clock_get_monotonic_coarse_timeval()
      • 9.4.17. rtems_clock_get_boot_time()
      • 9.4.18. rtems_clock_get_boot_time_bintime()
      • 9.4.19. rtems_clock_get_boot_time_timeval()
      • 9.4.20. rtems_clock_get_seconds_since_epoch()
      • 9.4.21. rtems_clock_get_ticks_per_second()
      • 9.4.22. rtems_clock_get_ticks_since_boot()
      • 9.4.23. rtems_clock_get_uptime()
      • 9.4.24. rtems_clock_get_uptime_timeval()
      • 9.4.25. rtems_clock_get_uptime_seconds()
      • 9.4.26. rtems_clock_get_uptime_nanoseconds()
      • 9.4.27. rtems_clock_tick_later()
      • 9.4.28. rtems_clock_tick_later_usec()
      • 9.4.29. rtems_clock_tick_before()
    • 9.5. Removed Directives
      • 9.5.1. CLOCK_GET - Get date and time information
  • 10. Timer Manager
    • 10.1. Introduction
    • 10.2. Background
      • 10.2.1. Required Support
      • 10.2.2. Timers
      • 10.2.3. Timer Server
      • 10.2.4. Timer Service Routines
    • 10.3. Operations
      • 10.3.1. Creating a Timer
      • 10.3.2. Obtaining Timer IDs
      • 10.3.3. Initiating an Interval Timer
      • 10.3.4. Initiating a Time of Day Timer
      • 10.3.5. Canceling a Timer
      • 10.3.6. Resetting a Timer
      • 10.3.7. Initiating the Timer Server
      • 10.3.8. Deleting a Timer
    • 10.4. Directives
      • 10.4.1. rtems_timer_create()
      • 10.4.2. rtems_timer_ident()
      • 10.4.3. rtems_timer_cancel()
      • 10.4.4. rtems_timer_delete()
      • 10.4.5. rtems_timer_fire_after()
      • 10.4.6. rtems_timer_fire_when()
      • 10.4.7. rtems_timer_initiate_server()
      • 10.4.8. rtems_timer_server_fire_after()
      • 10.4.9. rtems_timer_server_fire_when()
      • 10.4.10. rtems_timer_reset()
      • 10.4.11. rtems_timer_get_information()
  • 11. Rate Monotonic Manager
    • 11.1. Introduction
    • 11.2. Background
      • 11.2.1. Rate Monotonic Manager Required Support
      • 11.2.2. Period Statistics
      • 11.2.3. Periodicity Definitions
      • 11.2.4. Rate Monotonic Scheduling Algorithm
      • 11.2.5. Schedulability Analysis
        • 11.2.5.1. Assumptions
        • 11.2.5.2. Processor Utilization Rule
        • 11.2.5.3. Processor Utilization Rule Example
        • 11.2.5.4. First Deadline Rule
        • 11.2.5.5. First Deadline Rule Example
        • 11.2.5.6. Relaxation of Assumptions
    • 11.3. Operations
      • 11.3.1. Creating a Rate Monotonic Period
      • 11.3.2. Manipulating a Period
      • 11.3.3. Obtaining the Status of a Period
      • 11.3.4. Canceling a Period
      • 11.3.5. Deleting a Rate Monotonic Period
      • 11.3.6. Examples
      • 11.3.7. Simple Periodic Task
      • 11.3.8. Task with Multiple Periods
    • 11.4. Directives
      • 11.4.1. rtems_rate_monotonic_create()
      • 11.4.2. rtems_rate_monotonic_ident()
      • 11.4.3. rtems_rate_monotonic_cancel()
      • 11.4.4. rtems_rate_monotonic_delete()
      • 11.4.5. rtems_rate_monotonic_period()
      • 11.4.6. rtems_rate_monotonic_get_status()
      • 11.4.7. rtems_rate_monotonic_get_statistics()
      • 11.4.8. rtems_rate_monotonic_reset_statistics()
      • 11.4.9. rtems_rate_monotonic_reset_all_statistics()
      • 11.4.10. rtems_rate_monotonic_report_statistics()
      • 11.4.11. rtems_rate_monotonic_report_statistics_with_plugin()
  • 12. Semaphore Manager
    • 12.1. Introduction
    • 12.2. Background
      • 12.2.1. Nested Resource Access
      • 12.2.2. Priority Inheritance
      • 12.2.3. Priority Ceiling
      • 12.2.4. Multiprocessor Resource Sharing Protocol
      • 12.2.5. Building a Semaphore Attribute Set
      • 12.2.6. Building a SEMAPHORE_OBTAIN Option Set
    • 12.3. Operations
      • 12.3.1. Creating a Semaphore
      • 12.3.2. Obtaining Semaphore IDs
      • 12.3.3. Acquiring a Semaphore
      • 12.3.4. Releasing a Semaphore
      • 12.3.5. Deleting a Semaphore
    • 12.4. Directives
      • 12.4.1. rtems_semaphore_create()
      • 12.4.2. rtems_semaphore_ident()
      • 12.4.3. rtems_semaphore_delete()
      • 12.4.4. rtems_semaphore_obtain()
      • 12.4.5. rtems_semaphore_release()
      • 12.4.6. rtems_semaphore_flush()
      • 12.4.7. rtems_semaphore_set_priority()
  • 13. Barrier Manager
    • 13.1. Introduction
    • 13.2. Background
      • 13.2.1. Automatic Versus Manual Barriers
      • 13.2.2. Building a Barrier Attribute Set
    • 13.3. Directives
      • 13.3.1. rtems_barrier_create()
      • 13.3.2. rtems_barrier_ident()
      • 13.3.3. rtems_barrier_delete()
      • 13.3.4. rtems_barrier_wait()
      • 13.3.5. rtems_barrier_release()
  • 14. Message Manager
    • 14.1. Introduction
    • 14.2. Background
      • 14.2.1. Messages
      • 14.2.2. Message Queues
      • 14.2.3. Building a Message Queue Attribute Set
      • 14.2.4. Building a MESSAGE_QUEUE_RECEIVE Option Set
    • 14.3. Operations
      • 14.3.1. Creating a Message Queue
      • 14.3.2. Obtaining Message Queue IDs
      • 14.3.3. Receiving a Message
      • 14.3.4. Sending a Message
      • 14.3.5. Broadcasting a Message
      • 14.3.6. Deleting a Message Queue
    • 14.4. Directives
      • 14.4.1. rtems_message_queue_create()
      • 14.4.2. rtems_message_queue_construct()
      • 14.4.3. rtems_message_queue_ident()
      • 14.4.4. rtems_message_queue_delete()
      • 14.4.5. rtems_message_queue_send()
      • 14.4.6. rtems_message_queue_urgent()
      • 14.4.7. rtems_message_queue_broadcast()
      • 14.4.8. rtems_message_queue_receive()
      • 14.4.9. rtems_message_queue_get_number_pending()
      • 14.4.10. rtems_message_queue_flush()
      • 14.4.11. RTEMS_MESSAGE_QUEUE_BUFFER()
  • 15. Event Manager
    • 15.1. Introduction
    • 15.2. Background
      • 15.2.1. Event Sets
      • 15.2.2. Building an Event Set or Condition
      • 15.2.3. Building an EVENT_RECEIVE Option Set
    • 15.3. Operations
      • 15.3.1. Sending an Event Set
      • 15.3.2. Receiving an Event Set
      • 15.3.3. Determining the Pending Event Set
      • 15.3.4. Receiving all Pending Events
    • 15.4. Directives
      • 15.4.1. rtems_event_send()
      • 15.4.2. rtems_event_receive()
  • 16. Signal Manager
    • 16.1. Introduction
    • 16.2. Background
      • 16.2.1. Signal Manager Definitions
      • 16.2.2. A Comparison of ASRs and ISRs
      • 16.2.3. Building a Signal Set
      • 16.2.4. Building an ASR Mode
    • 16.3. Operations
      • 16.3.1. Establishing an ASR
      • 16.3.2. Sending a Signal Set
      • 16.3.3. Processing an ASR
    • 16.4. Directives
      • 16.4.1. rtems_signal_catch()
      • 16.4.2. rtems_signal_send()
  • 17. Partition Manager
    • 17.1. Introduction
    • 17.2. Background
      • 17.2.1. Partition Manager Definitions
      • 17.2.2. Building a Partition Attribute Set
    • 17.3. Operations
      • 17.3.1. Creating a Partition
      • 17.3.2. Obtaining Partition IDs
      • 17.3.3. Acquiring a Buffer
      • 17.3.4. Releasing a Buffer
      • 17.3.5. Deleting a Partition
    • 17.4. Directives
      • 17.4.1. rtems_partition_create()
      • 17.4.2. rtems_partition_ident()
      • 17.4.3. rtems_partition_delete()
      • 17.4.4. rtems_partition_get_buffer()
      • 17.4.5. rtems_partition_return_buffer()
  • 18. Region Manager
    • 18.1. Introduction
    • 18.2. Background
      • 18.2.1. Region Manager Definitions
      • 18.2.2. Building an Attribute Set
      • 18.2.3. Building an Option Set
    • 18.3. Operations
      • 18.3.1. Creating a Region
      • 18.3.2. Obtaining Region IDs
      • 18.3.3. Adding Memory to a Region
      • 18.3.4. Acquiring a Segment
      • 18.3.5. Releasing a Segment
      • 18.3.6. Obtaining the Size of a Segment
      • 18.3.7. Changing the Size of a Segment
      • 18.3.8. Deleting a Region
    • 18.4. Directives
      • 18.4.1. rtems_region_create()
      • 18.4.2. rtems_region_ident()
      • 18.4.3. rtems_region_delete()
      • 18.4.4. rtems_region_extend()
      • 18.4.5. rtems_region_get_segment()
      • 18.4.6. rtems_region_return_segment()
      • 18.4.7. rtems_region_resize_segment()
      • 18.4.8. rtems_region_get_information()
      • 18.4.9. rtems_region_get_free_information()
      • 18.4.10. rtems_region_get_segment_size()
  • 19. Dual-Ported Memory Manager
    • 19.1. Introduction
    • 19.2. Background
    • 19.3. Operations
      • 19.3.1. Creating a Port
      • 19.3.2. Obtaining Port IDs
      • 19.3.3. Converting an Address
      • 19.3.4. Deleting a DPMA Port
    • 19.4. Directives
      • 19.4.1. rtems_port_create()
      • 19.4.2. rtems_port_ident()
      • 19.4.3. rtems_port_delete()
      • 19.4.4. rtems_port_external_to_internal()
      • 19.4.5. rtems_port_internal_to_external()
  • 20. I/O Manager
    • 20.1. Introduction
    • 20.2. Background
      • 20.2.1. Device Driver Table
      • 20.2.2. Major and Minor Device Numbers
      • 20.2.3. Device Names
      • 20.2.4. Device Driver Environment
      • 20.2.5. Runtime Driver Registration
      • 20.2.6. Device Driver Interface
      • 20.2.7. Device Driver Initialization
    • 20.3. Operations
      • 20.3.1. Register and Lookup Name
      • 20.3.2. Accessing an Device Driver
    • 20.4. Directives
      • 20.4.1. rtems_io_register_driver()
      • 20.4.2. rtems_io_unregister_driver()
      • 20.4.3. rtems_io_initialize()
      • 20.4.4. rtems_io_register_name()
      • 20.4.5. rtems_io_open()
      • 20.4.6. rtems_io_close()
      • 20.4.7. rtems_io_read()
      • 20.4.8. rtems_io_write()
      • 20.4.9. rtems_io_control()
  • 21. Kernel Character I/O Support
    • 21.1. Introduction
    • 21.2. Directives
      • 21.2.1. rtems_putc()
      • 21.2.2. rtems_put_char()
      • 21.2.3. putk()
      • 21.2.4. printk()
      • 21.2.5. vprintk()
      • 21.2.6. rtems_printk_printer()
      • 21.2.7. getchark()
  • 22. Cache Manager
    • 22.1. Introduction
    • 22.2. Directives
      • 22.2.1. rtems_cache_flush_multiple_data_lines()
      • 22.2.2. rtems_cache_invalidate_multiple_data_lines()
      • 22.2.3. rtems_cache_invalidate_multiple_instruction_lines()
      • 22.2.4. rtems_cache_instruction_sync_after_code_change()
      • 22.2.5. rtems_cache_get_maximal_line_size()
      • 22.2.6. rtems_cache_get_data_line_size()
      • 22.2.7. rtems_cache_get_instruction_line_size()
      • 22.2.8. rtems_cache_get_data_cache_size()
      • 22.2.9. rtems_cache_get_instruction_cache_size()
      • 22.2.10. rtems_cache_flush_entire_data()
      • 22.2.11. rtems_cache_invalidate_entire_data()
      • 22.2.12. rtems_cache_invalidate_entire_instruction()
      • 22.2.13. rtems_cache_enable_data()
      • 22.2.14. rtems_cache_disable_data()
      • 22.2.15. rtems_cache_enable_instruction()
      • 22.2.16. rtems_cache_disable_instruction()
      • 22.2.17. rtems_cache_aligned_malloc()
  • 23. Fatal Error Manager
    • 23.1. Introduction
    • 23.2. Background
      • 23.2.1. Overview
      • 23.2.2. System Termination Procedure
      • 23.2.3. Fatal Sources
      • 23.2.4. Internal Error Codes
    • 23.3. Operations
      • 23.3.1. Announcing a Fatal Error
    • 23.4. Directives
      • 23.4.1. rtems_fatal()
      • 23.4.2. rtems_panic()
      • 23.4.3. rtems_shutdown_executive()
      • 23.4.4. rtems_exception_frame_print()
      • 23.4.5. rtems_fatal_source_text()
      • 23.4.6. rtems_internal_error_text()
      • 23.4.7. rtems_fatal_error_occurred()
  • 24. Board Support Packages
    • 24.1. Introduction
    • 24.2. Reset and Initialization
      • 24.2.1. Interrupt Stack Requirements
      • 24.2.2. Processors with a Separate Interrupt Stack
      • 24.2.3. Processors Without a Separate Interrupt Stack
    • 24.3. Device Drivers
      • 24.3.1. Clock Tick Device Driver
    • 24.4. User Extensions
    • 24.5. Multiprocessor Communications Interface (MPCI)
      • 24.5.1. Tightly-Coupled Systems
      • 24.5.2. Loosely-Coupled Systems
      • 24.5.3. Systems with Mixed Coupling
      • 24.5.4. Heterogeneous Systems
  • 25. User Extensions Manager
    • 25.1. Introduction
    • 25.2. Background
      • 25.2.1. Extension Sets
      • 25.2.2. TCB Extension Area
      • 25.2.3. Order of Invocation
      • 25.2.4. Thread Create Extension
      • 25.2.5. Thread Start Extension
      • 25.2.6. Thread Restart Extension
      • 25.2.7. Thread Switch Extension
      • 25.2.8. Thread Begin Extension
      • 25.2.9. Thread Exitted Extension
      • 25.2.10. Thread Termination Extension
      • 25.2.11. Thread Delete Extension
      • 25.2.12. Fatal Error Extension
    • 25.3. Directives
      • 25.3.1. rtems_extension_create()
      • 25.3.2. rtems_extension_delete()
      • 25.3.3. rtems_extension_ident()
  • 26. Configuring a System
    • 26.1. Introduction
    • 26.2. Default Value Selection Philosophy
    • 26.3. Sizing the RTEMS Workspace
    • 26.4. Potential Issues with RTEMS Workspace Size Estimation
    • 26.5. Configuration Example
    • 26.6. Unlimited Objects
      • 26.6.1. Unlimited Objects by Class
      • 26.6.2. Unlimited Objects by Default
    • 26.7. General System Configuration
      • 26.7.1. CONFIGURE_DIRTY_MEMORY
      • 26.7.2. CONFIGURE_DISABLE_BSP_SETTINGS
      • 26.7.3. CONFIGURE_DISABLE_NEWLIB_REENTRANCY
      • 26.7.4. CONFIGURE_EXECUTIVE_RAM_SIZE
      • 26.7.5. CONFIGURE_EXTRA_TASK_STACKS
      • 26.7.6. CONFIGURE_INIT
      • 26.7.7. CONFIGURE_INITIAL_EXTENSIONS
      • 26.7.8. CONFIGURE_INTERRUPT_STACK_SIZE
      • 26.7.9. CONFIGURE_MALLOC_DIRTY
      • 26.7.10. CONFIGURE_MAXIMUM_FILE_DESCRIPTORS
      • 26.7.11. CONFIGURE_MAXIMUM_PROCESSORS
      • 26.7.12. CONFIGURE_MAXIMUM_THREAD_LOCAL_STORAGE_SIZE
      • 26.7.13. CONFIGURE_MAXIMUM_THREAD_NAME_SIZE
      • 26.7.14. CONFIGURE_MEMORY_OVERHEAD
      • 26.7.15. CONFIGURE_MESSAGE_BUFFER_MEMORY
      • 26.7.16. CONFIGURE_MICROSECONDS_PER_TICK
      • 26.7.17. CONFIGURE_MINIMUM_TASK_STACK_SIZE
      • 26.7.18. CONFIGURE_STACK_CHECKER_ENABLED
      • 26.7.19. CONFIGURE_TICKS_PER_TIMESLICE
      • 26.7.20. CONFIGURE_UNIFIED_WORK_AREAS
      • 26.7.21. CONFIGURE_UNLIMITED_ALLOCATION_SIZE
      • 26.7.22. CONFIGURE_UNLIMITED_OBJECTS
      • 26.7.23. CONFIGURE_VERBOSE_SYSTEM_INITIALIZATION
      • 26.7.24. CONFIGURE_ZERO_WORKSPACE_AUTOMATICALLY
    • 26.8. Device Driver Configuration
      • 26.8.1. CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER
      • 26.8.2. CONFIGURE_APPLICATION_EXTRA_DRIVERS
      • 26.8.3. CONFIGURE_APPLICATION_NEEDS_ATA_DRIVER
      • 26.8.4. CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER
      • 26.8.5. CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER
      • 26.8.6. CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER
      • 26.8.7. CONFIGURE_APPLICATION_NEEDS_IDE_DRIVER
      • 26.8.8. CONFIGURE_APPLICATION_NEEDS_NULL_DRIVER
      • 26.8.9. CONFIGURE_APPLICATION_NEEDS_RTC_DRIVER
      • 26.8.10. CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER
      • 26.8.11. CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER
      • 26.8.12. CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER
      • 26.8.13. CONFIGURE_APPLICATION_NEEDS_TIMER_DRIVER
      • 26.8.14. CONFIGURE_APPLICATION_NEEDS_WATCHDOG_DRIVER
      • 26.8.15. CONFIGURE_APPLICATION_NEEDS_ZERO_DRIVER
      • 26.8.16. CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS
      • 26.8.17. CONFIGURE_ATA_DRIVER_TASK_PRIORITY
      • 26.8.18. CONFIGURE_EXCEPTION_TO_SIGNAL_MAPPING
      • 26.8.19. CONFIGURE_MAXIMUM_DRIVERS
    • 26.9. Classic API Configuration
      • 26.9.1. CONFIGURE_MAXIMUM_BARRIERS
      • 26.9.2. CONFIGURE_MAXIMUM_MESSAGE_QUEUES
      • 26.9.3. CONFIGURE_MAXIMUM_PARTITIONS
      • 26.9.4. CONFIGURE_MAXIMUM_PERIODS
      • 26.9.5. CONFIGURE_MAXIMUM_PORTS
      • 26.9.6. CONFIGURE_MAXIMUM_REGIONS
      • 26.9.7. CONFIGURE_MAXIMUM_SEMAPHORES
      • 26.9.8. CONFIGURE_MAXIMUM_TASKS
      • 26.9.9. CONFIGURE_MAXIMUM_TIMERS
      • 26.9.10. CONFIGURE_MAXIMUM_USER_EXTENSIONS
      • 26.9.11. CONFIGURE_MINIMUM_TASKS_WITH_USER_PROVIDED_STORAGE
    • 26.10. Classic API Initialization Task Configuration
      • 26.10.1. CONFIGURE_INIT_TASK_ARGUMENTS
      • 26.10.2. CONFIGURE_INIT_TASK_ATTRIBUTES
      • 26.10.3. CONFIGURE_INIT_TASK_CONSTRUCT_STORAGE_SIZE
      • 26.10.4. CONFIGURE_INIT_TASK_ENTRY_POINT
      • 26.10.5. CONFIGURE_INIT_TASK_INITIAL_MODES
      • 26.10.6. CONFIGURE_INIT_TASK_NAME
      • 26.10.7. CONFIGURE_INIT_TASK_PRIORITY
      • 26.10.8. CONFIGURE_INIT_TASK_STACK_SIZE
      • 26.10.9. CONFIGURE_RTEMS_INIT_TASKS_TABLE
    • 26.11. POSIX API Configuration
      • 26.11.1. CONFIGURE_MAXIMUM_POSIX_KEYS
      • 26.11.2. CONFIGURE_MAXIMUM_POSIX_KEY_VALUE_PAIRS
      • 26.11.3. CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES
      • 26.11.4. CONFIGURE_MAXIMUM_POSIX_QUEUED_SIGNALS
      • 26.11.5. CONFIGURE_MAXIMUM_POSIX_SEMAPHORES
      • 26.11.6. CONFIGURE_MAXIMUM_POSIX_SHMS
      • 26.11.7. CONFIGURE_MAXIMUM_POSIX_THREADS
      • 26.11.8. CONFIGURE_MAXIMUM_POSIX_TIMERS
      • 26.11.9. CONFIGURE_MINIMUM_POSIX_THREAD_STACK_SIZE
    • 26.12. POSIX Initialization Thread Configuration
      • 26.12.1. CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT
      • 26.12.2. CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE
      • 26.12.3. CONFIGURE_POSIX_INIT_THREAD_TABLE
    • 26.13. Event Recording Configuration
      • 26.13.1. CONFIGURE_RECORD_EXTENSIONS_ENABLED
      • 26.13.2. CONFIGURE_RECORD_FATAL_DUMP_BASE64
      • 26.13.3. CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB
      • 26.13.4. CONFIGURE_RECORD_INTERRUPTS_ENABLED
      • 26.13.5. CONFIGURE_RECORD_PER_PROCESSOR_ITEMS
    • 26.14. Filesystem Configuration
      • 26.14.1. CONFIGURE_APPLICATION_DISABLE_FILESYSTEM
      • 26.14.2. CONFIGURE_FILESYSTEM_ALL
      • 26.14.3. CONFIGURE_FILESYSTEM_DOSFS
      • 26.14.4. CONFIGURE_FILESYSTEM_FTPFS
      • 26.14.5. CONFIGURE_FILESYSTEM_IMFS
      • 26.14.6. CONFIGURE_FILESYSTEM_JFFS2
      • 26.14.7. CONFIGURE_FILESYSTEM_NFS
      • 26.14.8. CONFIGURE_FILESYSTEM_RFS
      • 26.14.9. CONFIGURE_FILESYSTEM_TFTPFS
      • 26.14.10. CONFIGURE_IMFS_DISABLE_CHMOD
      • 26.14.11. CONFIGURE_IMFS_DISABLE_CHOWN
      • 26.14.12. CONFIGURE_IMFS_DISABLE_LINK
      • 26.14.13. CONFIGURE_IMFS_DISABLE_MKNOD
      • 26.14.14. CONFIGURE_IMFS_DISABLE_MKNOD_DEVICE
      • 26.14.15. CONFIGURE_IMFS_DISABLE_MKNOD_FILE
      • 26.14.16. CONFIGURE_IMFS_DISABLE_MOUNT
      • 26.14.17. CONFIGURE_IMFS_DISABLE_READDIR
      • 26.14.18. CONFIGURE_IMFS_DISABLE_READLINK
      • 26.14.19. CONFIGURE_IMFS_DISABLE_RENAME
      • 26.14.20. CONFIGURE_IMFS_DISABLE_RMNOD
      • 26.14.21. CONFIGURE_IMFS_DISABLE_SYMLINK
      • 26.14.22. CONFIGURE_IMFS_DISABLE_UNMOUNT
      • 26.14.23. CONFIGURE_IMFS_DISABLE_UTIME
      • 26.14.24. CONFIGURE_IMFS_ENABLE_MKFIFO
      • 26.14.25. CONFIGURE_IMFS_MEMFILE_BYTES_PER_BLOCK
      • 26.14.26. CONFIGURE_JFFS2_DELAYED_WRITE_TASK_PRIORITY
      • 26.14.27. CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM
      • 26.14.28. CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM
    • 26.15. Block Device Cache Configuration
      • 26.15.1. CONFIGURE_APPLICATION_NEEDS_LIBBLOCK
      • 26.15.2. CONFIGURE_BDBUF_BUFFER_MAX_SIZE
      • 26.15.3. CONFIGURE_BDBUF_BUFFER_MIN_SIZE
      • 26.15.4. CONFIGURE_BDBUF_CACHE_MEMORY_SIZE
      • 26.15.5. CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS
      • 26.15.6. CONFIGURE_BDBUF_MAX_WRITE_BLOCKS
      • 26.15.7. CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY
      • 26.15.8. CONFIGURE_BDBUF_TASK_STACK_SIZE
      • 26.15.9. CONFIGURE_SWAPOUT_BLOCK_HOLD
      • 26.15.10. CONFIGURE_SWAPOUT_SWAP_PERIOD
      • 26.15.11. CONFIGURE_SWAPOUT_TASK_PRIORITY
      • 26.15.12. CONFIGURE_SWAPOUT_WORKER_TASKS
      • 26.15.13. CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY
    • 26.16. Task Stack Allocator Configuration
      • 26.16.1. CONFIGURE_TASK_STACK_ALLOCATOR
      • 26.16.2. CONFIGURE_TASK_STACK_ALLOCATOR_AVOIDS_WORK_SPACE
      • 26.16.3. CONFIGURE_TASK_STACK_ALLOCATOR_FOR_IDLE
      • 26.16.4. CONFIGURE_TASK_STACK_ALLOCATOR_INIT
      • 26.16.5. CONFIGURE_TASK_STACK_DEALLOCATOR
      • 26.16.6. CONFIGURE_TASK_STACK_FROM_ALLOCATOR
    • 26.17. Idle Task Configuration
      • 26.17.1. CONFIGURE_IDLE_TASK_BODY
      • 26.17.2. CONFIGURE_IDLE_TASK_INITIALIZES_APPLICATION
      • 26.17.3. CONFIGURE_IDLE_TASK_STACK_SIZE
      • 26.17.4. CONFIGURE_IDLE_TASK_STORAGE_SIZE
    • 26.18. General Scheduler Configuration
      • 26.18.1. CONFIGURE_CBS_MAXIMUM_SERVERS
      • 26.18.2. CONFIGURE_MAXIMUM_PRIORITY
      • 26.18.3. CONFIGURE_SCHEDULER_ASSIGNMENTS
      • 26.18.4. CONFIGURE_SCHEDULER_CBS
      • 26.18.5. CONFIGURE_SCHEDULER_EDF
      • 26.18.6. CONFIGURE_SCHEDULER_EDF_SMP
      • 26.18.7. CONFIGURE_SCHEDULER_NAME
      • 26.18.8. CONFIGURE_SCHEDULER_PRIORITY
      • 26.18.9. CONFIGURE_SCHEDULER_PRIORITY_AFFINITY_SMP
      • 26.18.10. CONFIGURE_SCHEDULER_PRIORITY_SMP
      • 26.18.11. CONFIGURE_SCHEDULER_SIMPLE
      • 26.18.12. CONFIGURE_SCHEDULER_SIMPLE_SMP
      • 26.18.13. CONFIGURE_SCHEDULER_STRONG_APA
      • 26.18.14. CONFIGURE_SCHEDULER_TABLE_ENTRIES
      • 26.18.15. CONFIGURE_SCHEDULER_USER
    • 26.19. Clustered Scheduler Configuration
      • 26.19.1. Configuration Step 1 - Scheduler Algorithms
      • 26.19.2. Configuration Step 2 - Schedulers
      • 26.19.3. Configuration Step 3 - Scheduler Table
      • 26.19.4. Configuration Step 4 - Processor to Scheduler Assignment
      • 26.19.5. Configuration Example
      • 26.19.6. Configuration Errors
    • 26.20. FACE Technical Standard Related Configuration
      • 26.20.1. CONFIGURE_POSIX_TIMERS_FACE_BEHAVIOR
    • 26.21. Multiprocessing Configuration
      • 26.21.1. CONFIGURE_EXTRA_MPCI_RECEIVE_SERVER_STACK
      • 26.21.2. CONFIGURE_MP_APPLICATION
      • 26.21.3. CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS
      • 26.21.4. CONFIGURE_MP_MAXIMUM_NODES
      • 26.21.5. CONFIGURE_MP_MAXIMUM_PROXIES
      • 26.21.6. CONFIGURE_MP_MPCI_TABLE_POINTER
      • 26.21.7. CONFIGURE_MP_NODE_NUMBER
    • 26.22. PCI Library Configuration
    • 26.23. Ada Configuration
    • 26.24. Directives
      • 26.24.1. rtems_get_build_label()
      • 26.24.2. rtems_get_copyright_notice()
      • 26.24.3. rtems_get_target_hash()
      • 26.24.4. rtems_get_version_string()
      • 26.24.5. rtems_configuration_get_do_zero_of_workspace()
      • 26.24.6. rtems_configuration_get_idle_task_stack_size()
      • 26.24.7. rtems_configuration_get_idle_task()
      • 26.24.8. rtems_configuration_get_interrupt_stack_size()
      • 26.24.9. rtems_configuration_get_maximum_barriers()
      • 26.24.10. rtems_configuration_get_maximum_extensions()
      • 26.24.11. rtems_configuration_get_maximum_message_queues()
      • 26.24.12. rtems_configuration_get_maximum_partitions()
      • 26.24.13. rtems_configuration_get_maximum_periods()
      • 26.24.14. rtems_configuration_get_maximum_ports()
      • 26.24.15. rtems_configuration_get_maximum_processors()
      • 26.24.16. rtems_configuration_get_maximum_regions()
      • 26.24.17. rtems_configuration_get_maximum_semaphores()
      • 26.24.18. rtems_configuration_get_maximum_tasks()
      • 26.24.19. rtems_configuration_get_maximum_timers()
      • 26.24.20. rtems_configuration_get_microseconds_per_tick()
      • 26.24.21. rtems_configuration_get_milliseconds_per_tick()
      • 26.24.22. rtems_configuration_get_nanoseconds_per_tick()
      • 26.24.23. rtems_configuration_get_number_of_initial_extensions()
      • 26.24.24. rtems_configuration_get_stack_allocate_for_idle_hook()
      • 26.24.25. rtems_configuration_get_stack_allocate_hook()
      • 26.24.26. rtems_configuration_get_stack_allocate_init_hook()
      • 26.24.27. rtems_configuration_get_stack_allocator_avoids_work_space()
      • 26.24.28. rtems_configuration_get_stack_free_hook()
      • 26.24.29. rtems_configuration_get_stack_space_size()
      • 26.24.30. rtems_configuration_get_ticks_per_timeslice()
      • 26.24.31. rtems_configuration_get_unified_work_area()
      • 26.24.32. rtems_configuration_get_user_extension_table()
      • 26.24.33. rtems_configuration_get_user_multiprocessing_table()
      • 26.24.34. rtems_configuration_get_work_space_size()
      • 26.24.35. rtems_configuration_get_rtems_api_configuration()
      • 26.24.36. rtems_resource_is_unlimited()
      • 26.24.37. rtems_resource_maximum_per_allocation()
      • 26.24.38. rtems_resource_unlimited()
    • 26.25. Obsolete Configuration Options
      • 26.25.1. CONFIGURE_BDBUF_BUFFER_COUNT
      • 26.25.2. CONFIGURE_BDBUF_BUFFER_SIZE
      • 26.25.3. CONFIGURE_DISABLE_CLASSIC_API_NOTEPADS
      • 26.25.4. CONFIGURE_ENABLE_GO
      • 26.25.5. CONFIGURE_GNAT_RTEMS
      • 26.25.6. CONFIGURE_HAS_OWN_CONFIGURATION_TABLE
      • 26.25.7. CONFIGURE_HAS_OWN_BDBUF_TABLE
      • 26.25.8. CONFIGURE_HAS_OWN_DEVICE_DRIVER_TABLE
      • 26.25.9. CONFIGURE_HAS_OWN_INIT_TASK_TABLE
      • 26.25.10. CONFIGURE_HAS_OWN_MOUNT_TABLE
      • 26.25.11. CONFIGURE_HAS_OWN_MULTIPROCESSING_TABLE
      • 26.25.12. CONFIGURE_LIBIO_MAXIMUM_FILE_DESCRIPTORS
      • 26.25.13. CONFIGURE_MAXIMUM_ADA_TASKS
      • 26.25.14. CONFIGURE_MAXIMUM_DEVICES
      • 26.25.15. CONFIGURE_MAXIMUM_FAKE_ADA_TASKS
      • 26.25.16. CONFIGURE_MAXIMUM_GO_CHANNELS
      • 26.25.17. CONFIGURE_MAXIMUM_GOROUTINES
      • 26.25.18. CONFIGURE_MAXIMUM_MRSP_SEMAPHORES
      • 26.25.19. CONFIGURE_NUMBER_OF_TERMIOS_PORTS
      • 26.25.20. CONFIGURE_MAXIMUM_POSIX_BARRIERS
      • 26.25.21. CONFIGURE_MAXIMUM_POSIX_CONDITION_VARIABLES
      • 26.25.22. CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUE_DESCRIPTORS
      • 26.25.23. CONFIGURE_MAXIMUM_POSIX_MUTEXES
      • 26.25.24. CONFIGURE_MAXIMUM_POSIX_RWLOCKS
      • 26.25.25. CONFIGURE_MAXIMUM_POSIX_SPINLOCKS
      • 26.25.26. CONFIGURE_POSIX_HAS_OWN_INIT_THREAD_TABLE
      • 26.25.27. CONFIGURE_SMP_APPLICATION
      • 26.25.28. CONFIGURE_SMP_MAXIMUM_PROCESSORS
      • 26.25.29. CONFIGURE_TERMIOS_DISABLED
  • 27. Self-Contained Objects
    • 27.1. Introduction
    • 27.2. RTEMS Thread API
    • 27.3. Mutual Exclusion
      • 27.3.1. Static mutex initialization
      • 27.3.2. Run-time mutex initialization
      • 27.3.3. Lock the mutex
      • 27.3.4. Try to lock the mutex
      • 27.3.5. Unlock the mutex
      • 27.3.6. Set mutex name
      • 27.3.7. Get mutex name
      • 27.3.8. Mutex destruction
    • 27.4. Condition Variables
      • 27.4.1. Static condition variable initialization
      • 27.4.2. Run-time condition variable initialization
      • 27.4.3. Wait for condition signal
      • 27.4.4. Signals a condition change
      • 27.4.5. Broadcasts a condition change
      • 27.4.6. Set condition variable name
      • 27.4.7. Get condition variable name
      • 27.4.8. Condition variable destruction
    • 27.5. Counting Semaphores
      • 27.5.1. Static counting semaphore initialization
      • 27.5.2. Run-time counting semaphore initialization
      • 27.5.3. Wait for a counting semaphore
      • 27.5.4. Wait for a counting semaphore with timeout in ticks
      • 27.5.5. Tries to wait for a counting semaphore
      • 27.5.6. Post a counting semaphore
      • 27.5.7. Set counting semaphore name
      • 27.5.8. Get counting semaphore name
      • 27.5.9. Counting semaphore destruction
    • 27.6. Binary Semaphores
      • 27.6.1. Static binary semaphore initialization
      • 27.6.2. Run-time binary semaphore initialization
      • 27.6.3. Wait for a binary semaphore
      • 27.6.4. Wait for a binary semaphore with timeout in ticks
      • 27.6.5. Tries to wait for a binary semaphore
      • 27.6.6. Post a binary semaphore
      • 27.6.7. Set binary semaphore name
      • 27.6.8. Get binary semaphore name
      • 27.6.9. Binary semaphore destruction
    • 27.7. Threads
  • 28. Regulator Manager
    • 28.1. Introduction
    • 28.2. Background
      • 28.2.1. Regulator Buffering
      • 28.2.2. Message Delivery Rate
    • 28.3. Operations
      • 28.3.1. Application Sourcing Data
      • 28.3.2. Delivery Function
    • 28.4. Directives
      • 28.4.1. rtems_regulator_create()
      • 28.4.2. rtems_regulator_delete()
      • 28.4.3. rtems_regulator_obtain_buffer()
      • 28.4.4. rtems_regulator_release_buffer()
      • 28.4.5. rtems_regulator_send()
      • 28.4.6. rtems_regulator_get_statistics()
  • 29. Multiprocessing Manager
    • 29.1. Introduction
    • 29.2. Background
      • 29.2.1. Nodes
      • 29.2.2. Global Objects
      • 29.2.3. Global Object Table
      • 29.2.4. Remote Operations
      • 29.2.5. Proxies
      • 29.2.6. Multiprocessor Configuration Table
    • 29.3. Multiprocessor Communications Interface Layer
      • 29.3.1. INITIALIZATION
      • 29.3.2. GET_PACKET
      • 29.3.3. RETURN_PACKET
      • 29.3.4. RECEIVE_PACKET
      • 29.3.5. SEND_PACKET
      • 29.3.6. Supporting Heterogeneous Environments
    • 29.4. Operations
      • 29.4.1. Announcing a Packet
    • 29.5. Directives
      • 29.5.1. rtems_multiprocessing_announce()
  • 30. Symmetric Multiprocessing (SMP)
    • 30.1. Introduction
    • 30.2. Background
      • 30.2.1. Application Configuration
      • 30.2.2. Examples
      • 30.2.3. Uniprocessor versus SMP Parallelism
      • 30.2.4. Task Affinity
      • 30.2.5. Task Migration
      • 30.2.6. Clustered Scheduling
      • 30.2.7. OpenMP
      • 30.2.8. Atomic Operations
    • 30.3. Application Issues
      • 30.3.1. Task variables
      • 30.3.2. Highest Priority Thread Never Walks Alone
      • 30.3.3. Disabling of Thread Preemption
      • 30.3.4. Disabling of Interrupts
      • 30.3.5. Interrupt Service Routines Execute in Parallel With Threads
      • 30.3.6. Timers Do Not Stop Immediately
      • 30.3.7. False Sharing of Cache Lines Due to Objects Table
    • 30.4. Implementation Details
      • 30.4.1. Low-Level Synchronization
      • 30.4.2. Internal Locking
      • 30.4.3. Profiling
      • 30.4.4. Scheduler Helping Protocol
      • 30.4.5. Thread Dispatch Details
      • 30.4.6. Per-Processor Data
      • 30.4.7. Thread Pinning
  • 31. PCI Library
    • 31.1. Introduction
    • 31.2. Background
      • 31.2.1. Software Components
      • 31.2.2. PCI Configuration
        • 31.2.2.1. RTEMS Configuration selection
        • 31.2.2.2. Auto Configuration
        • 31.2.2.3. Read Configuration
        • 31.2.2.4. Static Configuration
        • 31.2.2.5. Peripheral Configuration
      • 31.2.3. PCI Access
        • 31.2.3.1. Configuration space
        • 31.2.3.2. I/O space
        • 31.2.3.3. Registers over Memory space
        • 31.2.3.4. Access functions
        • 31.2.3.5. PCI address translation
      • 31.2.4. PCI Interrupt
      • 31.2.5. PCI Shell command
  • 32. Stack Bounds Checker
    • 32.1. Introduction
    • 32.2. Background
      • 32.2.1. Task Stack
      • 32.2.2. Execution
    • 32.3. Operations
      • 32.3.1. Initializing the Stack Bounds Checker
      • 32.3.2. Checking for Blown Task Stack
      • 32.3.3. Reporting Task Stack Usage
      • 32.3.4. When a Task Overflows the Stack
    • 32.4. Routines
      • 32.4.1. STACK_CHECKER_IS_BLOWN - Has Current Task Blown Its Stack
      • 32.4.2. STACK_CHECKER_REPORT_USAGE - Report Task Stack Usage
  • 33. CPU Usage Statistics
    • 33.1. Introduction
    • 33.2. Background
    • 33.3. Operations
      • 33.3.1. Report CPU Usage Statistics
      • 33.3.2. Reset CPU Usage Statistics
    • 33.4. Directives
      • 33.4.1. cpu_usage_report - Report CPU Usage Statistics
      • 33.4.2. cpu_usage_reset - Reset CPU Usage Statistics
  • 34. Object Services
    • 34.1. Introduction
    • 34.2. Background
      • 34.2.1. APIs
      • 34.2.2. Object Classes
      • 34.2.3. Object Names
    • 34.3. Operations
      • 34.3.1. Decomposing and Recomposing an Object Id
      • 34.3.2. Printing an Object Id
    • 34.4. Directives
      • 34.4.1. rtems_build_id()
      • 34.4.2. rtems_build_name()
      • 34.4.3. rtems_object_get_classic_name()
      • 34.4.4. rtems_object_get_name()
      • 34.4.5. rtems_object_set_name()
      • 34.4.6. rtems_object_id_get_api()
      • 34.4.7. rtems_object_id_get_class()
      • 34.4.8. rtems_object_id_get_node()
      • 34.4.9. rtems_object_id_get_index()
      • 34.4.10. rtems_object_id_api_minimum()
      • 34.4.11. rtems_object_id_api_maximum()
      • 34.4.12. rtems_object_api_minimum_class()
      • 34.4.13. rtems_object_api_maximum_class()
      • 34.4.14. rtems_object_get_api_name()
      • 34.4.15. rtems_object_get_api_class_name()
      • 34.4.16. rtems_object_get_class_information()
      • 34.4.17. rtems_object_get_local_node()
      • 34.4.18. RTEMS_OBJECT_ID_INITIAL()
  • 35. Chains
    • 35.1. Introduction
    • 35.2. Background
      • 35.2.1. Nodes
      • 35.2.2. Controls
    • 35.3. Operations
      • 35.3.1. Multi-threading
      • 35.3.2. Creating a Chain
      • 35.3.3. Iterating a Chain
    • 35.4. Directives
      • 35.4.1. Initialize Chain With Nodes
      • 35.4.2. Initialize Empty
      • 35.4.3. Is Null Node ?
      • 35.4.4. Head
      • 35.4.5. Tail
      • 35.4.6. Are Two Nodes Equal ?
      • 35.4.7. Is the Chain Empty
      • 35.4.8. Is this the First Node on the Chain ?
      • 35.4.9. Is this the Last Node on the Chain ?
      • 35.4.10. Does this Chain have only One Node ?
      • 35.4.11. Returns the node count of the chain (unprotected)
      • 35.4.12. Is this Node the Chain Head ?
      • 35.4.13. Is this Node the Chain Tail ?
      • 35.4.14. Extract a Node
      • 35.4.15. Extract a Node (unprotected)
      • 35.4.16. Get the First Node
      • 35.4.17. Get the First Node (unprotected)
      • 35.4.18. Insert a Node
      • 35.4.19. Insert a Node (unprotected)
      • 35.4.20. Append a Node
      • 35.4.21. Append a Node (unprotected)
      • 35.4.22. Prepend a Node
      • 35.4.23. Prepend a Node (unprotected)
  • 36. Red-Black Trees
    • 36.1. Introduction
    • 36.2. Background
      • 36.2.1. Nodes
      • 36.2.2. Controls
    • 36.3. Operations
    • 36.4. Directives
      • 36.4.1. Documentation for the Red-Black Tree Directives
  • 37. Timespec Helpers
    • 37.1. Introduction
    • 37.2. Background
      • 37.2.1. Time Storage Conventions
    • 37.3. Operations
      • 37.3.1. Set and Obtain Timespec Value
      • 37.3.2. Timespec Math
      • 37.3.3. Comparing struct timespec Instances
      • 37.3.4. Conversions and Validity Check
    • 37.4. Directives
      • 37.4.1. TIMESPEC_SET - Set struct timespec Instance
      • 37.4.2. TIMESPEC_ZERO - Zero struct timespec Instance
      • 37.4.3. TIMESPEC_IS_VALID - Check validity of a struct timespec instance
      • 37.4.4. TIMESPEC_ADD_TO - Add Two struct timespec Instances
      • 37.4.5. TIMESPEC_SUBTRACT - Subtract Two struct timespec Instances
      • 37.4.6. TIMESPEC_DIVIDE - Divide Two struct timespec Instances
      • 37.4.7. TIMESPEC_DIVIDE_BY_INTEGER - Divide a struct timespec Instance by an Integer
      • 37.4.8. TIMESPEC_LESS_THAN - Less than operator
      • 37.4.9. TIMESPEC_GREATER_THAN - Greater than operator
      • 37.4.10. TIMESPEC_EQUAL_TO - Check equality of timespecs
      • 37.4.11. TIMESPEC_GET_SECONDS - Get Seconds Portion of struct timespec Instance
      • 37.4.12. TIMESPEC_GET_NANOSECONDS - Get Nanoseconds Portion of the struct timespec Instance
      • 37.4.13. TIMESPEC_TO_TICKS - Convert struct timespec Instance to Ticks
      • 37.4.14. TIMESPEC_FROM_TICKS - Convert Ticks to struct timespec Representation
  • 38. Constant Bandwidth Server Scheduler API
    • 38.1. Introduction
    • 38.2. Background
      • 38.2.1. Constant Bandwidth Server Definitions
      • 38.2.2. Handling Periodic Tasks
      • 38.2.3. Registering a Callback Function
      • 38.2.4. Limitations
    • 38.3. Operations
      • 38.3.1. Setting up a server
      • 38.3.2. Attaching Task to a Server
      • 38.3.3. Detaching Task from a Server
      • 38.3.4. Examples
    • 38.4. Directives
      • 38.4.1. CBS_INITIALIZE - Initialize the CBS library
      • 38.4.2. CBS_CLEANUP - Cleanup the CBS library
      • 38.4.3. CBS_CREATE_SERVER - Create a new bandwidth server
      • 38.4.4. CBS_ATTACH_THREAD - Attach a thread to server
      • 38.4.5. CBS_DETACH_THREAD - Detach a thread from server
      • 38.4.6. CBS_DESTROY_SERVER - Destroy a bandwidth server
      • 38.4.7. CBS_GET_SERVER_ID - Get an ID of a server
      • 38.4.8. CBS_GET_PARAMETERS - Get scheduling parameters of a server
      • 38.4.9. CBS_SET_PARAMETERS - Set scheduling parameters
      • 38.4.10. CBS_GET_EXECUTION_TIME - Get elapsed execution time
      • 38.4.11. CBS_GET_REMAINING_BUDGET - Get remaining execution time
      • 38.4.12. CBS_GET_APPROVED_BUDGET - Get scheduler approved execution time
  • 39. Ada Support
    • 39.1. Introduction
    • 39.2. Ada Programming Language Support
    • 39.3. Classic API Ada Bindings
  • 40. Linker Sets
    • 40.1. Introduction
    • 40.2. Background
    • 40.3. Directives
      • 40.3.1. RTEMS_LINKER_SET_BEGIN - Designator of the linker set begin marker
      • 40.3.2. RTEMS_LINKER_SET_END - Designator of the linker set end marker
      • 40.3.3. RTEMS_LINKER_SET_SIZE - The linker set size in characters
      • 40.3.4. RTEMS_LINKER_SET_ITEM_COUNT - The linker set item count
      • 40.3.5. RTEMS_LINKER_SET_IS_EMPTY - Is the linker set empty?
      • 40.3.6. RTEMS_LINKER_SET_FOREACH - Iterate through the linker set items
      • 40.3.7. RTEMS_LINKER_ROSET_DECLARE - Declares a read-only linker set
      • 40.3.8. RTEMS_LINKER_ROSET - Defines a read-only linker set
      • 40.3.9. RTEMS_LINKER_ROSET_ITEM_DECLARE - Declares a read-only linker set item
      • 40.3.10. RTEMS_LINKER_ROSET_ITEM_ORDERED_DECLARE - Declares an ordered read-only linker set item
      • 40.3.11. RTEMS_LINKER_ROSET_ITEM_REFERENCE - References a read-only linker set item
      • 40.3.12. RTEMS_LINKER_ROSET_ITEM - Defines a read-only linker set item
      • 40.3.13. RTEMS_LINKER_ROSET_ITEM_ORDERED - Defines an ordered read-only linker set item
      • 40.3.14. RTEMS_LINKER_ROSET_CONTENT - Marks a declaration as a read-only linker set content
      • 40.3.15. RTEMS_LINKER_RWSET_DECLARE - Declares a read-write linker set
      • 40.3.16. RTEMS_LINKER_RWSET - Defines a read-write linker set
      • 40.3.17. RTEMS_LINKER_RWSET_ITEM_DECLARE - Declares a read-write linker set item
      • 40.3.18. RTEMS_LINKER_RWSET_ITEM_ORDERED_DECLARE - Declares an ordered read-write linker set item
      • 40.3.19. RTEMS_LINKER_RWSET_ITEM_REFERENCE - References a read-write linker set item
      • 40.3.20. RTEMS_LINKER_RWSET_ITEM - Defines a read-write linker set item
      • 40.3.21. RTEMS_LINKER_RWSET_ITEM_ORDERED - Defines an ordered read-write linker set item
      • 40.3.22. RTEMS_LINKER_RWSET_CONTENT - Marks a declaration as a read-write linker set content
  • 41. Directive Status Codes
    • 41.1. Introduction
    • 41.2. Directives
      • 41.2.1. STATUS_TEXT - Returns the enumeration name for a status code
  • 42. Example Application
  • 43. Glossary
  • 44. References
Index
RTEMS Classic API Guide
  • 25. User Extensions Manager

25. User Extensions ManagerΒΆ

  • 25.1. Introduction
  • 25.2. Background
    • 25.2.1. Extension Sets
    • 25.2.2. TCB Extension Area
    • 25.2.3. Order of Invocation
    • 25.2.4. Thread Create Extension
    • 25.2.5. Thread Start Extension
    • 25.2.6. Thread Restart Extension
    • 25.2.7. Thread Switch Extension
    • 25.2.8. Thread Begin Extension
    • 25.2.9. Thread Exitted Extension
    • 25.2.10. Thread Termination Extension
    • 25.2.11. Thread Delete Extension
    • 25.2.12. Fatal Error Extension
  • 25.3. Directives
    • 25.3.1. rtems_extension_create()
    • 25.3.2. rtems_extension_delete()
    • 25.3.3. rtems_extension_ident()
Previous Next

© Copyright 1988, 2024 RTEMS Project and contributors.

Built with Sphinx using a theme provided by Read the Docs.