Changeset d48ea69 in rtems


Ignore:
Timestamp:
Jun 15, 1999, 12:07:14 AM (22 years ago)
Author:
Joel Sherrill <joel.sherrill@…>
Branches:
4.10, 4.11, 4.8, 4.9, 5, master
Children:
56853af
Parents:
4ecc390
Message:

Significantly enhanced. At least the per routine pages for this chapter
are now filled in.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/posix_users/thread.t

    r4ecc390 rd48ea69  
    1111@section Introduction
    1212
    13 The thread manager ...
     13The thread manager implements the functionality required of the thread
     14manager as defined by POSIX 1003.1b-1996.  This standard requires that
     15a compliant operating system provide the facilties to manage multiple
     16threads of control and defines the API that must be provided.
    1417
    1518The directives provided by the thread manager are:
    1619
    1720@itemize @bullet
    18 @item @code{pthread_attr_init} -
    19 @item @code{pthread_attr_destroy} -
    20 @item @code{pthread_attr_setdetachstate} -
    21 @item @code{pthread_attr_getdetachstate} -
    22 @item @code{pthread_attr_setstacksize} -
    23 @item @code{pthread_attr_getstacksize} -
    24 @item @code{pthread_attr_setstackaddr} -
    25 @item @code{pthread_attr_getstackaddr} -
    26 @item @code{pthread_attr_setscope} -
    27 @item @code{pthread_attr_getscope} -
    28 @item @code{pthread_attr_setinheritsched} -
    29 @item @code{pthread_attr_getinheritsched} -
    30 @item @code{pthread_attr_setschedpolicy} -
    31 @item @code{pthread_attr_getschedpolicy} -
    32 @item @code{pthread_attr_setschedparam} -
    33 @item @code{pthread_attr_getschedparam} -
    34 @item @code{pthread_create} -
    35 @item @code{pthread_exit} -
    36 @item @code{pthread_detach} -
    37 @item @code{pthread_join} -
    38 @item @code{pthread_self} -
    39 @item @code{pthread_equal} -
    40 @item @code{pthread_once} -
    41 @item @code{pthread_setschedparam} -
    42 @item @code{pthread_getschedparam} -
     21@item @code{pthread_attr_init} - Initialize a Thread Attribute Set
     22@item @code{pthread_attr_destroy} - Destroy a Thread Attribute Set
     23@item @code{pthread_attr_setdetachstate} - Set Detach State
     24@item @code{pthread_attr_getdetachstate} - Get Detach State
     25@item @code{pthread_attr_setstacksize} - Set Thread Stack Size
     26@item @code{pthread_attr_getstacksize} - Get Thread Stack Size
     27@item @code{pthread_attr_setstackaddr} - Set Thread Stack Address
     28@item @code{pthread_attr_getstackaddr} - Get Thread Stack Address
     29@item @code{pthread_attr_setscope} - Set Thread Scheduling Scope
     30@item @code{pthread_attr_getscope} - Get Thread Scheduling Scope
     31@item @code{pthread_attr_setinheritsched} - Set Inherit Scheduler Flag
     32@item @code{pthread_attr_getinheritsched} - Get Inherit Scheduler Flag
     33@item @code{pthread_attr_setschedpolicy} - Set Scheduling Policy
     34@item @code{pthread_attr_getschedpolicy} - Get Scheduling Policy
     35@item @code{pthread_attr_setschedparam} - Set Scheduling Parameters
     36@item @code{pthread_attr_getschedparam} - Get Scheduling Parameters
     37@item @code{pthread_create} - Create a Thread
     38@item @code{pthread_exit} - Terminate the Current Thread
     39@item @code{pthread_detach} - Detach a Thread
     40@item @code{pthread_join} - Wait for Thread Termination
     41@item @code{pthread_self} - Get Thread ID
     42@item @code{pthread_equal} - Compare Thread IDs
     43@item @code{pthread_once} - Dynamic Package Initialization
     44@item @code{pthread_setschedparam} - Set Thread Scheduling Parameters
     45@item @code{pthread_getschedparam} - Get Thread Scheduling Parameters
    4346@end itemize
    4447
     
    4750@subsection Thread Attributes
    4851
    49 Thread attributes are utilized only at thread creation time.
     52Thread attributes are utilized only at thread creation time.  A thread
     53attribute structure may be initialized and passed as an argument to
     54the @code{pthread_create} routine.
    5055
    5156@table @b
     
    95100
    96101@page
    97 @subsection pthread_attr_init
     102@subsection pthread_attr_init - Initialize a Thread Attribute Set
    98103
    99104@subheading CALLING SEQUENCE:
     
    118123@subheading DESCRIPTION:
    119124
    120 @subheading NOTES:
    121 
    122 @page
    123 @subsection pthread_attr_destroy
     125The @code{pthread_attr_init} routine initializes the thread attributes
     126object specified by @code{attr} with the default value for all of the
     127individual attributes.
     128
     129@subheading NOTES:
     130
     131The settings in the default attributes are implementation defined.  For
     132RTEMS, the default attributes are as follows:
     133
     134@itemize @bullet
     135
     136@item stackadr
     137is not set to indicate that RTEMS is to allocate the stack memory.
     138
     139@item stacksize
     140is set to @code{PTHREAD_MINIMUM_STACK_SIZE}.
     141
     142@item contentionscope
     143is set to @code{PTHREAD_SCOPE_PROCESS}.
     144
     145@item inheritsched
     146is set to @code{PTHREAD_INHERIT_SCHED} to indicate that the created
     147thread inherits its scheduling attributes from its parent.
     148
     149@item detachstate
     150is set to @code{PTHREAD_CREATE_JOINABLE}.
     151
     152@end itemize
     153
     154
     155@page
     156@subsection pthread_attr_destroy - Destroy a Thread Attribute Set
    124157
    125158@subheading CALLING SEQUENCE:
     
    146179@subheading DESCRIPTION:
    147180
    148 @subheading NOTES:
    149 
    150 @page
    151 @subsection pthread_attr_setdetachstate
     181The @code{pthread_attr_destroy} routine is used to destroy a thread
     182attributes object.  The behavior of using an attributes object after
     183it is destroyed is implementation dependent.
     184
     185@subheading NOTES:
     186
     187NONE
     188
     189@page
     190@subsection pthread_attr_setdetachstate - Set Detach State
    152191
    153192@subheading CALLING SEQUENCE:
     
    178217@subheading DESCRIPTION:
    179218
    180 @subheading NOTES:
    181 
    182 @page
    183 @subsection pthread_attr_getdetachstate
     219The @code{pthread_attr_setdetachstate} routine is used to value of the
     220@code{detachstate} attribute.  This attribute controls whether the
     221thread is created in a detached state. 
     222
     223The @code{detachstate} can be either @code{PTHREAD_CREATE_DETACHED} or
     224@code{PTHREAD_CREATE_JOINABLE}.  The default value for all threads is
     225@code{PTHREAD_CREATE_JOINABLE}.
     226
     227@subheading NOTES:
     228
     229If a thread is in a detached state,
     230then the use of the ID with the @code{pthread_detach} or
     231@code{pthread_join} routines is an error.
     232
     233@page
     234@subsection pthread_attr_getdetachstate - Get Detach State
    184235
    185236@subheading CALLING SEQUENCE:
     
    210261@subheading DESCRIPTION:
    211262
    212 @subheading NOTES:
    213 
    214 @page
    215 @subsection pthread_attr_setstacksize
     263The @code{pthread_attr_getdetachstate} routine is used to obtain the
     264current value of the @code{detachstate} attribute as specified
     265by the @code{attr} thread attribute object.
     266
     267@subheading NOTES:
     268
     269NONE
     270
     271@page
     272@subsection pthread_attr_setstacksize - Set Thread Stack Size
    216273
    217274@subheading CALLING SEQUENCE:
     
    239296@subheading DESCRIPTION:
    240297
    241 @subheading NOTES:
    242 
    243 If the specified stacksize is below the minimum required for this CPU, then
    244 the stacksize will be set to the minimum for this CPU.
    245 
    246 @page
    247 @subsection pthread_attr_getstacksize
     298The @code{pthread_attr_setstacksize} routine is used to set the
     299@code{stacksize} attribute in the @code{attr} thread attribute
     300object.
     301
     302@subheading NOTES:
     303
     304As required by POSIX, RTEMS defines the feature symbol
     305@code{_POSIX_THREAD_ATTR_STACKSIZE} to indicate that this
     306routine is supported.
     307
     308If the specified stacksize is below the minimum required for this CPU
     309(@code{PTHREAD_STACK_MIN}, then the stacksize will be set to the minimum
     310for this CPU.
     311
     312@page
     313@subsection pthread_attr_getstacksize - Get Thread Stack Size
    248314
    249315@subheading CALLING SEQUENCE:
     
    274340@subheading DESCRIPTION:
    275341
    276 @subheading NOTES:
    277 
    278 @page
    279 @subsection pthread_attr_setstackaddr
     342The @code{pthread_attr_getstacksize} routine is used to obtain the
     343@code{stacksize} attribute in the @code{attr} thread attribute
     344object.
     345
     346@subheading NOTES:
     347
     348As required by POSIX, RTEMS defines the feature symbol
     349@code{_POSIX_THREAD_ATTR_STACKSIZE} to indicate that this
     350routine is supported.
     351
     352@page
     353@subsection pthread_attr_setstackaddr - Set Thread Stack Address
    280354
    281355@subheading CALLING SEQUENCE:
     
    303377@subheading DESCRIPTION:
    304378
    305 @subheading NOTES:
    306 
    307 @page
    308 @subsection pthread_attr_getstackaddr
     379The @code{pthread_attr_setstackaddr} routine is used to set the
     380@code{stackaddr} attribute in the @code{attr} thread attribute
     381object.
     382
     383@subheading NOTES:
     384
     385As required by POSIX, RTEMS defines the feature symbol
     386@code{_POSIX_THREAD_ATTR_STACKADDR} to indicate that this
     387routine is supported.
     388
     389It is imperative to the proper operation of the system that
     390each thread have sufficient stack space.
     391
     392@page
     393@subsection pthread_attr_getstackaddr - Get Thread Stack Address
    309394
    310395@subheading CALLING SEQUENCE:
     
    335420@subheading DESCRIPTION:
    336421
    337 @subheading NOTES:
    338 
    339 @page
    340 @subsection pthread_attr_setscope
     422The @code{pthread_attr_getstackaddr} routine is used to obtain the
     423@code{stackaddr} attribute in the @code{attr} thread attribute
     424object.
     425
     426@subheading NOTES:
     427
     428As required by POSIX, RTEMS defines the feature symbol
     429@code{_POSIX_THREAD_ATTR_STACKADDR} to indicate that this
     430routine is supported.
     431
     432@page
     433@subsection pthread_attr_setscope - Set Thread Scheduling Scope
    341434
    342435@subheading CALLING SEQUENCE:
     
    370463@subheading DESCRIPTION:
    371464
    372 @subheading NOTES:
    373 
    374 @page
    375 @subsection pthread_attr_getscope
     465The @code{pthread_attr_setscope} routine is used to set the contention
     466scope field in the thread attribute object @code{attr} to the value
     467specified by @code{contentionscope}.
     468
     469The @code{contentionscope} must be either @code{PTHREAD_SCOPE_SYSTEM}
     470to indicate that the thread is to be within system scheduling contention
     471or @code{PTHREAD_SCOPE_PROCESS} indicating that the thread is to be
     472within the process scheduling contention scope.
     473
     474@subheading NOTES:
     475
     476As required by POSIX, RTEMS defines the feature symbol
     477@code{_POSIX_THREAD_PRIORITY_SCHEDULING} to indicate that the
     478family of routines to which this routine belongs is supported.
     479
     480@page
     481@subsection pthread_attr_getscope - Get Thread Scheduling Scope
    376482
    377483@subheading CALLING SEQUENCE:
     
    402508@subheading DESCRIPTION:
    403509
    404 @subheading NOTES:
    405 
    406 @page
    407 @subsection pthread_attr_setinheritsched
     510The @code{pthread_attr_getscope} routine is used to obtain the
     511value of the contention scope field in the thread attributes
     512object @code{attr}.  The current value is returned in
     513@code{contentionscope}.
     514
     515@subheading NOTES:
     516
     517As required by POSIX, RTEMS defines the feature symbol
     518@code{_POSIX_THREAD_PRIORITY_SCHEDULING} to indicate that the
     519family of routines to which this routine belongs is supported.
     520@page
     521@subsection pthread_attr_setinheritsched - Set Inherit Scheduler Flag
    408522
    409523@subheading CALLING SEQUENCE:
     
    434548@subheading DESCRIPTION:
    435549
    436 @subheading NOTES:
    437 
    438 @page
    439 @subsection pthread_attr_getinheritsched
     550The @code{pthread_attr_setinheritsched} routine is used to set the
     551inherit scheduler field in the thread attribute object @code{attr} to
     552the value specified by @code{inheritsched}. 
     553
     554The @code{contentionscope} must be either @code{PTHREAD_INHERIT_SCHED}
     555to indicate that the thread is to inherit the scheduling policy
     556and parameters fromthe creating thread, or @code{PTHREAD_EXPLICIT_SCHED}
     557to indicate that the scheduling policy and parameters for this thread
     558are to be set from the corresponding values in the attributes object.
     559If @code{contentionscope} is @code{PTHREAD_INHERIT_SCHED}, then the
     560scheduling attributes in the @code{attr} structure will be ignored
     561at thread creation time.
     562
     563@subheading NOTES:
     564
     565As required by POSIX, RTEMS defines the feature symbol
     566@code{_POSIX_THREAD_PRIORITY_SCHEDULING} to indicate that the
     567family of routines to which this routine belongs is supported.
     568
     569@page
     570@subsection pthread_attr_getinheritsched - Get Inherit Scheduler Flag
    440571
    441572@subheading CALLING SEQUENCE:
     
    465596@subheading DESCRIPTION:
    466597
    467 @subheading NOTES:
    468 
    469 @page
    470 @subsection pthread_attr_setschedpolicy
     598The @code{pthread_attr_getinheritsched} routine is used to
     599object the current value of the inherit scheduler field in
     600the thread attribute object @code{attr}.
     601
     602@subheading NOTES:
     603
     604As required by POSIX, RTEMS defines the feature symbol
     605@code{_POSIX_THREAD_PRIORITY_SCHEDULING} to indicate that the
     606family of routines to which this routine belongs is supported.
     607
     608@page
     609@subsection pthread_attr_setschedpolicy - Set Scheduling Policy
    471610
    472611@subheading CALLING SEQUENCE:
     
    496635@subheading DESCRIPTION:
    497636
    498 @subheading NOTES:
    499 
    500 @page
    501 @subsection pthread_attr_getschedpolicy
     637The @code{pthread_attr_setschedpolicy} routine is used to set the
     638scheduler policy field in the thread attribute object @code{attr} to
     639the value specified by @code{policy}.
     640
     641Scheduling policies may be one of the following:
     642
     643@itemize @bullet
     644
     645@item @code{SCHED_DEFAULT}
     646@item @code{SCHED_FIFO}
     647@item @code{SCHED_RR}
     648@item @code{SCHED_SPORADIC}
     649@item @code{SCHED_OTHER}
     650
     651@end itemize
     652
     653The precise meaning of each of these is discussed elsewhere in this
     654manual.
     655
     656@subheading NOTES:
     657
     658As required by POSIX, RTEMS defines the feature symbol
     659@code{_POSIX_THREAD_PRIORITY_SCHEDULING} to indicate that the
     660family of routines to which this routine belongs is supported.
     661
     662@page
     663@subsection pthread_attr_getschedpolicy - Get Scheduling Policy
    502664
    503665@subheading CALLING SEQUENCE:
     
    527689@subheading DESCRIPTION:
    528690
    529 @subheading NOTES:
    530 
    531 @page
    532 @subsection pthread_attr_setschedparam
     691The @code{pthread_attr_getschedpolicy} routine is used to obtain the
     692scheduler policy field from the thread attribute object @code{attr}.
     693The value of this field is returned in @code{policy}.
     694
     695@subheading NOTES:
     696
     697As required by POSIX, RTEMS defines the feature symbol
     698@code{_POSIX_THREAD_PRIORITY_SCHEDULING} to indicate that the
     699family of routines to which this routine belongs is supported.
     700
     701@page
     702@subsection pthread_attr_setschedparam - Set Scheduling Parameters
    533703
    534704@subheading CALLING SEQUENCE:
     
    558728@subheading DESCRIPTION:
    559729
    560 @subheading NOTES:
    561 
    562 @page
    563 @subsection pthread_attr_getschedparam
     730The @code{pthread_attr_setschedparam} routine is used to set the
     731scheduler parameters field in the thread attribute object @code{attr} to
     732the value specified by @code{param}.
     733
     734@subheading NOTES:
     735
     736As required by POSIX, RTEMS defines the feature symbol
     737@code{_POSIX_THREAD_PRIORITY_SCHEDULING} to indicate that the
     738family of routines to which this routine belongs is supported.
     739
     740@page
     741@subsection pthread_attr_getschedparam - Get Scheduling Parameters
    564742
    565743@subheading CALLING SEQUENCE:
     
    589767@subheading DESCRIPTION:
    590768
    591 @subheading NOTES:
    592 
    593 @page
    594 @subsection pthread_create
     769The @code{pthread_attr_getschedparam} routine is used to obtain the
     770scheduler parameters field from the thread attribute object @code{attr}.
     771The value of this field is returned in @code{param}.
     772
     773@subheading NOTES:
     774
     775As required by POSIX, RTEMS defines the feature symbol
     776@code{_POSIX_THREAD_PRIORITY_SCHEDULING} to indicate that the
     777family of routines to which this routine belongs is supported.
     778
     779@page
     780@subsection pthread_create - Create a Thread
    595781
    596782@subheading CALLING SEQUENCE:
     
    650836@subheading DESCRIPTION:
    651837
    652 @subheading NOTES:
    653 
    654 @page
    655 @subsection pthread_exit
     838The @code{pthread_create} routine is used to create a new thread with
     839the attributes specified by @code{attr}.  If the @code{attr} argument
     840is @code{NULL}, then the default attribute set will be used.  Modification
     841of the contents of @code{attr} after this thread is created does not
     842have an impact on this thread. 
     843
     844The thread begins execution at the address specified by @code{start_routine}
     845with @code{arg} as its only argument.  If @code{start_routine} returns,
     846then it is functionally equivalent to the thread executing the
     847@code{pthread_exit} service.
     848
     849Upon successful completion, the ID of the created thread is returned in the
     850@code{thread} argument.
     851
     852@subheading NOTES:
     853
     854There is no concept of a single main thread in RTEMS as there is in
     855a tradition UNIX system.  POSIX requires that the implicit return of
     856the main thread results in the same effects as if there were a call
     857to @code{exit}.  This does not occur in RTEMS.
     858
     859The signal mask of the newly created thread is inherited from its
     860creator and the set of pending signals for this thread is empty.
     861
     862@page
     863@subsection pthread_exit - Terminate the Current Thread
    656864
    657865@subheading CALLING SEQUENCE:
     
    673881@subheading DESCRIPTION:
    674882
    675 @subheading NOTES:
    676 
    677 @page
    678 @subsection pthread_detach
     883The @code{pthread_exit} routine is used to temrinate the calling thread.
     884The @code{status} is made available to any successful join with the
     885terminating thread.
     886
     887When a thread returns from its start routine, it results in an
     888implicit call to the @code{pthread_exit} routine with the return
     889value of the function serving as the argument to @code{pthread_exit}.
     890
     891@subheading NOTES:
     892
     893Any cancellation cleanup handlers that hace been pushed and not yet popped
     894shall be popped in reverse of the order that they were pushed.  After
     895all cancellation cleanup handlers have been executed, if the
     896thread has any thread-specific data, destructors for that data will
     897be invoked.
     898
     899Thread termination does not release or free any application visible
     900resources including byt not limited to mutexes, file descriptors, allocated
     901memory, etc..  Similarly, exitting a thread does not result in any
     902process-oriented cleanup activity.
     903
     904There is no concept of a single main thread in RTEMS as there is in
     905a tradition UNIX system.  POSIX requires that the implicit return of
     906the main thread results in the same effects as if there were a call
     907to @code{exit}.  This does not occur in RTEMS.
     908
     909All access to any automatic variables allocated by the threads is lost
     910when the thread exits.  Thus references (i.e. pointers) to local variables
     911of a thread should not be used in a global manner without care.  As
     912a specific example, a pointer to a local variable should NOT be used
     913as the return value.
     914
     915
     916@page
     917@subsection pthread_detach - Detach a Thread
    679918
    680919@subheading CALLING SEQUENCE:
     
    700939@subheading DESCRIPTION:
    701940
     941The @code{pthread_detach} routine is used to to indicate that storage
     942for @code{thread} can be reclaimed when the thread terminates without
     943another thread joinging with it.
     944
    702945@subheading NOTES:
    703946
    704947If any threads have previously joined with the specified thread, then they
    705 will remain joined with that thread.  Any subsequent calls to pthread_join
    706 on the specified thread will fail.
    707 
    708 @page
    709 @subsection pthread_join
     948will remain joined with that thread.  Any subsequent calls to
     949@code{pthread_join} on the specified thread will fail.
     950
     951@page
     952@subsection pthread_join - Wait for Thread Termination
    710953
    711954@subheading CALLING SEQUENCE:
     
    735978@subheading DESCRIPTION:
    736979
    737 @subheading NOTES:
     980The @code{pthread_join} routine suspends execution of the calling thread
     981until @code{thread} terminates.  If @code{thread} has already terminated,
     982then this routine returns immediately.  The value returned by @code{thread}
     983(i.e. passed to @code{pthread_exit} is returned in @code{value_ptr}.
     984
     985When this routine returns, then @code{thread} has been temrinated. 
     986
     987@subheading NOTES:
     988
     989The results of multiple simultaneous joins on the same thread is undefined.
    738990
    739991If any threads have previously joined with the specified thread, then they
    740 will remain joined with that thread.  Any subsequent calls to pthread_join
    741 on the specified thread will fail.
     992will remain joined with that thread.  Any subsequent calls to
     993@code{pthread_join} on the specified thread will fail.
    742994
    743995If value_ptr is NULL, then no value is returned.
    744996
    745997@page
    746 @subsection pthread_self
     998@subsection pthread_self - Get Thread ID
    747999
    7481000@subheading CALLING SEQUENCE:
     
    7561008@subheading STATUS CODES:
    7571009
    758 This routine returns the id of the calling thread.
    759 
    760 @subheading DESCRIPTION:
    761 
    762 @subheading NOTES:
    763 
    764 @page
    765 @subsection pthread_equal
     1010The value returned is the ID of the calling thread.
     1011
     1012@subheading DESCRIPTION:
     1013
     1014This routine returns the ID of the calling thread.
     1015
     1016@subheading NOTES:
     1017
     1018NONE
     1019
     1020@page
     1021@subsection pthread_equal - Compare Thread IDs
    7661022
    7671023@subheading CALLING SEQUENCE:
     
    7891045@subheading DESCRIPTION:
    7901046
     1047The @code{pthread_equal} routine is used to compare two thread
     1048IDs and determine if they are equal.
     1049
    7911050@subheading NOTES:
    7921051
     
    7941053
    7951054@page
    796 @subsection pthread_once
     1055@subsection pthread_once - Dynamic Package Initialization
    7971056
    7981057@subheading CALLING SEQUENCE:
     
    8151074@subheading DESCRIPTION:
    8161075
    817 @subheading NOTES:
    818 
    819 @page
    820 @subsection pthread_setschedparam
     1076The @code{pthread_once} routine is used to provide controlled initialization
     1077of variables.  The first call to @code{pthread_once} by any thread with the
     1078same @code{once_control} will result in the @code{init_routine} being
     1079invoked with no arguments.  Subsequent calls to @code{pthread_once} with
     1080the same @code{once_control} will have no effect. 
     1081
     1082The @code{init_routine} is guaranteed to have run to completion when
     1083this routine returns to the caller.
     1084
     1085@subheading NOTES:
     1086
     1087The behavior of @code{pthread_once} is undefined if @code{once_control}
     1088is automatic storage (i.e. on a task stack) or is not initialized using
     1089@code{PTHREAD_ONCE_INIT}.
     1090
     1091@page
     1092@subsection pthread_setschedparam - Set Thread Scheduling Parameters
    8211093
    8221094@subheading CALLING SEQUENCE:
     
    8561128@subheading DESCRIPTION:
    8571129
    858 @subheading NOTES:
    859 
    860 @page
    861 @subsection pthread_getschedparam
     1130The @code{pthread_setschedparam} routine is used to set the
     1131scheduler parameters currently associated with the thread specified
     1132by @code{thread} to the policy specified by @code{policy}.  The
     1133contents of @code{param} are interpreted based upon the @code{policy}
     1134argument.
     1135
     1136@subheading NOTES:
     1137
     1138As required by POSIX, RTEMS defines the feature symbol
     1139@code{_POSIX_THREAD_PRIORITY_SCHEDULING} to indicate that the
     1140family of routines to which this routine belongs is supported.
     1141
     1142@page
     1143@subsection pthread_getschedparam - Get Thread Scheduling Parameters
    8621144
    8631145@subheading CALLING SEQUENCE:
     
    8891171@subheading DESCRIPTION:
    8901172
    891 @subheading NOTES:
    892 
     1173The @code{pthread_getschedparam} routine is used to obtain the
     1174scheduler policy and parameters associated with @code{thread}.
     1175The current policy and associated parameters values returned in
     1176@code{policy} and @code{param}, respectively.
     1177
     1178@subheading NOTES:
     1179
     1180As required by POSIX, RTEMS defines the feature symbol
     1181@code{_POSIX_THREAD_PRIORITY_SCHEDULING} to indicate that the
     1182family of routines to which this routine belongs is supported.
Note: See TracChangeset for help on using the changeset viewer.