subrotina pthread_kill
Propósito
Envia um sinal para o fio especificado.
Biblioteca
Biblioteca de encadeamentos (libpthreads.a)
Sintaxe
#include <signal.h>
int pthread_kill (thread, signal)
pthread_t thread;
int signal;Descrição
A subroutine pthread_kill envia o sinal sinal para a thread thread. Ele atua com threads como a subroutina kill com processos de roscada único.
Se a thread de recebimento tiver bloqueado a entrega do sinal, o sinal permanece pendente na thread até que o encadeamento desbloqueie a entrega do sinal ou a ação associada ao sinal seja definida para ignorar o sinal.
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, deve ser usada a sinalização de compilação -D_THREAD_SAFE , ou o compilador cc_r utilizado. Neste caso, a sinalização é automaticamente definida.
Parâmetros
| Item | Descrição |
|---|---|
| Encadeamento | Especifica o encadeamento de destino para o sinal. |
| sinal | Especifica o sinal a ser entregue. Se o valor do sinal for 0, a verificação de erros é realizada, mas nenhum sinal é entregue. |
Valores De Retorno
Após a conclusão bem-sucedida, a função retorna um valor de zero. Caso contrário a função retorna um número de erro. Se a função pthread_kill falhar, nenhum sinal é enviado.
Códigos De Erro
A função pthread_kill falhará se:
| Item | Descrição |
|---|---|
| ESRCH | Nenhum fio poderia ser encontrado correspondente ao especificado pelo ID de thread fornecido. |
| EINVAL | O valor do parâmetro signal é um número de sinal inválido ou não suportado. |
A função pthread_kill não retornará um código de erro de EINTR.