Changeset 0e8f08d in rtems-docs


Ignore:
Timestamp:
Nov 6, 2017, 10:44:27 AM (18 months ago)
Author:
Sebastian Huber <sebastian.huber@…>
Branches:
master
Children:
13debfb
Parents:
0851404
git-author:
Sebastian Huber <sebastian.huber@…> (11/06/17 10:44:27)
git-committer:
Sebastian Huber <sebastian.huber@…> (02/05/18 09:43:13)
Message:

c-user: Use configuration option as section name

This makes it easier to find the documentation for a given configuration
option.

Remove superfluous comments.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • c-user/configuring_a_system.rst

    r0851404 r0e8f08d  
    5454impacting applications.
    5555
    56 .. COMMENT: === Philosophy ===
    57 
    5856Default Value Selection Philosophy
    5957==================================
     
    6462thread is configured and that at least one of the initialization task/thread
    6563tables is configured.
    66 
    67 .. COMMENT: === Sizing the RTEMS Workspace ===
    6864
    6965.. _Sizing the RTEMS Workspace:
     
    134130run-time errors terminating the system.
    135131
    136 .. COMMENT: === Potential Issues ===
    137 
    138132Potential Issues with RTEMS Workspace Size Estimation
    139133=====================================================
     
    165159for its resources.
    166160
    167 .. COMMENT: === Format to be followed for making changes in this file ===
    168 
    169161Format to be followed for making changes in this file
    170162=====================================================
     
    210202NOTES:
    211203  Any further notes. (No specific format)
    212 
    213 .. COMMENT: === Configuration Example ===
    214204
    215205Configuration Example
     
    295285  architecture.
    296286
    297 .. COMMENT: === Unlimited Objects ===
    298 
    299287.. _Unlimited Objects:
    300288
     
    384372system limits rather than experience an out of memory error at an arbitrary and
    385373largely unpredictable time in the field.
    386 
    387 .. COMMENT: === Per Object Class Unlimited Object Instances ===
    388374
    389375.. _Per Object Class Unlimited Object Instances:
     
    417403macros.
    418404
    419 .. COMMENT: === Unlimited Object Instances ===
    420 
    421405.. _Unlimited Object Instances:
    422406
     
    429413responsible for enabling unlimited objects and specifying the allocation size.
    430414
    431 .. COMMENT: === CONFIGURE_UNLIMITED_OBJECTS ===
    432 
    433415.. index:: CONFIGURE_UNLIMITED_OBJECTS
    434416
    435 .. _Enable Unlimited Object Instances:
    436 
    437 Enable Unlimited Object Instances
    438 ---------------------------------
     417.. _CONFIGURE_UNLIMITED_OBJECTS:
     418
     419CONFIGURE_UNLIMITED_OBJECTS
     420---------------------------
    439421
    440422CONSTANT:
     
    460442    of memory for both RTEMS and application memory allocations.
    461443
    462 .. COMMENT: === CONFIGURE_UNLIMITED_ALLOCATION_SIZE ===
    463 
    464 .. _Specify Unlimited Objects Allocation Size:
    465 
    466 Specify Unlimited Objects Allocation Size
    467 -----------------------------------------
     444.. _CONFIGURE_UNLIMITED_ALLOCATION_SIZE:
     445
     446CONFIGURE_UNLIMITED_ALLOCATION_SIZE
     447-----------------------------------
    468448
    469449CONSTANT:
     
    497477    #define CONFIGURE_UNLIMITED_ALLOCATION_SIZE 5
    498478
    499 .. COMMENT: === Classic API Configuration ===
    500 
    501479Classic API Configuration
    502480=========================
     
    505483supported by ``<rtems/confdefs.h>``.
    506484
    507 .. COMMENT: === CONFIGURE_MAXIMUM_TASKS ===
    508 
    509485.. index:: CONFIGURE_MAXIMUM_TASKS
    510486
    511 .. _Specify Maximum Classic API Tasks:
    512 
    513 Specify Maximum Classic API Tasks
    514 ---------------------------------
     487.. _CONFIGURE_MAXIMUM_TASKS:
     488
     489CONFIGURE_MAXIMUM_TASKS
     490-----------------------
    515491
    516492CONSTANT:
     
    551527.. COMMENT: XXX - Add xref to CONFIGURE_MAXIMUM_POSIX_THREADS.
    552528
    553 .. COMMENT: === CONFIGURE_MAXIMUM_TIMERS ===
    554 
    555529.. index:: CONFIGURE_MAXIMUM_TIMERS
    556530
    557 .. _Specify Maximum Classic API Timers:
    558 
    559 Specify Maximum Classic API Timers
    560 ----------------------------------
     531.. _CONFIGURE_MAXIMUM_TIMERS:
     532
     533CONFIGURE_MAXIMUM_TIMERS
     534------------------------
    561535
    562536CONSTANT:
     
    579553    This object class can be configured in unlimited allocation mode.
    580554
    581 .. COMMENT: === CONFIGURE_MAXIMUM_SEMAPHORES ===
    582 
    583555.. index:: CONFIGURE_MAXIMUM_SEMAPHORES
    584556
    585 .. _Specify Maximum Classic API Semaphores:
    586 
    587 Specify Maximum Classic API Semaphores
    588 --------------------------------------
     557.. _CONFIGURE_MAXIMUM_SEMAPHORES:
     558
     559CONFIGURE_MAXIMUM_SEMAPHORES
     560----------------------------
    589561
    590562CONSTANT:
     
    607579    This object class can be configured in unlimited allocation mode.
    608580
    609 .. COMMENT: === CONFIGURE_MAXIMUM_MRSP_SEMAPHORES ===
    610 
    611581.. index:: CONFIGURE_MAXIMUM_MRSP_SEMAPHORES
    612582
    613 .. _Specify Maximum Classic API Semaphores usable with MrsP:
    614 
    615 Specify Maximum Classic API Semaphores usable with MrsP
    616 -------------------------------------------------------
     583.. _CONFIGURE_MAXIMUM_MRSP_SEMAPHORES:
     584
     585CONFIGURE_MAXIMUM_MRSP_SEMAPHORES
     586---------------------------------
    617587
    618588CONSTANT:
     
    637607    semaphores and thus no extra memory is necessary.
    638608
    639 .. COMMENT: === CONFIGURE_MAXIMUM_MESSAGE_QUEUES ===
    640 
    641609.. index:: CONFIGURE_MAXIMUM_MESSAGE_QUEUES
    642610
    643 .. _Specify Maximum Classic API Message Queues:
    644 
    645 Specify Maximum Classic API Message Queues
    646 ------------------------------------------
     611.. _CONFIGURE_MAXIMUM_MESSAGE_QUEUES:
     612
     613CONFIGURE_MAXIMUM_MESSAGE_QUEUES
     614--------------------------------
    647615
    648616CONSTANT:
     
    665633    This object class can be configured in unlimited allocation mode.
    666634
    667 .. COMMENT: === CONFIGURE_MAXIMUM_BARRIERS ===
    668 
    669635.. index:: CONFIGURE_MAXIMUM_BARRIERS
    670636
    671 .. _Specify Maximum Classic API Barriers:
    672 
    673 Specify Maximum Classic API Barriers
    674 ------------------------------------
     637.. _CONFIGURE_MAXIMUM_BARRIERS:
     638
     639CONFIGURE_MAXIMUM_BARRIERS
     640--------------------------
    675641
    676642CONSTANT:
     
    693659    This object class can be configured in unlimited allocation mode.
    694660
    695 .. COMMENT: === CONFIGURE_MAXIMUM_PERIODS ===
    696 
    697661.. index:: CONFIGURE_MAXIMUM_PERIODS
    698662
    699 .. _Specify Maximum Classic API Periods:
    700 
    701 Specify Maximum Classic API Periods
    702 -----------------------------------
     663.. _CONFIGURE_MAXIMUM_PERIODS:
     664
     665CONFIGURE_MAXIMUM_PERIODS
     666-------------------------
    703667
    704668CONSTANT:
     
    721685    This object class can be configured in unlimited allocation mode.
    722686
    723 .. COMMENT: === CONFIGURE_MAXIMUM_PARTITIONS ===
    724 
    725687.. index:: CONFIGURE_MAXIMUM_PARTITIONS
    726688
    727 .. _Specify Maximum Classic API Partitions:
    728 
    729 Specify Maximum Classic API Partitions
    730 --------------------------------------
     689.. _CONFIGURE_MAXIMUM_PARTITIONS:
     690
     691CONFIGURE_MAXIMUM_PARTITIONS
     692----------------------------
    731693
    732694CONSTANT:
     
    749711    This object class can be configured in unlimited allocation mode.
    750712
    751 .. COMMENT: === CONFIGURE_MAXIMUM_REGIONS ===
    752 
    753713.. index:: CONFIGURE_MAXIMUM_REGIONS
    754714
    755 .. _Specify Maximum Classic API Regions:
    756 
    757 Specify Maximum Classic API Regions
    758 -----------------------------------
     715.. _CONFIGURE_MAXIMUM_REGIONS:
     716
     717CONFIGURE_MAXIMUM_REGIONS
     718-------------------------
    759719
    760720CONSTANT:
     
    777737    None.
    778738
    779 .. COMMENT: === CONFIGURE_MAXIMUM_PORTS ===
    780 
    781739.. index:: CONFIGURE_MAXIMUM_PORTS
    782740
    783 .. _Specify Maximum Classic API Ports:
    784 
    785 Specify Maximum Classic API Ports
    786 ---------------------------------
     741.. _CONFIGURE_MAXIMUM_PORTS:
     742
     743CONFIGURE_MAXIMUM_PORTS
     744-----------------------
    787745
    788746CONSTANT:
     
    805763    This object class can be configured in unlimited allocation mode.
    806764
    807 .. COMMENT: === CONFIGURE_MAXIMUM_USER_EXTENSIONS ===
    808 
    809765.. index:: CONFIGURE_MAXIMUM_USER_EXTENSIONS
    810766
    811 .. _Specify Maximum Classic API User Extensions:
    812 
    813 Specify Maximum Classic API User Extensions
    814 -------------------------------------------
     767.. _CONFIGURE_MAXIMUM_USER_EXTENSIONS:
     768
     769CONFIGURE_MAXIMUM_USER_EXTENSIONS
     770---------------------------------
    815771
    816772CONSTANT:
     
    832788NOTES:
    833789    This object class can be configured in unlimited allocation mode.
    834 
    835 .. COMMENT: === Classic API Initialization Task Configuration ===
    836790
    837791Classic API Initialization Tasks Table Configuration
     
    842796The following parameters control the generation of that table.
    843797
    844 .. COMMENT: === CONFIGURE_RTEMS_INIT_TASKS_TABLE ===
    845 
    846798.. index:: CONFIGURE_RTEMS_INIT_TASKS_TABLE
    847799
    848 .. _Instantiate Classic API Initialization Task Table:
    849 
    850 Instantiate Classic API Initialization Task Table
    851 -------------------------------------------------
     800.. _CONFIGURE_RTEMS_INIT_TASKS_TABLE:
     801
     802CONFIGURE_RTEMS_INIT_TASKS_TABLE
     803--------------------------------
    852804
    853805CONSTANT:
     
    880832    initialization tasks or threads.
    881833
    882 .. COMMENT: === CONFIGURE_INIT_TASK_ENTRY_POINT ===
    883 
    884834.. index:: CONFIGURE_INIT_TASK_ENTRY_POINT
    885835
    886 .. _Specifying Classic API Initialization Task Entry Point:
    887 
    888 Specifying Classic API Initialization Task Entry Point
    889 ------------------------------------------------------
     836.. _CONFIGURE_INIT_TASK_ENTRY_POINT:
     837
     838CONFIGURE_INIT_TASK_ENTRY_POINT
     839-------------------------------
    890840
    891841CONSTANT:
     
    910860    in this configuration parameter.
    911861
    912 .. COMMENT: === CONFIGURE_INIT_TASK_NAME ===
    913 
    914862.. index:: CONFIGURE_INIT_TASK_NAME
    915863
    916 .. _Specifying Classic API Initialization Task Name:
    917 
    918 Specifying Classic API Initialization Task Name
    919 -----------------------------------------------
     864.. _CONFIGURE_INIT_TASK_NAME:
     865
     866CONFIGURE_INIT_TASK_NAME
     867------------------------
    920868
    921869CONSTANT:
     
    938886    None.
    939887
    940 .. COMMENT: === CONFIGURE_INIT_TASK_STACK_SIZE ===
    941 
    942888.. index:: CONFIGURE_INIT_TASK_STACK_SIZE
    943889
    944 .. _Specifying Classic API Initialization Task Stack Size:
    945 
    946 Specifying Classic API Initialization Task Stack Size
    947 -----------------------------------------------------
     890.. _CONFIGURE_INIT_TASK_STACK_SIZE:
     891
     892CONFIGURE_INIT_TASK_STACK_SIZE
     893------------------------------
    948894
    949895CONSTANT:
     
    969915    ``CONFIGURE_EXTRA_TASK_STACKS``.
    970916
    971 .. COMMENT: === CONFIGURE_INIT_TASK_PRIORITY ===
    972 
    973917.. index:: CONFIGURE_INIT_TASK_PRIORITY
    974918
    975 .. _Specifying Classic API Initialization Task Priority:
    976 
    977 Specifying Classic API Initialization Task Priority
    978 ---------------------------------------------------
     919.. _CONFIGURE_INIT_TASK_PRIORITY:
     920
     921CONFIGURE_INIT_TASK_PRIORITY
     922----------------------------
    979923
    980924CONSTANT:
     
    997941    None.
    998942
    999 .. COMMENT: === CONFIGURE_INIT_TASK_ATTRIBUTES ===
    1000943
    1001944.. index:: CONFIGURE_INIT_TASK_ATTRIBUTES
    1002945
    1003 .. _Specifying Classic API Initialization Task Attributes:
    1004 
    1005 Specifying Classic API Initialization Task Attributes
    1006 -----------------------------------------------------
     946.. _CONFIGURE_INIT_TASK_ATTRIBUTES:
     947
     948CONFIGURE_INIT_TASK_ATTRIBUTES
     949------------------------------
    1007950
    1008951CONSTANT:
     
    1025968    None.
    1026969
    1027 .. COMMENT: === CONFIGURE_INIT_TASK_INITIAL_MODES ===
    1028 
    1029970.. index:: CONFIGURE_INIT_TASK_INITIAL_MODES
    1030971
    1031 .. _Specifying Classic API Initialization Task Modes:
    1032 
    1033 Specifying Classic API Initialization Task Modes
    1034 ------------------------------------------------
     972.. _CONFIGURE_INIT_TASK_INITIAL_MODES:
     973
     974CONFIGURE_INIT_TASK_INITIAL_MODES
     975---------------------------------
    1035976
    1036977CONSTANT:
     
    1054995    None.
    1055996
    1056 .. COMMENT: === CONFIGURE_INIT_TASK_ARGUMENTS ===
    1057 
    1058997.. index:: CONFIGURE_INIT_TASK_ARGUMENTS
    1059998
    1060 .. _Specifying Classic API Initialization Task Arguments:
    1061 
    1062 Specifying Classic API Initialization Task Arguments
    1063 ----------------------------------------------------
     999.. _CONFIGURE_INIT_TASK_ARGUMENTS:
     1000
     1001CONFIGURE_INIT_TASK_ARGUMENTS
     1002-----------------------------
    10641003
    10651004CONSTANT:
     
    10821021    None.
    10831022
    1084 .. COMMENT: === CONFIGURE_HAS_OWN_INIT_TASK_TABLE ===
    1085 
    10861023.. index:: CONFIGURE_HAS_OWN_INIT_TASK_TABLE
    10871024
    1088 .. _Not Using Generated Initialization Tasks Table:
    1089 
    1090 Not Using Generated Initialization Tasks Table
    1091 ----------------------------------------------
     1025.. _CONFIGURE_HAS_OWN_INIT_TASK_TABLE:
     1026
     1027CONFIGURE_HAS_OWN_INIT_TASK_TABLE
     1028---------------------------------
    10921029
    10931030CONSTANT:
     
    11121049    when an application desires to have more than one initialization task.
    11131050
    1114 .. COMMENT: === POSIX API Configuration ===
    1115 
    11161051POSIX API Configuration
    11171052=======================
     
    11211056time using the ``--enable-posix`` option.
    11221057
    1123 .. COMMENT: === CONFIGURE_MAXIMUM_POSIX_THREADS ===
    1124 
    11251058.. index:: CONFIGURE_MAXIMUM_POSIX_THREADS
    11261059
    1127 .. _Specify Maximum POSIX API Threads:
    1128 
    1129 Specify Maximum POSIX API Threads
    1130 ---------------------------------
     1060.. _CONFIGURE_MAXIMUM_POSIX_THREADS:
     1061
     1062CONFIGURE_MAXIMUM_POSIX_THREADS
     1063-------------------------------
    11311064
    11321065CONSTANT:
     
    11621095    All POSIX threads have floating point enabled.
    11631096
    1164 .. COMMENT: === CONFIGURE_MAXIMUM_POSIX_KEYS ===
    1165 
    11661097.. index:: CONFIGURE_MAXIMUM_POSIX_KEYS
    11671098
    1168 .. _Specify Maximum POSIX API Keys:
    1169 
    1170 Specify Maximum POSIX API Keys
    1171 ------------------------------
     1099.. _CONFIGURE_MAXIMUM_POSIX_KEYS:
     1100
     1101CONFIGURE_MAXIMUM_POSIX_KEYS
     1102----------------------------
    11721103
    11731104CONSTANT:
     
    11901121    This object class can be configured in unlimited allocation mode.
    11911122
    1192 .. COMMENT: XXX - Key pairs
    1193 
    1194 .. COMMENT: === CONFIGURE_MAXIMUM_POSIX_TIMERS ===
    1195 
    11961123.. index:: CONFIGURE_MAXIMUM_POSIX_TIMERS
    11971124
    1198 .. _Specify Maximum POSIX API Timers:
    1199 
    1200 Specify Maximum POSIX API Timers
    1201 --------------------------------
     1125.. _CONFIGURE_MAXIMUM_POSIX_TIMERS:
     1126
     1127CONFIGURE_MAXIMUM_POSIX_TIMERS
     1128------------------------------
    12021129
    12031130CONSTANT:
     
    12201147    This object class can be configured in unlimited allocation mode.
    12211148
    1222 .. COMMENT: === CONFIGURE_MAXIMUM_POSIX_QUEUED_SIGNALS ===
    1223 
    12241149.. index:: CONFIGURE_MAXIMUM_POSIX_QUEUED_SIGNALS
    12251150
    1226 .. _Specify Maximum POSIX API Queued Signals:
    1227 
    1228 Specify Maximum POSIX API Queued Signals
    1229 ----------------------------------------
     1151.. _CONFIGURE_MAXIMUM_POSIX_QUEUED_SIGNALS:
     1152
     1153CONFIGURE_MAXIMUM_POSIX_QUEUED_SIGNALS
     1154--------------------------------------
    12301155
    12311156CONSTANT:
     
    12481173    None.
    12491174
    1250 .. COMMENT: === CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES ===
    1251 
    12521175.. index:: CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES
    12531176
    1254 .. _Specify Maximum POSIX API Message Queues:
    1255 
    1256 Specify Maximum POSIX API Message Queues
    1257 ----------------------------------------
     1177.. _CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES:
     1178
     1179CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES
     1180--------------------------------------
    12581181
    12591182CONSTANT:
     
    12761199    This object class can be configured in unlimited allocation mode.
    12771200
    1278 .. COMMENT: === CONFIGURE_MAXIMUM_POSIX_SEMAPHORES ===
    1279 
    12801201.. index:: CONFIGURE_MAXIMUM_POSIX_SEMAPHORES
    12811202
    1282 .. _Specify Maximum POSIX API Semaphores:
    1283 
    1284 Specify Maximum POSIX API Named Semaphores
    1285 ------------------------------------------
     1203.. _CONFIGURE_MAXIMUM_POSIX_SEMAPHORES:
     1204
     1205CONFIGURE_MAXIMUM_POSIX_SEMAPHORES
     1206----------------------------------
    12861207
    12871208CONSTANT:
     
    13071228    None.
    13081229
    1309 .. COMMENT: === POSIX Initialization Threads Table Configuration ===
    1310 
    13111230POSIX Initialization Threads Table Configuration
    13121231================================================
     
    13161235a single entry.  The following parameters control the generation of that table.
    13171236
    1318 .. COMMENT: === CONFIGURE_POSIX_INIT_THREAD_TABLE ===
    1319 
    13201237.. index:: CONFIGURE_POSIX_INIT_THREAD_TABLE
    13211238
    1322 .. _Instantiate POSIX API Initialization Thread Table:
    1323 
    1324 Instantiate POSIX API Initialization Thread Table
    1325 -------------------------------------------------
     1239.. _CONFIGURE_POSIX_INIT_THREAD_TABLE:
     1240
     1241CONFIGURE_POSIX_INIT_THREAD_TABLE
     1242---------------------------------
    13261243
    13271244CONSTANT:
     
    13561273    initialization tasks or threads.
    13571274
    1358 .. COMMENT: === CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT ===
    1359 
    13601275.. index:: CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT
    13611276
    1362 .. _Specifying POSIX API Initialization Thread Entry Point:
    1363 
    1364 Specifying POSIX API Initialization Thread Entry Point
    1365 ------------------------------------------------------
     1277.. _CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT:
     1278
     1279CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT
     1280---------------------------------------
    13661281
    13671282CONSTANT:
     
    13861301    provided in this configuration parameter.
    13871302
    1388 .. COMMENT: === CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE ===
    1389 
    13901303.. index:: CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE
    13911304
    1392 .. _Specifying POSIX API Initialization Thread Stack Size:
    1393 
    1394 Specifying POSIX API Initialization Thread Stack Size
    1395 -----------------------------------------------------
     1305.. _CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE:
     1306
     1307CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE
     1308--------------------------------------
    13961309
    13971310CONSTANT:
     
    14181331    ``CONFIGURE_EXTRA_TASK_STACKS``.
    14191332
    1420 .. COMMENT: === CONFIGURE_POSIX_HAS_OWN_INIT_THREAD_TABLE ===
    1421 
    14221333.. index:: CONFIGURE_POSIX_HAS_OWN_INIT_THREAD_TABLE
    14231334
    1424 .. _Not Using Generated POSIX Initialization Threads Table:
    1425 
    1426 Not Using Generated POSIX Initialization Threads Table
    1427 ------------------------------------------------------
     1335.. _CONFIGURE_POSIX_HAS_OWN_INIT_THREAD_TABLE:
     1336
     1337CONFIGURE_POSIX_HAS_OWN_INIT_THREAD_TABLE
     1338-----------------------------------------
    14281339
    14291340CONSTANT:
     
    14481359    when an application desires to have more than one initialization task.
    14491360
    1450 .. COMMENT: === Basic System Information ===
    1451 
    14521361Basic System Information
    14531362========================
     
    14551364This section defines the general system configuration parameters supported by
    14561365``<rtems/confdefs.h>``.
    1457 
    1458 .. COMMENT: === CONFIGURE_UNIFIED_WORK_AREAS ===
    14591366
    14601367.. index:: CONFIGURE_UNIFIED_WORK_AREAS
     
    14641371.. index:: C Program Heap
    14651372
    1466 .. _Separate or Unified Work Areas:
    1467 
    1468 Separate or Unified Work Areas
    1469 ------------------------------
     1373.. _CONFIGURE_UNIFIED_WORK_AREAS:
     1374
     1375CONFIGURE_UNIFIED_WORK_AREAS
     1376----------------------------
    14701377
    14711378CONSTANT:
     
    15001407    RTEMS Workspace.
    15011408
    1502 .. COMMENT: === CONFIGURE_MAXIMUM_PROCESSORS ===
    1503 
    15041409.. index:: CONFIGURE_MAXIMUM_PROCESSORS
    15051410
    15061411.. _CONFIGURE_MAXIMUM_PROCESSORS:
    15071412
    1508 Specify Maximum Processors
    1509 ----------------------------------------
     1413CONFIGURE_MAXIMUM_PROCESSORS
     1414----------------------------
    15101415
    15111416CONSTANT:
     
    15341439    configurations.
    15351440
    1536 .. COMMENT: === CONFIGURE_MICROSECONDS_PER_TICK ===
    1537 
    15381441.. index:: CONFIGURE_MICROSECONDS_PER_TICK
    15391442.. index:: tick quantum
     
    15411444.. _CONFIGURE_MICROSECONDS_PER_TICK:
    15421445
    1543 Length of Each Clock Tick
    1544 -------------------------
     1446CONFIGURE_MICROSECONDS_PER_TICK
     1447-------------------------------
    15451448
    15461449CONSTANT:
     
    15821485    clock tick quantum.
    15831486
    1584 .. COMMENT: === CONFIGURE_TICKS_PER_TIMESLICE ===
    1585 
    15861487.. index:: CONFIGURE_TICKS_PER_TIMESLICE
    15871488.. index:: ticks per timeslice
    15881489
    1589 .. _Specifying Timeslicing Quantum:
    1590 
    1591 Specifying Timeslicing Quantum
    1592 ------------------------------
     1490.. _CONFIGURE_TICKS_PER_TIMESLICE:
     1491
     1492CONFIGURE_TICKS_PER_TIMESLICE
     1493-----------------------------
    15931494
    15941495CONSTANT:
     
    16111512    This configuration parameter has no impact if the Clock Tick Device driver
    16121513    is not configured.
    1613 
    1614 .. COMMENT: === CONFIGURE_MAXIMUM_PRIORITY ===
    16151514
    16161515.. index:: CONFIGURE_MAXIMUM_PRIORITY
     
    16181517.. index:: number of priority levels
    16191518
    1620 .. _Specifying the Number of Thread Priority Levels:
    1621 
    1622 Specifying the Number of Thread Priority Levels
    1623 -----------------------------------------------
     1519.. _CONFIGURE_MAXIMUM_PRIORITY:
     1520
     1521CONFIGURE_MAXIMUM_PRIORITY
     1522--------------------------
    16241523
    16251524CONSTANT:
     
    16601559   sixteen (16) can reduce memory usage by about three (3) kilobytes.
    16611560
    1662 .. COMMENT: === CONFIGURE_MAXIMUM_THREAD_NAME_SIZE ===
    1663 
    16641561.. index:: CONFIGURE_MAXIMUM_THREAD_NAME_SIZE
    16651562.. index:: maximum thread name size
     
    16671564.. _CONFIGURE_MAXIMUM_THREAD_NAME_SIZE:
    16681565
    1669 Specifying the Maximum Thread Name Size
    1670 ---------------------------------------
     1566CONFIGURE_MAXIMUM_THREAD_NAME_SIZE
     1567----------------------------------
    16711568
    16721569CONSTANT:
     
    16921589   size.  This configuration option is available since RTEMS 5.1.
    16931590
    1694 .. COMMENT: === CONFIGURE_MINIMUM_TASK_STACK_SIZE ===
    1695 
    16961591.. index:: CONFIGURE_MINIMUM_TASK_STACK_SIZE
    16971592.. index:: minimum task stack size
    16981593
    1699 .. _Specifying the Minimum Task Size:
    1700 
    1701 Specifying the Minimum Task Size
    1702 --------------------------------
     1594.. _CONFIGURE_MINIMUM_TASK_STACK_SIZE:
     1595
     1596CONFIGURE_MINIMUM_TASK_STACK_SIZE
     1597---------------------------------
    17031598
    17041599CONSTANT:
     
    17321627    of stack overflow without performing analysis on actual consumption.
    17331628
    1734 .. COMMENT: === CONFIGURE_INTERRUPT_STACK_SIZE ===
    1735 
    17361629.. index:: CONFIGURE_INTERRUPT_STACK_SIZE
    17371630.. index:: interrupt stack size
    17381631
    1739 .. _Configuring the Size of the Interrupt Stack:
    1740 
    1741 Configuring the Size of the Interrupt Stack
    1742 -------------------------------------------
     1632.. _CONFIGURE_INTERRUPT_STACK_SIZE:
     1633
     1634CONFIGURE_INTERRUPT_STACK_SIZE
     1635------------------------------
    17431636
    17441637CONSTANT:
     
    17681661    RTEMS Workspace would be welcomed by the RTEMS Project.
    17691662
    1770 .. COMMENT: === CONFIGURE_EXTRA_TASK_STACKS ===
    1771 
    17721663.. index:: CONFIGURE_EXTRA_TASK_STACKS
    17731664.. index:: memory for task tasks
    17741665
    1775 .. _Reserve Task/Thread Stack Memory Above Minimum:
    1776 
    1777 Reserve Task/Thread Stack Memory Above Minimum
    1778 ----------------------------------------------
     1666.. _CONFIGURE_EXTRA_TASK_STACKS:
     1667
     1668CONFIGURE_EXTRA_TASK_STACKS
     1669---------------------------
    17791670
    17801671CONSTANT:
     
    17991690    stacks larger then the minimum, then that memory is NOT accounted for by
    18001691    ``<rtems/confdefs.h>``.
    1801 
    1802 .. COMMENT: === CONFIGURE_ZERO_WORKSPACE_AUTOMATICALLY ===
    18031692
    18041693.. index:: CONFIGURE_ZERO_WORKSPACE_AUTOMATICALLY
     
    18081697.. index:: zero RTEMS Workspace
    18091698
    1810 .. _Automatically Zeroing the RTEMS Workspace and C Program Heap:
    1811 
    1812 Automatically Zeroing the RTEMS Workspace and C Program Heap
    1813 ------------------------------------------------------------
     1699.. _CONFIGURE_ZERO_WORKSPACE_AUTOMATICALLY:
     1700
     1701CONFIGURE_ZERO_WORKSPACE_AUTOMATICALLY
     1702--------------------------------------
    18141703
    18151704CONSTANT:
     
    18351724    necessary for RTEMS but is often assumed by support libraries.
    18361725
    1837 .. COMMENT: === CONFIGURE_STACK_CHECKER_ENABLED ===
    1838 
    18391726.. index:: CONFIGURE_STACK_CHECKER_ENABLED
    18401727
    1841 .. _Enable The Task Stack Usage Checker:
    1842 
    1843 Enable The Task Stack Usage Checker
    1844 -----------------------------------
     1728.. _CONFIGURE_STACK_CHECKER_ENABLED:
     1729
     1730CONFIGURE_STACK_CHECKER_ENABLED
     1731-------------------------------
    18451732
    18461733CONSTANT:
     
    18661753    to each context switch.
    18671754
    1868 .. COMMENT: === CONFIGURE_INITIAL_EXTENSIONS ===
    1869 
    18701755.. index:: CONFIGURE_INITIAL_EXTENSIONS
    18711756
    18721757.. _CONFIGURE_INITIAL_EXTENSIONS:
    18731758
    1874 Specify Application Specific User Extensions
    1875 --------------------------------------------
     1759CONFIGURE_INITIAL_EXTENSIONS
     1760----------------------------
    18761761
    18771762CONSTANT:
     
    18941779NOTES:
    18951780    None.
    1896 
    1897 .. COMMENT: === Custom Stack Allocator ===
    18981781
    18991782Configuring Custom Task Stack Allocation
     
    19051788overflows are detected in hardware.
    19061789
    1907 .. COMMENT: === CONFIGURE_TASK_STACK_ALLOCATOR_INIT ===
    1908 
    19091790.. index:: CONFIGURE_TASK_STACK_ALLOCATOR_INIT
    19101791
    1911 .. _Custom Task Stack Allocator Initialization:
    1912 
    1913 Custom Task Stack Allocator Initialization
    1914 ------------------------------------------
     1792.. _CONFIGURE_TASK_STACK_ALLOCATOR_INIT:
     1793
     1794CONFIGURE_TASK_STACK_ALLOCATOR_INIT
     1795-----------------------------------
    19151796
    19161797CONSTANT:
     
    19411822- ``CONFIGURE_TASK_STACK_DEALLOCATOR``
    19421823
    1943 .. COMMENT: === CONFIGURE_TASK_STACK_ALLOCATOR ===
    1944 
    19451824.. index:: CONFIGURE_TASK_STACK_ALLOCATOR
    19461825.. index:: task stack allocator
    19471826
    1948 .. _Custom Task Stack Allocator:
    1949 
    1950 Custom Task Stack Allocator
    1951 ---------------------------
     1827.. _CONFIGURE_TASK_STACK_ALLOCATOR:
     1828
     1829CONFIGURE_TASK_STACK_ALLOCATOR
     1830------------------------------
    19521831
    19531832CONSTANT:
     
    19771856- ``CONFIGURE_TASK_STACK_DEALLOCATOR``
    19781857
    1979 .. COMMENT: === CONFIGURE_TASK_STACK_DEALLOCATOR ===
    1980 
    19811858.. index:: CONFIGURE_TASK_STACK_DEALLOCATOR
    19821859.. index:: task stack deallocator
    19831860
    1984 .. _Custom Task Stack Deallocator:
    1985 
    1986 Custom Task Stack Deallocator
    1987 -----------------------------
     1861.. _CONFIGURE_TASK_STACK_DEALLOCATOR:
     1862
     1863CONFIGURE_TASK_STACK_DEALLOCATOR
     1864--------------------------------
    19881865
    19891866CONSTANT:
     
    20131890- ``CONFIGURE_TASK_STACK_DEALLOCATOR``
    20141891
    2015 .. COMMENT: === Classic API Message Buffers ===
    2016 
    20171892Configuring Memory for Classic API Message Buffers
    20181893==================================================
     
    20211896amount of memory reserved for Classic API Message Buffers.
    20221897
    2023 .. COMMENT: === CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE ===
    2024 
    20251898.. index:: CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE
    20261899.. index:: memory for a single message queue's buffers
    20271900
    2028 .. _Calculate Memory for a Single Classic Message API Message Queue:
    2029 
    2030 Calculate Memory for a Single Classic Message API Message Queue
    2031 ---------------------------------------------------------------
     1901.. _CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE:
     1902
     1903CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE
     1904-----------------------------------
    20321905
    20331906CONSTANT:
     
    20621935    This macro is only used in support of ``CONFIGURE_MESSAGE_BUFFER_MEMORY``.
    20631936
    2064 .. COMMENT: === CONFIGURE_MESSAGE_BUFFER_MEMORY ===
    2065 
    20661937.. index:: CONFIGURE_MESSAGE_BUFFER_MEMORY
    20671938.. index:: configure message queue buffer memory
    20681939
    2069 .. _Reserve Memory for All Classic Message API Message Queues:
    2070 
    2071 Reserve Memory for All Classic Message API Message Queues
    2072 ---------------------------------------------------------
     1940.. _CONFIGURE_MESSAGE_BUFFER_MEMORY:
     1941
     1942CONFIGURE_MESSAGE_BUFFER_MEMORY
     1943-------------------------------
    20731944
    20741945CONSTANT:
     
    21081979                     )
    21091980
    2110 .. COMMENT: === Seldom Used Configuration Parameters ===
    2111 
    21121981Seldom Used Configuration Parameters
    21131982====================================
     
    21181987work-arounds when the memory estimated by ``<rtems/confdefs.h>`` is incorrect.
    21191988
    2120 .. COMMENT: === CONFIGURE_MEMORY_OVERHEAD ===
    2121 
    21221989.. index:: CONFIGURE_MEMORY_OVERHEAD
    21231990
    2124 .. _Specify Memory Overhead:
    2125 
    2126 Specify Memory Overhead
    2127 -----------------------
     1991.. _CONFIGURE_MEMORY_OVERHEAD:
     1992
     1993CONFIGURE_MEMORY_OVERHEAD
     1994-------------------------
    21281995
    21291996CONSTANT:
     
    21492016    not account for all message queue buffers or task stacks.
    21502017
    2151 .. COMMENT: === CONFIGURE_HAS_OWN_CONFIGURATION_TABLE ===
    2152 
    21532018.. index:: CONFIGURE_HAS_OWN_CONFIGURATION_TABLE
    21542019
    2155 .. _Do Not Generate Configuration Information:
    2156 
    2157 Do Not Generate Configuration Information
    2158 -----------------------------------------
     2020.. _CONFIGURE_HAS_OWN_CONFIGURATION_TABLE:
     2021
     2022CONFIGURE_HAS_OWN_CONFIGURATION_TABLE
     2023-------------------------------------
    21592024
    21602025CONSTANT:
     
    21772042    None.
    21782043
    2179 .. COMMENT: === C Library Support Configuration ===
    2180 
    21812044C Library Support Configuration
    21822045===============================
     
    21852048parameters supported by ``<rtems/confdefs.h>``.
    21862049
    2187 .. COMMENT: === CONFIGURE_LIBIO_MAXIMUM_FILE_DESCRIPTORS ===
    2188 
    21892050.. index:: CONFIGURE_LIBIO_MAXIMUM_FILE_DESCRIPTORS
    21902051.. index:: maximum file descriptors
    21912052
    2192 .. _Specify Maximum Number of File Descriptors:
    2193 
    2194 Specify Maximum Number of File Descriptors
    2195 ------------------------------------------
     2053.. _CONFIGURE_LIBIO_MAXIMUM_FILE_DESCRIPTORS:
     2054
     2055CONFIGURE_LIBIO_MAXIMUM_FILE_DESCRIPTORS
     2056----------------------------------------
    21962057
    21972058CONSTANT:
     
    22172078    None.
    22182079
    2219 .. COMMENT: === File System Configuration Parameters ===
    2220 
    22212080File System Configuration Parameters
    22222081====================================
     
    22242083This section defines File System related configuration parameters.
    22252084
    2226 .. COMMENT: === CONFIGURE_HAS_OWN_MOUNT_TABLE ===
    2227 
    22282085.. index:: CONFIGURE_HAS_OWN_MOUNT_TABLE
    22292086
    2230 .. _Providing Application Specific Mount Table:
    2231 
    2232 Providing Application Specific Mount Table
    2233 ------------------------------------------
     2087.. _CONFIGURE_HAS_OWN_MOUNT_TABLE:
     2088
     2089CONFIGURE_HAS_OWN_MOUNT_TABLE
     2090-----------------------------
    22342091
    22352092CONSTANT:
     
    22592116.. COMMENT: XXX - Please provide an example
    22602117
    2261 .. COMMENT: === CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM ===
    2262 
    22632118.. index:: CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM
    22642119
    2265 .. _Configure devFS as Root File System:
    2266 
    2267 Configure devFS as Root File System
    2268 -----------------------------------
     2120.. _CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM:
     2121
     2122CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM
     2123--------------------------------------
    22692124
    22702125CONSTANT:
     
    22922147    space provided before RTEMS release 4.5.0.
    22932148
    2294 .. COMMENT: === CONFIGURE_MAXIMUM_DEVICES ===
    2295 
    22962149.. index:: CONFIGURE_MAXIMUM_DEVICES
    22972150
    2298 .. _Specifying Maximum Devices for devFS:
    2299 
    2300 Specifying Maximum Devices for devFS
    2301 ------------------------------------
     2151.. _CONFIGURE_MAXIMUM_DEVICES:
     2152
     2153CONFIGURE_MAXIMUM_DEVICES
     2154-------------------------
    23022155
    23032156CONSTANT:
     
    23242177    ``CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM`` is specified.
    23252178
    2326 .. COMMENT: === CONFIGURE_APPLICATION_DISABLE_FILESYSTEM ===
    2327 
    23282179.. index:: CONFIGURE_APPLICATION_DISABLE_FILESYSTEM
    23292180
    2330 .. _Disable File System Support:
    2331 
    2332 Disable File System Support
    2333 ---------------------------
     2181.. _CONFIGURE_APPLICATION_DISABLE_FILESYSTEM:
     2182
     2183CONFIGURE_APPLICATION_DISABLE_FILESYSTEM
     2184----------------------------------------
    23342185
    23352186CONSTANT:
     
    23542205    None.
    23552206
    2356 .. COMMENT: === CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM ===
    2357 
    23582207.. index:: CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM
    23592208
    2360 .. _Use a Root IMFS with a Minimalistic Feature Set:
    2361 
    2362 Use a Root IMFS with a Minimalistic Feature Set
    2363 -----------------------------------------------
     2209.. _CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM:
     2210
     2211CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM
     2212-----------------------------------------
    23642213
    23652214CONSTANT:
     
    23952244    - ``CONFIGURE_IMFS_DISABLE_UNMOUNT``.
    23962245
    2397 .. COMMENT: === CONFIGURE_IMFS_MEMFILE_BYTES_PER_BLOCK ===
    2398 
    23992246.. index:: CONFIGURE_IMFS_MEMFILE_BYTES_PER_BLOCK
    24002247
    2401 .. _Specify Block Size for IMFS:
    2402 
    2403 Specify Block Size for IMFS
    2404 ---------------------------
     2248.. _CONFIGURE_IMFS_MEMFILE_BYTES_PER_BLOCK:
     2249
     2250CONFIGURE_IMFS_MEMFILE_BYTES_PER_BLOCK
     2251--------------------------------------
    24052252
    24062253CONSTANT:
     
    24462293      bytes.
    24472294
    2448 .. COMMENT: === CONFIGURE_IMFS_DISABLE_CHOWN ===
    2449 
    24502295.. index:: CONFIGURE_IMFS_DISABLE_CHOWN
    24512296
    2452 .. _Disable Change Owner Support of Root IMFS:
    2453 
    2454 Disable Change Owner Support of Root IMFS
    2455 -----------------------------------------
     2297.. _CONFIGURE_IMFS_DISABLE_CHOWN:
     2298
     2299CONFIGURE_IMFS_DISABLE_CHOWN
     2300----------------------------
    24562301
    24572302CONSTANT:
     
    24712316    the owner is disabled in the root IMFS.
    24722317
    2473 .. COMMENT: === CONFIGURE_IMFS_DISABLE_CHMOD ===
    2474 
    24752318.. index:: CONFIGURE_IMFS_DISABLE_CHMOD
    24762319
    2477 .. _Disable Change Mode Support of Root IMFS:
    2478 
    2479 Disable Change Mode Support of Root IMFS
    2480 ----------------------------------------
     2320.. _CONFIGURE_IMFS_DISABLE_CHMOD:
     2321
     2322CONFIGURE_IMFS_DISABLE_CHMOD
     2323----------------------------
    24812324
    24822325CONSTANT:
     
    24962339    the mode is disabled in the root IMFS.
    24972340
    2498 .. COMMENT: === CONFIGURE_IMFS_DISABLE_UTIME ===
    2499 
    25002341.. index:: CONFIGURE_IMFS_DISABLE_UTIME
    25012342
    2502 .. _Disable Change Times Support of Root IMFS:
    2503 
    2504 Disable Change Times Support of Root IMFS
    2505 -----------------------------------------
     2343.. _CONFIGURE_IMFS_DISABLE_UTIME:
     2344
     2345CONFIGURE_IMFS_DISABLE_UTIME
     2346----------------------------
    25062347
    25072348CONSTANT:
     
    25212362    times is disabled in the root IMFS.
    25222363
    2523 .. COMMENT: === CONFIGURE_IMFS_DISABLE_LINK ===
    2524 
    25252364.. index:: CONFIGURE_IMFS_DISABLE_LINK
    25262365
    2527 .. _Disable Create Hard Link Support of Root IMFS:
    2528 
    2529 Disable Create Hard Link Support of Root IMFS
    2530 ---------------------------------------------
     2366.. _CONFIGURE_IMFS_DISABLE_LINK:
     2367
     2368CONFIGURE_IMFS_DISABLE_LINK
     2369---------------------------
    25312370
    25322371CONSTANT:
     
    25462385    hard links is disabled in the root IMFS.
    25472386
    2548 .. COMMENT: === CONFIGURE_IMFS_DISABLE_SYMLINK ===
    2549 
    25502387.. index:: CONFIGURE_IMFS_DISABLE_SYMLINK
    25512388
    2552 .. _Disable Create Symbolic Link Support of Root IMFS:
    2553 
    2554 Disable Create Symbolic Link Support of Root IMFS
    2555 -------------------------------------------------
     2389.. _CONFIGURE_IMFS_DISABLE_SYMLINK:
     2390
     2391CONFIGURE_IMFS_DISABLE_SYMLINK
     2392------------------------------
    25562393
    25572394CONSTANT:
     
    25712408    symbolic links is disabled in the root IMFS.
    25722409
    2573 .. COMMENT: === CONFIGURE_IMFS_DISABLE_READLINK ===
    2574 
    25752410.. index:: CONFIGURE_IMFS_DISABLE_READLINK
    25762411
    2577 .. _Disable Read Symbolic Link Support of Root IMFS:
    2578 
    2579 Disable Read Symbolic Link Support of Root IMFS
    2580 -----------------------------------------------
     2412.. _CONFIGURE_IMFS_DISABLE_READLINK:
     2413
     2414CONFIGURE_IMFS_DISABLE_READLINK
     2415-------------------------------
    25812416
    25822417CONSTANT:
     
    25962431    symbolic links is disabled in the root IMFS.
    25972432
    2598 .. COMMENT: === CONFIGURE_IMFS_DISABLE_RENAME ===
    2599 
    26002433.. index:: CONFIGURE_IMFS_DISABLE_RENAME
    26012434
    2602 .. _Disable Rename Support of Root IMFS:
    2603 
    2604 Disable Rename Support of Root IMFS
    2605 -----------------------------------
     2435.. _CONFIGURE_IMFS_DISABLE_RENAME:
     2436
     2437CONFIGURE_IMFS_DISABLE_RENAME
     2438-----------------------------
    26062439
    26072440CONSTANT:
     
    26212454    nodes is disabled in the root IMFS.
    26222455
    2623 .. COMMENT: === CONFIGURE_IMFS_DISABLE_READDIR ===
    2624 
    26252456.. index:: CONFIGURE_IMFS_DISABLE_READDIR
    26262457
    2627 .. _Disable Directory Read Support of Root IMFS:
    2628 
    2629 Disable Directory Read Support of Root IMFS
    2630 -------------------------------------------
     2458.. _CONFIGURE_IMFS_DISABLE_READDIR:
     2459
     2460CONFIGURE_IMFS_DISABLE_READDIR
     2461------------------------------
    26312462
    26322463CONSTANT:
     
    26472478    in a directory.
    26482479
    2649 .. COMMENT: === CONFIGURE_IMFS_DISABLE_MOUNT ===
    2650 
    26512480.. index:: CONFIGURE_IMFS_DISABLE_MOUNT
    26522481
    2653 .. _Disable Mount Support of Root IMFS:
    2654 
    2655 Disable Mount Support of Root IMFS
    2656 ----------------------------------
     2482.. _CONFIGURE_IMFS_DISABLE_MOUNT:
     2483
     2484CONFIGURE_IMFS_DISABLE_MOUNT
     2485----------------------------
    26572486
    26582487CONSTANT:
     
    26722501    other file systems is disabled in the root IMFS.
    26732502
    2674 .. COMMENT: === CONFIGURE_IMFS_DISABLE_UNMOUNT ===
    2675 
    26762503.. index:: CONFIGURE_IMFS_DISABLE_UNMOUNT
    26772504
    2678 .. _Disable Unmount Support of Root IMFS:
    2679 
    2680 Disable Unmount Support of Root IMFS
    2681 ------------------------------------
     2505.. _CONFIGURE_IMFS_DISABLE_UNMOUNT:
     2506
     2507CONFIGURE_IMFS_DISABLE_UNMOUNT
     2508------------------------------
    26822509
    26832510CONSTANT:
     
    26972524    file systems is disabled in the root IMFS.
    26982525
    2699 .. COMMENT: === CONFIGURE_IMFS_DISABLE_MKNOD ===
    2700 
    27012526.. index:: CONFIGURE_IMFS_DISABLE_MKNOD
    27022527
    2703 .. _Disable Make Nodes Support of Root IMFS:
    2704 
    2705 Disable Make Nodes Support of Root IMFS
    2706 ---------------------------------------
     2528.. _CONFIGURE_IMFS_DISABLE_MKNOD:
     2529
     2530CONFIGURE_IMFS_DISABLE_MKNOD
     2531----------------------------
    27072532
    27082533CONSTANT:
     
    27222547    directories, devices, regular files and FIFOs is disabled in the root IMFS.
    27232548
    2724 .. COMMENT: === CONFIGURE_IMFS_DISABLE_MKNOD_FILE ===
    2725 
    27262549.. index:: CONFIGURE_IMFS_DISABLE_MKNOD_FILE
    27272550
    2728 .. _Disable Make Files Support of Root IMFS:
    2729 
    2730 Disable Make Files Support of Root IMFS
    2731 ---------------------------------------
     2551.. _CONFIGURE_IMFS_DISABLE_MKNOD_FILE:
     2552
     2553CONFIGURE_IMFS_DISABLE_MKNOD_FILE
     2554---------------------------------
    27322555
    27332556CONSTANT:
     
    27472570    regular files is disabled in the root IMFS.
    27482571
    2749 .. COMMENT: === CONFIGURE_IMFS_DISABLE_RMNOD ===
    2750 
    27512572.. index:: CONFIGURE_IMFS_DISABLE_RMNOD
    27522573
    2753 .. _Disable Remove Nodes Support of Root IMFS:
    2754 
    2755 Disable Remove Nodes Support of Root IMFS
    2756 -----------------------------------------
     2574.. _CONFIGURE_IMFS_DISABLE_RMNOD:
     2575
     2576CONFIGURE_IMFS_DISABLE_RMNOD
     2577----------------------------
    27572578
    27582579CONSTANT:
     
    27722593    nodes is disabled in the root IMFS.
    27732594
    2774 .. COMMENT: === Block Device Cache Configuration ===
    2775 
    27762595Block Device Cache Configuration
    27772596================================
     
    27802599parameters.
    27812600
    2782 .. COMMENT: === CONFIGURE_APPLICATION_NEEDS_LIBBLOCK ===
    2783 
    27842601.. index:: CONFIGURE_APPLICATION_NEEDS_LIBBLOCK
    27852602
    2786 .. _Enable Block Device Cache:
    2787 
    2788 Enable Block Device Cache
    2789 -------------------------
     2603.. _CONFIGURE_APPLICATION_NEEDS_LIBBLOCK:
     2604
     2605CONFIGURE_APPLICATION_NEEDS_LIBBLOCK
     2606------------------------------------
    27902607
    27912608CONSTANT:
     
    28092626    is used for example by the RFS and DOSFS file systems.
    28102627
    2811 .. COMMENT: === CONFIGURE_BDBUF_CACHE_MEMORY_SIZE ===
    2812 
    28132628.. index:: CONFIGURE_BDBUF_CACHE_MEMORY_SIZE
    28142629
    2815 .. _Size of the Cache Memory:
    2816 
    2817 Size of the Cache Memory
    2818 ------------------------
     2630.. _CONFIGURE_BDBUF_CACHE_MEMORY_SIZE:
     2631
     2632CONFIGURE_BDBUF_CACHE_MEMORY_SIZE
     2633---------------------------------
    28192634
    28202635CONSTANT:
     
    28362651    None.
    28372652
    2838 .. COMMENT: === CONFIGURE_BDBUF_BUFFER_MIN_SIZE ===
    2839 
    28402653.. index:: CONFIGURE_BDBUF_BUFFER_MIN_SIZE
    28412654
    2842 .. _Minimum Size of a Buffer:
    2843 
    2844 Minimum Size of a Buffer
    2845 ------------------------
     2655.. _CONFIGURE_BDBUF_BUFFER_MIN_SIZE:
     2656
     2657CONFIGURE_BDBUF_BUFFER_MIN_SIZE
     2658-------------------------------
    28462659
    28472660CONSTANT:
     
    28632676    None.
    28642677
    2865 .. COMMENT: === CONFIGURE_BDBUF_BUFFER_MAX_SIZE ===
    2866 
    28672678.. index:: CONFIGURE_BDBUF_BUFFER_MAX_SIZE
    28682679
    2869 .. _Maximum Size of a Buffer:
    2870 
    2871 Maximum Size of a Buffer
    2872 ------------------------
     2680.. _CONFIGURE_BDBUF_BUFFER_MAX_SIZE:
     2681
     2682CONFIGURE_BDBUF_BUFFER_MAX_SIZE
     2683-------------------------------
    28732684
    28742685CONSTANT:
     
    28902701    None.
    28912702
    2892 .. COMMENT: === CONFIGURE_SWAPOUT_SWAP_PERIOD ===
    2893 
    28942703.. index:: CONFIGURE_SWAPOUT_SWAP_PERIOD
    28952704
    2896 .. _Swapout Task Swap Period:
    2897 
    2898 Swapout Task Swap Period
    2899 ------------------------
     2705.. _CONFIGURE_SWAPOUT_SWAP_PERIOD:
     2706
     2707CONFIGURE_SWAPOUT_SWAP_PERIOD
     2708-----------------------------
    29002709
    29012710CONSTANT:
     
    29172726    None.
    29182727
    2919 .. COMMENT: === CONFIGURE_SWAPOUT_BLOCK_HOLD ===
    2920 
    29212728.. index:: CONFIGURE_SWAPOUT_BLOCK_HOLD
    29222729
    2923 .. _Swapout Task Maximum Block Hold Time:
    2924 
    2925 Swapout Task Maximum Block Hold Time
    2926 ------------------------------------
     2730.. _CONFIGURE_SWAPOUT_BLOCK_HOLD:
     2731
     2732CONFIGURE_SWAPOUT_BLOCK_HOLD
     2733----------------------------
    29272734
    29282735CONSTANT:
     
    29442751    None.
    29452752
    2946 .. COMMENT: === CONFIGURE_SWAPOUT_TASK_PRIORITY ===
    2947 
    29482753.. index:: CONFIGURE_SWAPOUT_TASK_PRIORITY
    29492754
    2950 .. _Swapout Task Priority:
    2951 
    2952 Swapout Task Priority
    2953 ---------------------
     2755.. _CONFIGURE_SWAPOUT_TASK_PRIORITY:
     2756
     2757CONFIGURE_SWAPOUT_TASK_PRIORITY
     2758-------------------------------
    29542759
    29552760CONSTANT:
     
    29712776    None.
    29722777
    2973 .. COMMENT: === CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS ===
    2974 
    29752778.. index:: CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS
    29762779
    2977 .. _Maximum Blocks per Read-Ahead Request:
    2978 
    2979 Maximum Blocks per Read-Ahead Request
     2780.. _CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS:
     2781
     2782CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS
    29802783-------------------------------------
    29812784
     
    30002803    detected.  This can improve the performance on some systems.
    30012804
    3002 .. COMMENT: === CONFIGURE_BDBUF_MAX_WRITE_BLOCKS ===
    3003 
    30042805.. index:: CONFIGURE_BDBUF_MAX_WRITE_BLOCKS
    30052806
    3006 .. _Maximum Blocks per Write Request:
    3007 
    3008 Maximum Blocks per Write Request
     2807.. _CONFIGURE_BDBUF_MAX_WRITE_BLOCKS:
     2808
     2809CONFIGURE_BDBUF_MAX_WRITE_BLOCKS
    30092810--------------------------------
    30102811
     
    30272828    None.
    30282829
    3029 .. COMMENT: === CONFIGURE_BDBUF_TASK_STACK_SIZE ===
    3030 
    30312830.. index:: CONFIGURE_BDBUF_TASK_STACK_SIZE
    30322831
    3033 .. _Task Stack Size of the Block Device Cache Tasks:
    3034 
    3035 Task Stack Size of the Block Device Cache Tasks
    3036 -----------------------------------------------
     2832.. _CONFIGURE_BDBUF_TASK_STACK_SIZE:
     2833
     2834CONFIGURE_BDBUF_TASK_STACK_SIZE
     2835-------------------------------
    30372836
    30382837CONSTANT:
     
    30542853    None.
    30552854
    3056 .. COMMENT: === CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY ===
    3057 
    30582855.. index:: CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY
    30592856
    3060 .. _Read-Ahead Task Priority:
    3061 
    3062 Read-Ahead Task Priority
    3063 ------------------------
     2857.. _CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY:
     2858
     2859CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY
     2860----------------------------------------
    30642861
    30652862CONSTANT:
     
    30812878    None.
    30822879
    3083 .. COMMENT: === CONFIGURE_SWAPOUT_WORKER_TASKS ===
    3084 
    30852880.. index:: CONFIGURE_SWAPOUT_WORKER_TASKS
    30862881
    3087 .. _Swapout Worker Task Count:
    3088 
    3089 Swapout Worker Task Count
    3090 -------------------------
     2882.. _CONFIGURE_SWAPOUT_WORKER_TASKS:
     2883
     2884CONFIGURE_SWAPOUT_WORKER_TASKS
     2885------------------------------
    30912886
    30922887CONSTANT:
     
    31082903    None.
    31092904
    3110 .. COMMENT: === CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY ===
    3111 
    31122905.. index:: CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY
    31132906
    3114 .. _Swapout Worker Task Priority:
    3115 
    3116 Swapout Worker Task Priority
    3117 ----------------------------
     2907.. _CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY:
     2908
     2909CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY
     2910--------------------------------------
    31182911
    31192912CONSTANT:
     
    31342927NOTES:
    31352928    None.
    3136 
    3137 .. COMMENT: === BSP Specific Settings ===
    31382929
    31392930BSP Specific Settings
     
    31442935``<bsp.h>``.
    31452936
    3146 .. COMMENT: === Disable BSP Settings ===
    3147 
    31482937.. index:: CONFIGURE_DISABLE_BSP_SETTINGS
    31492938
    3150 .. _Disable BSP Configuration Settings:
    3151 
    3152 Disable BSP Configuration Settings
    3153 ----------------------------------
     2939.. _CONFIGURE_DISABLE_BSP_SETTINGS:
     2940
     2941CONFIGURE_DISABLE_BSP_SETTINGS
     2942------------------------------
    31542943
    31552944CONSTANT:
     
    31722961    None.
    31732962
    3174 .. COMMENT: === CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK ===
    3175 
    31762963.. index:: CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK
    31772964
    3178 .. _Specify BSP Supports sbrk():
    3179 
    3180 Specify BSP Supports sbrk()
    3181 ---------------------------
     2965.. _CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK:
     2966
     2967CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK
     2968----------------------------------
    31822969
    31832970CONSTANT:
     
    32052992    how it allocates memory to the C Program Heap.
    32062993
    3207 .. COMMENT: === BSP_IDLE_TASK_BODY ===
    3208 
    32092994.. index:: BSP_IDLE_TASK_BODY
    32102995
    3211 .. _Specify BSP Specific Idle Task:
    3212 
    3213 Specify BSP Specific Idle Task
    3214 ------------------------------
     2996.. _BSP_IDLE_TASK_BODY:
     2997
     2998BSP_IDLE_TASK_BODY
     2999------------------
    32153000
    32163001CONSTANT:
     
    32363021    components off to save power during extended periods of no task activity
    32373022
    3238 .. COMMENT: === BSP_IDLE_TASK_STACK_SIZE ===
    3239 
    32403023.. index:: BSP_IDLE_TASK_STACK_SIZE
    32413024
    3242 .. _Specify BSP Suggested Value for IDLE Task Stack Size:
    3243 
    3244 Specify BSP Suggested Value for IDLE Task Stack Size
    3245 ----------------------------------------------------
     3025.. _BSP_IDLE_TASK_STACK_SIZE:
     3026
     3027BSP_IDLE_TASK_STACK_SIZE
     3028------------------------
    32463029
    32473030CONSTANT:
     
    32753058.. COMMENT: XXX - add cross references to other related values.
    32763059
    3277 .. COMMENT: === BSP_INITIAL_EXTENSION ===
    3278 
    32793060.. index:: BSP_INITIAL_EXTENSION
    32803061
    3281 .. _Specify BSP Specific User Extensions:
    3282 
    3283 Specify BSP Specific User Extensions
    3284 ------------------------------------
     3062.. _BSP_INITIAL_EXTENSION:
     3063
     3064BSP_INITIAL_EXTENSION
     3065---------------------
    32853066
    32863067CONSTANT:
     
    33043085    None.
    33053086
    3306 .. COMMENT: === BSP_INTERRUPT_STACK_SIZE ===
    3307 
    33083087.. index:: BSP_INTERRUPT_STACK_SIZE
    33093088
    3310 .. _Specifying BSP Specific Interrupt Stack Size:
    3311 
    3312 Specifying BSP Specific Interrupt Stack Size
    3313 --------------------------------------------
     3089.. _BSP_INTERRUPT_STACK_SIZE:
     3090
     3091BSP_INTERRUPT_STACK_SIZE
     3092------------------------
    33143093
    33153094CONSTANT:
     
    33333112    None.
    33343113
    3335 .. COMMENT: === BSP_MAXIMUM_DEVICES ===
    3336 
    33373114.. index:: BSP_MAXIMUM_DEVICES
    33383115
    3339 .. _Specifying BSP Specific Maximum Devices:
    3340 
    3341 Specifying BSP Specific Maximum Devices
    3342 ---------------------------------------
     3116.. _BSP_MAXIMUM_DEVICES:
     3117
     3118BSP_MAXIMUM_DEVICES
     3119-------------------
    33433120
    33443121CONSTANT:
     
    33653142    ``CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM`` is specified.
    33663143
    3367 .. COMMENT: === BSP_ZERO_WORKSPACE_AUTOMATICALLY ===
    3368 
    33693144.. index:: BSP_ZERO_WORKSPACE_AUTOMATICALLY
    33703145
    3371 .. _BSP Recommends RTEMS Workspace be Cleared:
    3372 
    3373 BSP Recommends RTEMS Workspace be Cleared
    3374 -----------------------------------------
     3146.. _BSP_ZERO_WORKSPACE_AUTOMATICALLY:
     3147
     3148BSP_ZERO_WORKSPACE_AUTOMATICALLY
     3149--------------------------------
    33753150
    33763151CONSTANT:
     
    33953170    necessary for RTEMS but is often assumed by support libraries.
    33963171
    3397 .. COMMENT: === CONFIGURE_BSP_PREREQUISITE_DRIVERS ===
    3398 
    33993172.. index:: CONFIGURE_BSP_PREREQUISITE_DRIVERS
    34003173
    3401 .. _Specify BSP Prerequisite Drivers:
    3402 
    3403 Specify BSP Prerequisite Drivers
    3404 --------------------------------
     3174.. _CONFIGURE_BSP_PREREQUISITE_DRIVERS:
     3175
     3176CONFIGURE_BSP_PREREQUISITE_DRIVERS
     3177----------------------------------
    34053178
    34063179CONSTANT:
     
    34283201    devices.
    34293202
    3430 .. COMMENT: === Idle Task Configuration ===
    3431 
    34323203Idle Task Configuration
    34333204=======================
     
    34363207by ``<rtems/confdefs.h>``.
    34373208
    3438 .. COMMENT: === CONFIGURE_IDLE_TASK_BODY ===
    3439 
    34403209.. index:: CONFIGURE_IDLE_TASK_BODY
    34413210
    3442 .. _Specify Application Specific Idle Task Body:
    3443 
    3444 Specify Application Specific Idle Task Body
    3445 -------------------------------------------
     3211.. _CONFIGURE_IDLE_TASK_BODY:
     3212
     3213CONFIGURE_IDLE_TASK_BODY
     3214------------------------
    34463215
    34473216CONSTANT:
     
    34653234    None.
    34663235
    3467 .. COMMENT: === CONFIGURE_IDLE_TASK_STACK_SIZE ===
    3468 
    34693236.. index:: CONFIGURE_IDLE_TASK_STACK_SIZE
    34703237
    3471 .. _Specify Idle Task Stack Size:
    3472 
    3473 Specify Idle Task Stack Size
    3474 ----------------------------
     3238.. _CONFIGURE_IDLE_TASK_STACK_SIZE:
     3239
     3240CONFIGURE_IDLE_TASK_STACK_SIZE
     3241------------------------------
    34753242
    34763243CONSTANT:
     
    34933260    None.
    34943261
    3495 .. COMMENT: === CONFIGURE_IDLE_TASK_INITIALIZES_APPLICATION ===
    3496 
    34973262.. index:: CONFIGURE_IDLE_TASK_INITIALIZES_APPLICATION
    34983263
    3499 .. _Specify Idle Task Performs Application Initialization:
    3500 
    3501 Specify Idle Task Performs Application Initialization
    3502 -----------------------------------------------------
     3264.. _CONFIGURE_IDLE_TASK_INITIALIZES_APPLICATION:
     3265
     3266CONFIGURE_IDLE_TASK_INITIALIZES_APPLICATION
     3267-------------------------------------------
    35033268
    35043269CONSTANT:
     
    35283293
    35293294    The IDLE task must run at the lowest priority of all tasks in the system.
    3530 
    3531 .. COMMENT: === Scheduler Algorithm Configuration ===
    35323295
    35333296Scheduler Algorithm Configuration
     
    35443307configuration macros.
    35453308
    3546 .. COMMENT: === CONFIGURE_SCHEDULER_PRIORITY ===
    3547 
    35483309.. index:: CONFIGURE_SCHEDULER_PRIORITY
    35493310
    3550 .. _Use Deterministic Priority Scheduler:
    3551 
    3552 Use Deterministic Priority Scheduler
    3553 ------------------------------------
     3311.. _CONFIGURE_SCHEDULER_PRIORITY:
     3312
     3313CONFIGURE_SCHEDULER_PRIORITY
     3314----------------------------
    35543315
    35553316CONSTANT:
     
    35783339    behavior.
    35793340
    3580 .. COMMENT: === CONFIGURE_SCHEDULER_SIMPLE ===
    3581 
    35823341.. index:: CONFIGURE_SCHEDULER_SIMPLE
    35833342
    3584 .. _Use Simple Priority Scheduler:
    3585 
    3586 Use Simple Priority Scheduler
    3587 -----------------------------
     3343.. _CONFIGURE_SCHEDULER_SIMPLE:
     3344
     3345CONFIGURE_SCHEDULER_SIMPLE
     3346--------------------------
    35883347
    35893348CONSTANT:
     
    36143373    This scheduler is appropriate for use in small systems where RAM is limited.
    36153374
    3616 .. COMMENT: === CONFIGURE_SCHEDULER_EDF ===
    3617 
    36183375.. index:: CONFIGURE_SCHEDULER_EDF
    36193376
    3620 .. _Use Earliest Deadline First Scheduler:
    3621 
    3622 Use Earliest Deadline First Scheduler
    3623 -------------------------------------
     3377.. _CONFIGURE_SCHEDULER_EDF:
     3378
     3379CONFIGURE_SCHEDULER_EDF
     3380-----------------------
    36243381
    36253382CONSTANT:
     
    36523409    None.
    36533410
    3654 .. COMMENT: === CONFIGURE_SCHEDULER_EDF_SMP ===
    3655 
    36563411.. index:: CONFIGURE_SCHEDULER_EDF_SMP
    36573412
    3658 .. _Use Earliest Deadline First SMP Scheduler:
    3659 
    3660 Use Earliest Deadline First Scheduler
    3661 -------------------------------------
     3413.. _CONFIGURE_SCHEDULER_EDF_SMP:
     3414
     3415CONFIGURE_SCHEDULER_EDF_SMP
     3416---------------------------
    36623417
    36633418CONSTANT:
     
    36803435    None.
    36813436
    3682 .. COMMENT: === CONFIGURE_SCHEDULER_CBS ===
    3683 
    36843437.. index:: CONFIGURE_SCHEDULER_CBS
    36853438
    3686 .. _Use Constant Bandwidth Server Scheduler:
    3687 
    3688 Use Constant Bandwidth Server Scheduler
    3689 ---------------------------------------
     3439.. _CONFIGURE_SCHEDULER_CBS:
     3440
     3441CONFIGURE_SCHEDULER_CBS
     3442-----------------------
    36903443
    36913444CONSTANT:
     
    37113464    ``CONFIGURE_SCHEDULER_CBS``.
    37123465
    3713 .. COMMENT: XXX - add cross reference to API chapter
    3714 
    37153466NOTES:
    37163467    None.
    37173468
    3718 .. COMMENT: === CONFIGURE_SCHEDULER_PRIORITY_SMP ===
    3719 
    37203469.. index:: CONFIGURE_SCHEDULER_PRIORITY_SMP
    37213470
    3722 .. _Use Deterministic Priority SMP Scheduler:
    3723 
    3724 Use Deterministic Priority SMP Scheduler
    3725 ----------------------------------------
     3471.. _CONFIGURE_SCHEDULER_PRIORITY_SMP:
     3472
     3473CONFIGURE_SCHEDULER_PRIORITY_SMP
     3474--------------------------------
    37263475
    37273476CONSTANT:
     
    37523501    selected when ``CONFIGURE_MAXIMUM_PROCESSORS`` is greater than one.
    37533502
    3754 .. COMMENT: === CONFIGURE_SCHEDULER_SIMPLE_SMP ===
    3755 
    37563503.. index:: CONFIGURE_SCHEDULER_SIMPLE_SMP
    37573504
    3758 .. _Use Simple SMP Priority Scheduler:
    3759 
    3760 Use Simple SMP Priority Scheduler
    3761 ---------------------------------
     3505.. _CONFIGURE_SCHEDULER_SIMPLE_SMP:
     3506
     3507CONFIGURE_SCHEDULER_SIMPLE_SMP
     3508------------------------------
    37623509
    37633510CONSTANT:
     
    37943541    enabled.
    37953542
    3796 .. COMMENT: === Configuring a Scheduler Name ===
    3797 
    37983543.. index:: CONFIGURE_SCHEDULER_NAME
    37993544
    3800 .. _Configuring a Scheduler Name:
    3801 
    3802 Configuring a Scheduler Name
    3803 ----------------------------
     3545.. _CONFIGURE_SCHEDULER_NAME:
     3546
     3547CONFIGURE_SCHEDULER_NAME
     3548------------------------
    38043549
    38053550CONSTANT:
     
    38293574    None.
    38303575
    3831 .. COMMENT: === Configuring a User Scheduler ===
    3832 
    38333576.. index:: CONFIGURE_SCHEDULER_USER
    38343577
    3835 .. _Configuring a User Provided Scheduler:
    3836 
    3837 Configuring a User Provided Scheduler
    3838 -------------------------------------
     3578.. _CONFIGURE_SCHEDULER_USER:
     3579
     3580CONFIGURE_SCHEDULER_USER
     3581------------------------
    38393582
    38403583CONSTANT:
     
    38733616    the configuration macros, please examine ``cpukit/sapi/include/confdefs.h``
    38743617    for how these are defined for the Deterministic Priority Scheduler.
    3875 
    3876 .. COMMENT: === Configuring Clustered Schedulers ===
    38773618
    38783619.. _Configuring Clustered Schedulers:
     
    40473788            RTEMS_SCHEDULER_ASSIGN(1, RTEMS_SCHEDULER_ASSIGN_PROCESSOR_OPTIONAL)
    40483789
    4049 .. COMMENT: === Device Driver Table ===
    4050 
    40513790Device Driver Table
    40523791===================
     
    40593798Note that network device drivers are not configured in the Device Driver Table.
    40603799
    4061 .. COMMENT: === CONFIGURE_MAXIMUM_DRIVERS ===
    4062 
    40633800.. index:: CONFIGURE_MAXIMUM_DRIVERS
    40643801
    4065 .. _Specifying the Maximum Number of Device Drivers:
    4066 
    4067 Specifying the Maximum Number of Device Drivers
    4068 -----------------------------------------------
     3802.. _CONFIGURE_MAXIMUM_DRIVERS:
     3803
     3804CONFIGURE_MAXIMUM_DRIVERS
     3805-------------------------
    40693806
    40703807CONSTANT:
     
    40943831    statically installed.
    40953832
    4096 .. COMMENT: === CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER ===
    4097 
    40983833.. index:: CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER
    40993834
    4100 .. _Enable Console Device Driver:
    4101 
    4102 Enable Console Device Driver
    4103 ----------------------------
     3835.. _CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER:
     3836
     3837CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER
     3838------------------------------------------
    41043839
    41053840CONSTANT:
     
    41263861    properly without the need for the console driver to be configured.
    41273862
    4128 .. COMMENT: === CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER ===
    4129 
    41303863.. index:: CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER
    41313864
    4132 .. _Enable Clock Driver:
    4133 
    4134 Enable Clock Driver
    4135 -------------------
     3865.. _CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER:
     3866
     3867CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER
     3868----------------------------------------
    41363869
    41373870CONSTANT:
     
    41603893    compile time error will occur.
    41613894
    4162 .. COMMENT: === CONFIGURE_APPLICATION_NEEDS_TIMER_DRIVER ===
    4163 
    41643895.. index:: CONFIGURE_APPLICATION_NEEDS_TIMER_DRIVER
    41653896
    4166 .. _Enable the Benchmark Timer Driver:
    4167 
    4168 Enable the Benchmark Timer Driver
    4169 ---------------------------------
     3897.. _CONFIGURE_APPLICATION_NEEDS_TIMER_DRIVER:
     3898
     3899CONFIGURE_APPLICATION_NEEDS_TIMER_DRIVER
     3900----------------------------------------
    41703901
    41713902CONSTANT:
     
    41923923    compile time error will occur.
    41933924
    4194 .. COMMENT: === CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER ===
    4195 
    41963925.. index:: CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER
    41973926
    4198 .. _Specify Clock and Benchmark Timer Drivers Are Not Needed:
    4199 
    4200 Specify Clock and Benchmark Timer Drivers Are Not Needed
    4201 --------------------------------------------------------
     3927.. _CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER:
     3928
     3929CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER
     3930------------------------------------------------
    42023931
    42033932CONSTANT:
     
    42243953    leaving out a clock tick source.
    42253954
    4226 .. COMMENT: === CONFIGURE_APPLICATION_NEEDS_RTC_DRIVER ===
    4227 
    42283955.. index:: CONFIGURE_APPLICATION_NEEDS_RTC_DRIVER
    42293956
    4230 .. _Enable Real-Time Clock Driver:
    4231 
    4232 Enable Real-Time Clock Driver
    4233 -----------------------------
     3957.. _CONFIGURE_APPLICATION_NEEDS_RTC_DRIVER:
     3958
     3959CONFIGURE_APPLICATION_NEEDS_RTC_DRIVER
     3960--------------------------------------
    42343961
    42353962CONSTANT:
     
    42563983    user will get a link time error for an undefined symbol.
    42573984
    4258 .. COMMENT: === CONFIGURE_APPLICATION_NEEDS_WATCHDOG_DRIVER ===
    4259 
    42603985.. index:: CONFIGURE_APPLICATION_NEEDS_WATCHDOG_DRIVER
    42613986
    4262 .. _Enable the Watchdog Device Driver:
    4263 
    4264 Enable the Watchdog Device Driver
    4265 ---------------------------------
     3987.. _CONFIGURE_APPLICATION_NEEDS_WATCHDOG_DRIVER:
     3988
     3989CONFIGURE_APPLICATION_NEEDS_WATCHDOG_DRIVER
     3990-------------------------------------------
    42663991
    42673992CONSTANT:
     
    42884013    user will get a link time error for an undefined symbol.
    42894014
    4290 .. COMMENT: === CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER ===
    4291 
    42924015.. index:: CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER
    42934016
    4294 .. _Enable the Graphics Frame Buffer Device Driver:
    4295 
    4296 Enable the Graphics Frame Buffer Device Driver
    4297 ----------------------------------------------
     4017.. _CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER:
     4018
     4019CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER
     4020-----------------------------------------------
    42984021
    42994022CONSTANT:
     
    43204043    user will get a link time error for an undefined symbol.
    43214044
    4322 .. COMMENT: === CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER ===
    4323 
    43244045.. index:: CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER
    43254046
    4326 .. _Enable Stub Device Driver:
    4327 
    4328 Enable Stub Device Driver
    4329 -------------------------
     4047.. _CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER:
     4048
     4049CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER
     4050---------------------------------------
    43304051
    43314052CONSTANT:
     
    43494070    is primarily a test fixture. It is supported by all BSPs.
    43504071
    4351 .. COMMENT: === CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS ===
    4352 
    43534072.. index:: CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS
    43544073
    4355 .. _Specify Application Prerequisite Device Drivers:
    4356 
    4357 Specify Application Prerequisite Device Drivers
    4358 -----------------------------------------------
     4074.. _CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS:
     4075
     4076CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS
     4077------------------------------------------
    43594078
    43604079CONSTANT:
     
    43864105.. COMMENT: XXX Add example
    43874106
    4388 .. COMMENT: === CONFIGURE_APPLICATION_EXTRA_DRIVERS ===
    4389 
    43904107.. index:: CONFIGURE_APPLICATION_EXTRA_DRIVERS
    43914108
    4392 .. _Specify Extra Application Device Drivers:
    4393 
    4394 Specify Extra Application Device Drivers
    4395 ----------------------------------------
     4109.. _CONFIGURE_APPLICATION_EXTRA_DRIVERS:
     4110
     4111CONFIGURE_APPLICATION_EXTRA_DRIVERS
     4112-----------------------------------
    43964113
    43974114CONSTANT:
     
    44164133    None.
    44174134
    4418 .. COMMENT: === CONFIGURE_APPLICATION_NEEDS_NULL_DRIVER ===
    4419 
    44204135.. index:: CONFIGURE_APPLICATION_NEEDS_NULL_DRIVER
    44214136.. index:: /dev/null
    44224137
    4423 .. _Enable /dev/null Device Driver:
    4424 
    4425 Enable /dev/null Device Driver
    4426 ------------------------------
     4138.. _CONFIGURE_APPLICATION_NEEDS_NULL_DRIVER:
     4139
     4140CONFIGURE_APPLICATION_NEEDS_NULL_DRIVER
     4141---------------------------------------
    44274142
    44284143CONSTANT:
     
    44434158NOTES:
    44444159    This device driver is supported by all BSPs.
    4445 
    4446 .. COMMENT: === CONFIGURE_APPLICATION_NEEDS_ZERO_DRIVER ===
    44474160
    44484161.. index:: CONFIGURE_APPLICATION_NEEDS_ZERO_DRIVER
    44494162.. index:: /dev/zero
    44504163
    4451 .. _Enable /dev/zero Device Driver:
    4452 
    4453 Enable /dev/zero Device Driver
    4454 ------------------------------
     4164.. _CONFIGURE_APPLICATION_NEEDS_ZERO_DRIVER:
     4165
     4166CONFIGURE_APPLICATION_NEEDS_ZERO_DRIVER
     4167---------------------------------------
    44554168
    44564169CONSTANT:
     
    44724185    This device driver is supported by all BSPs.
    44734186
    4474 .. COMMENT: === CONFIGURE_HAS_OWN_DEVICE_DRIVER_TABLE ===
    4475 
    44764187.. index:: CONFIGURE_HAS_OWN_DEVICE_DRIVER_TABLE
    44774188
    4478 .. _Specifying Application Defined Device Driver Table:
    4479 
    4480 Specifying Application Defined Device Driver Table
    4481 --------------------------------------------------
     4189.. _CONFIGURE_HAS_OWN_DEVICE_DRIVER_TABLE:
     4190
     4191CONFIGURE_HAS_OWN_DEVICE_DRIVER_TABLE
     4192-------------------------------------
    44824193
    44834194CONSTANT:
     
    45064217    It is expected that there the application would only rarely need to do this.
    45074218
    4508 .. COMMENT: === Multiprocessing Configuration ===
    4509 
    45104219Multiprocessing Configuration
    45114220=============================
     
    45194228``CONFIGURE_MP_APPLICATION`` is defined.
    45204229
    4521 .. COMMENT: === CONFIGURE_MP_APPLICATION ===
    4522 
    45234230.. index:: CONFIGURE_MP_APPLICATION
    45244231
    4525 .. _Specify Application Will Use Multiprocessing:
    4526 
    4527 Specify Application Will Use Multiprocessing
    4528 --------------------------------------------
     4232.. _CONFIGURE_MP_APPLICATION:
     4233
     4234CONFIGURE_MP_APPLICATION
     4235------------------------
    45294236
    45304237CONSTANT:
     
    45504257    ``--enable-multiprocessing`` option.
    45514258
    4552 .. COMMENT: === CONFIGURE_MP_NODE_NUMBER ===
    4553 
    45544259.. index:: CONFIGURE_MP_NODE_NUMBER
    45554260
    4556 .. _Configure Node Number in Multiprocessor Configuration:
    4557 
    4558 Configure Node Number in Multiprocessor Configuration
    4559 -----------------------------------------------------
     4261.. _CONFIGURE_MP_NODE_NUMBER:
     4262
     4263CONFIGURE_MP_NODE_NUMBER
     4264------------------------
    45604265
    45614266CONSTANT:
     
    45824287    differently based upon their node number.
    45834288
    4584 .. COMMENT: === CONFIGURE_MP_MAXIMUM_NODES ===
    4585 
    45864289.. index:: CONFIGURE_MP_MAXIMUM_NODES
    45874290
    4588 .. _Configure Maximum Node in Multiprocessor Configuration:
    4589 
    4590 Configure Maximum Node in Multiprocessor Configuration
    4591 ------------------------------------------------------
     4291.. _CONFIGURE_MP_MAXIMUM_NODES:
     4292
     4293CONFIGURE_MP_MAXIMUM_NODES
     4294--------------------------
    45924295
    45934296CONSTANT:
     
    46104313    None.
    46114314
    4612 .. COMMENT: === CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS ===
    4613 
    46144315.. index:: CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS
    46154316
    4616 .. _Configure Maximum Global Objects in Multiprocessor Configuration:
    4617 
    4618 Configure Maximum Global Objects in Multiprocessor Configuration
    4619 ----------------------------------------------------------------
     4317.. _CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS:
     4318
     4319CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS
     4320-----------------------------------
    46204321
    46214322CONSTANT:
     
    46394340    with the ``RTEMS_GLOBAL`` attribute.
    46404341
    4641 .. COMMENT: === CONFIGURE_MP_MAXIMUM_PROXIES ===
    4642 
    46434342.. index:: CONFIGURE_MP_MAXIMUM_PROXIES
    46444343
    4645 .. _Configure Maximum Proxies in Multiprocessor Configuration:
    4646 
    4647 Configure Maximum Proxies in Multiprocessor Configuration
    4648 ---------------------------------------------------------
     4344.. _CONFIGURE_MP_MAXIMUM_PROXIES:
     4345
     4346CONFIGURE_MP_MAXIMUM_PROXIES
     4347----------------------------
    46494348
    46504349CONSTANT:
     
    46714370.. COMMENT: XXX - add xref to proxy discussion in MP chapter
    46724371
    4673 .. COMMENT: === CONFIGURE_MP_MPCI_TABLE_POINTER ===
    4674 
    46754372.. index:: CONFIGURE_MP_MPCI_TABLE_POINTER
    46764373
    4677 .. _Configure MPCI in Multiprocessor Configuration:
    4678 
    4679 Configure MPCI in Multiprocessor Configuration
    4680 ----------------------------------------------
     4374.. _CONFIGURE_MP_MPCI_TABLE_POINTER:
     4375
     4376CONFIGURE_MP_MPCI_TABLE_POINTER
     4377-------------------------------
    46814378
    46824379CONSTANT:
     
    47014398    supporting methods.
    47024399
    4703 .. COMMENT: === CONFIGURE_HAS_OWN_MULTIPROCESSING_TABLE ===
    4704 
    47054400.. index:: CONFIGURE_HAS_OWN_MULTIPROCESSING_TABLE
    47064401
    4707 .. _Do Not Generate Multiprocessor Configuration Table:
    4708 
    4709 Do Not Generate Multiprocessor Configuration Table
    4710 --------------------------------------------------
     4402.. _CONFIGURE_HAS_OWN_MULTIPROCESSING_TABLE:
     4403
     4404CONFIGURE_HAS_OWN_MULTIPROCESSING_TABLE
     4405---------------------------------------
    47114406
    47124407CONSTANT:
     
    47324427    please reconsider and discuss this on the RTEMS Users mailing list.
    47334428
    4734 .. COMMENT: === Ada Tasks ===
    4735 
    47364429Ada Tasks
    47374430=========
     
    47494442``--enable-expada`` are specified on the configure command.
    47504443
    4751 .. COMMENT: === CONFIGURE_GNAT_RTEMS ===
    4752 
    47534444.. index:: CONFIGURE_GNAT_RTEMS
    47544445
    4755 .. _Specify Application Includes Ada Code:
    4756 
    4757 Specify Application Includes Ada Code
    4758 -------------------------------------
     4446.. _CONFIGURE_GNAT_RTEMS:
     4447
     4448CONFIGURE_GNAT_RTEMS
     4449--------------------
    47594450
    47604451CONSTANT:
     
    47794470    and Keys) used implicitly by the GNAT run-time.
    47804471
    4781 .. COMMENT: === CONFIGURE_MAXIMUM_ADA_TASKS ===
    4782 
    47834472.. index:: CONFIGURE_MAXIMUM_ADA_TASKS
    47844473
    4785 .. _Specify the Maximum Number of Ada Tasks.:
    4786 
    4787 Specify the Maximum Number of Ada Tasks.
    4788 ----------------------------------------
     4474.. _CONFIGURE_MAXIMUM_ADA_TASKS:
     4475
     4476CONFIGURE_MAXIMUM_ADA_TASKS
     4477---------------------------
    47894478
    47904479CONSTANT:
     
    48084497    None.
    48094498
    4810 .. COMMENT: === CONFIGURE_MAXIMUM_FAKE_ADA_TASKS ===
    4811 
    48124499.. index:: CONFIGURE_MAXIMUM_FAKE_ADA_TASKS
    48134500
    4814 .. _Specify the Maximum Fake Ada Tasks:
    4815 
    4816 Specify the Maximum Fake Ada Tasks
    4817 ----------------------------------
     4501.. _CONFIGURE_MAXIMUM_FAKE_ADA_TASKS:
     4502
     4503CONFIGURE_MAXIMUM_FAKE_ADA_TASKS
     4504--------------------------------
    48184505
    48194506CONSTANT:
     
    48374524NOTES:
    48384525    None.
    4839 
    4840 .. COMMENT: === PCI Library ===
    48414526
    48424527PCI Library
     
    48924577Plug & Play is not performed.
    48934578
    4894 .. COMMENT: === Go Tasks ===
    4895 
    48964579Go Tasks
    48974580========
    48984581
    4899 .. COMMENT: === CONFIGURE_ENABLE_GO ===
    4900 
    49014582.. index:: CONFIGURE_ENABLE_GO
    49024583
    4903 .. _Specify Application Includes Go Code:
    4904 
    4905 Specify Application Includes Go Code
    4906 ------------------------------------
     4584.. _CONFIGURE_ENABLE_GO:
     4585
     4586CONFIGURE_ENABLE_GO
     4587-------------------
    49074588
    49084589CONSTANT:
     
    49254606    The Go language support is experimental
    49264607
    4927 .. COMMENT: === CONFIGURE_MAXIMUM_GOROUTINES ===
    4928 
    49294608.. index:: CONFIGURE_MAXIMUM_GOROUTINES
    49304609
    4931 .. _Specify the maximum number of Go routines:
    4932 
    4933 Specify the maximum number of Go routines
    4934 -----------------------------------------
     4610.. _CONFIGURE_MAXIMUM_GOROUTINES:
     4611
     4612CONFIGURE_MAXIMUM_GOROUTINES
     4613----------------------------
    49354614
    49364615CONSTANT:
     
    49534632    The Go language support is experimental
    49544633
    4955 .. COMMENT: === CONFIGURE_MAXIMUM_GO_CHANNELS ===
    4956 
    49574634.. index:: CONFIGURE_MAXIMUM_GO_CHANNELS
    49584635
    4959 .. _Specify the maximum number of Go Channels:
    4960 
    4961 Specify the maximum number of Go Channels
    4962 -----------------------------------------
     4636.. _CONFIGURE_MAXIMUM_GO_CHANNELS:
     4637
     4638CONFIGURE_MAXIMUM_GO_CHANNELS
     4639-----------------------------
    49634640
    49644641CONSTANT:
Note: See TracChangeset for help on using the changeset viewer.