[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1


pthread_attr_getschedparam Subroutine

Purpose

Returns the value of the schedparam attribute of a thread attributes object.

Library

Threads Library (libpthreads.a)

Syntax

#include <pthread.h>
#include <sys/sched.h>


int pthread_attr_getschedparam ( attr, schedparam)
const pthread_attr_t *attr;
struct sched_param *schedparam;

Description

The pthread_attr_getschedparam subroutine returns the value of the schedparam attribute of the thread attributes object attr. The schedparam attribute specifies the scheduling parameters of a thread created with this attributes object. The sched_priority field of the sched_param structure contains the priority of the thread. It is an integer value.

Note: The pthread.h header file must be the first included file of each source file using the threads library. Otherwise, the -D_THREAD_SAFE compilation flag should be used, or the cc_r compiler used. In this case, the flag is automatically set.

Parameters


attr Specifies the thread attributes object.
schedparam Points to where the schedparam attribute value will be stored.

Return Values

Upon successful completion, the value of the schedparam attribute is returned via the schedparam parameter, and 0 is returned. Otherwise, an error code is returned.

Error Codes

The pthread_attr_getschedparam subroutine is unsuccessful if the following is true:

EINVAL The attr parameter is not valid.

This function does not return EINTR.

Implementation Specifics

This subroutine is part of the Base Operating System (BOS) Runtime.

Related Information

The pthread_attr_setschedparam (pthread_attr_setschedparam Subroutine) subroutine, pthread_attr_init (pthread_attr_init Subroutine) subroutine, pthread_getschedparam (pthread_getschedparam Subroutine) subroutine, the pthread.h file.

Threads Scheduling in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

Threads Library Options and Threads Library Quick Reference in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]