pthread_getplanejparam Subroutine

Propósito

Retorna o cronograma atual e os atributos de agendamento de um encadeamento.

Biblioteca

Biblioteca de encadeamentos (libpthreads.a)

Sintaxe

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

int pthread_getschedparam ( thread,  schedpolicy,  schedparam)
pthread_t thread;
int *schedpolicy;
struct sched_param *schedparam;

Descrição

A sub-rotina pthread_getschedparam retorna os atributos schedpolicy e schedparam atuais do encadeamento thread. O atributo agendamento especifica a política de agendamento de um encadeamento. Pode ter um dos seguintes valores:

Tabela 1. Planejando valores de política
Item	Descrição
`SCHED_FIFO`	Denota primeiro-em agendamento de primeiro lugar.
`SCHED_RR`	Denota o agendamento do round-robin.
`SCHED_OTHER`	Denota a política de planejamento do sistema operacional padrão. É o valor padrão.

O atributo schedparam especifica os parâmetros de planejamento de um encadeamento criado com esse objeto de atributo. O campo sched_priority da estrutura sched_param contém a prioridade do encadeamento.. É um valor inteiro.

Nota: o arquivo de cabeçalho pthread.h deve ser o primeiro arquivo incluído de cada arquivo de origem usando a biblioteca de encadeamentos. Caso contrário, a sinalização de compilação -D_THREAD_SAFE deverá ser usada ou o compilador cc_r usado. Neste caso, a sinalização é automaticamente definida.

A implementação dessa sub-rotina depende da opção POSIX de planejamento de prioridades A opção de agendamento de prioridade POSIX é implementada no sistema operacional.

Parâmetros

Tabela 2.. Parâmetros
Item	Descrição
thread	Especifica o encadeamento de destino.
schedpolicy	Pontos para onde o valor do atributo de agendamento será armazenado.
schedparam	Pontos para onde o valor do atributo programparam será armazenado.

Valores De Retorno

Após a conclusão bem-sucedida, o valor atual dos atributos de agendamento e agendamento são retornados através dos parâmetros agendamento e programparam e 0 são retornados. Caso contrário, um código de erro é retornado.

Códigos De Erro

A sub-rotina pthread_getschedparam será malsucedida se o seguinte for verdadeiro:

Tabela 3.. Códigos de Erro
Item	Descrição
`ESRCH`	A thread `thread` não existe.