Thread Attributes

Table of contents:

In a POSIX implementation, if we want to generate a thread that does not have the default attributes (obtained by setting the second parameter of the pthread_create call to NULL), an attribute object is used. To use an attribute object, it must first be initialized . This is accomplished using the library call pthread_attr_init (see Table 11.5).

Table 11.5. The pthread_attr_init Library Function.

Include File(s)

Manual Section

3

Summary

int pthread_attr_init ( pthread_attr_t *attr );

Return

Success

Failure

Sets errno

Nonzero

 

The pthread_attr_init library function has a single argument, a reference to a previously allocated pthread_attr_t type object. If the call is successful, it returns a 0 and initializes the referenced attribute object with the default value for each attribute (see Table 11.6). A return of ENOMEM (12) indicates the system does not have sufficient memory to initialize the thread attribute object.

Once initialized, individual attribute values can be modified (see the following discussion). The attribute object is passed as the second argument to the pthread_create call. The newly created thread will have the specified attributes. The attribute object is independent of the thread, and changes to the attribute object after a thread has been created are not reflected in existing threads. Once established, a thread attribute object can be used in the generation of multiple threads. Thread attributes and their default values are shown in Table 11.6.

Table 11.6. Thread Attributes and Default Settings.

Attribute

Default

Comments

detachstate

PTHREAD_CREATE_JOINABLE

A nondetached thread that can be joined by other threads. The thread's resources are not freed until a call is made to pthread_join or the calling process exits.

inheritsched

PTHREAD_EXPLICIT_SCHED

Indicates whether or not scheduling attributes are inherited from parent thread or set explicitly by the attribute object.

schedparam

Scheduling parameters (priority).

schedpolicy

SCHED_OTHER

Scheduling is determined by the system (most often some sort of timesharing ). Note the missing PTHREAD_prefix.

scope

PTHREAD_SCOPE_SYSTEM

Scope of scheduling contentionwith all threads in same process or all processes in the system.

As presented, if the user wants a thread to have different characteristics, he or she should first initialize the attribute object using the pthread_attr_init library call and then change the attributes he or she wants to be different. Each attribute listed in Table 11.7 has an associated pthread_attr_setxxx and pthread_attr_getxxx function call that will act upon the attribute object.

Table 11.7. Thread Attribute Set and Get functions

Attribute

Set and get Calls

Defined Constants [11] for the 2nd setxxx parameter

 
int pthread_attr_setdetachstate (
 pthread_attr_t *attr,
 int detachstate);

PTHREAD_CREATE_JOINABLE

detachstate

   
 
int pthread_attr_getdetachstate (
 const pthread_attr_t *attr,
 int *detachstate);

PTHREAD_CREATE_DETACHED

 
int pthread_attr_setinheritsched (
 pthread_attr_t *attr,
 int inheritsched

PTHREAD_EXPLICIT_SCHED

inheritsched

   
 
int pthread_attr_getinheritsched (
 const pthread_attr_t *attr,
 int *inheritsched) ;

PTHREAD_INHERIT_SCHED

 
int pthread_attr_setschedparam (
 pthread_attr_t *attr,
 const struct sched_param *param);

Schedparam

 

Reference to valid sched_param [12] structure with its sched_priority member assigned a valid priority.

 
int pthread_attr_getschedparam (
 pthread_attr_t *attr,
 const struct sched_param *param);
 
int pthread_attr_setschedpolicy (
 pthread_attr_t *attr,
 int policy);

SCHED_OTHER [13]

SCHED_FIFO

SCHED_RR

Schedpolicy

   
 
int pthread_attr_getschedpolicy (
 const pthread_attr_t *attr,
 int *policy);
 
 
int pthread_attr_setscope (
 pthread_attr_t *attr,
 int contentionscope);

PTHREAD_SCOPE_SYSTEM

Scope

   
 
int pthread_attr_getscope (
 const pthread_attr_t *attr,
 int *contentionscope);

PTHREAD_SCOPE_PROCESS

[11] The highlighted values are the default.

[12] The sched_param structure is found in the include file , which is included by the file.

[13] Only processes with superuser privileges can specify SCHED_FIFO or SCHED_RR.

If in Program 11.1 we wanted to use the thread attribute object to indicate our threads be detached (that is, the thread would exit as soon as it has completed its task rather than for a join to be done in the calling function), we would add and modify the following program statements: [14]

[14] While not shown, we would also remove the lines of code that implement the join. Of course, if the initial thread (process) terminates before all threads have finished, complete output will not be generated.

.
 .
 .
 int
 main(int argc, char *argv[]) {
 pthread_t thread_id[MAX];
 20 int status, *p_status = &status;

pthread_attr_t attr_obj

; //

allocate attribute object

setvbuf(stdout, (char *) NULL, _IONBF, 0);
 .
 .
 .
 cout << "Displaying" << endl;
 //

Allocate & set atrib. obj


pthread_attr_init( &attr_obj)

;

pthread_attr_setdetachstate( &attr_obj, PTHREAD_CREATE_DETACHED )

;
 for (int i = 0; i < argc-1; ++i) { // generate threads
 .
 .
 .

The set and get attribute calls return a 0 if they are successful. If they fail, they return EINVAL (22) if passed an invalid parameter or ENOTSUP (95) [15] if the parameter specifies an unsupported feature.

[15] Linux does not support the constant ENOTSUP directly (which is usually assigned the value 48), but as a patch, defines ENOTSUP in terms of EOPNOTSUPP.

EXERCISE

Add a call to pthread_attr_getschedparam in Program 11.1 to determine the default priority (numeric value) for a thread on your system. Is it possible to modify the program to change the priority of each thread as it is created (use pthread_attr_setschedparam ) so the display of the command-line arguments is always in an ordered inverse sequence? Notice the display starts with the last argument and proceeds to the first (see partial output below).

linux$ your_solution one two three four five
.

<-- 1

.
.
five five four three two one five four three one four three

<-- 2

one three

(1) Five words are passed to the program.

(2) As the thread displaying the last word has the highest priority, it displays first, etc.

If yes, run your program several times to confirm that it works correctly; if no, why not? Note : You may want to use the pthread_getschedparam library function within the code actually executed by a thread to verify the thread's priority has been set correctly.

Programs and Processes

Processing Environment

Using Processes

Primitive Communications

Pipes

Message Queues

Semaphores

Shared Memory

Remote Procedure Calls

Sockets

Threads

Appendix A. Using Linux Manual Pages

Appendix B. UNIX Error Messages

Appendix C. RPC Syntax Diagrams

Appendix D. Profiling Programs



Interprocess Communication in Linux
Interprocess Communications in Linux: The Nooks and Crannies
ISBN: 0130460427
EAN: 2147483647
Year: 2001
Pages: 136

Flylib.com © 2008-2020.
If you may any questions please contact us: flylib@qtcs.net