.\" -*- coding: UTF-8 -*- .\" Copyright 1992, Drew Eckhardt .\" Copyright 1993, Ian Jackson .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH alarm 2 "8 fevereiro 2026" "Linux man\-pages 6.18" .SH NOME alarm \- define um alarme de relógio para envio de um sinal .SH BIBLIOTECA Biblioteca C Padrão (\fIlibc\fP,\ \fI\-lc\fP) .SH SINOPSE .nf \fB#include \fP .P \fBunsigned int alarm(unsigned int \fP\fIsegundos\fP\fB);\fP .fi .SH DESCRIÇÃO \fBalarm\fP() configura o envio de um sinal \fBSIGALRM\fP para o processo chamador em \fIsegundos\fP. .P Se \fIsegundos\fP é igual a zero, qualquer alarme pendente é cancelado. .P Em qualquer evento qualquer definição prévia de \fBalarm\fP() é cancelada. .SH "VALOR DE RETORNO" \fBalarm\fP() retorna o número de segundos restantes até que outro alarme agendado previamente seja convenientemente enviado ou zero se não houver nenhum alarme agendado previamente. .SH PADRÕES POSIX.1\-2024. .SH HISTÓRICO 4.3BSD, SVr4, POSIX.1\-1988. .SH NOTAS \fBalarm\fP() e \fBsetitimer\fP(2) compartilham o mesmo temporizador; chamadas para um deles irá interferir no uso do outro. .P Alarmes criados por \fBalarm\fP() são preservados pelo \fBexecve\fP(2) e não são herdados por filhos criados via \fBfork\fP(2). .P \fBsleep\fP(3) pode ser implementado usando \fBSIGALRM\fP; misturar as chamadas para \fBalarm\fP() e \fBsleep\fP(3) é uma má ideia. .P Atrasos do agendamento podem, às vezes, fazer com que a execução do processo seja retardada por uma quantidade de tempo arbitrária. .SH "VEJA TAMBÉM" \fBgettimeofday\fP(2), \fBpause\fP(2), \fBselect\fP(2), \fBsetitimer\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBtimer_create\fP(2), \fBtimerfd_create\fP(2), \fBsleep\fP(3), \fBtime\fP(7) .PP .SH TRADUÇÃO A tradução para português brasileiro desta página man foi criada por Marcelo D. Beckmann , Fábio Henrique F. Silva e Rafael Fontenelle . . .PP Esta tradução é uma documentação livre; leia a .UR https://www.gnu.org/licenses/gpl-3.0.html Licença Pública Geral GNU Versão 3 .UE ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita. .PP Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para .MT debian-l10n-portuguese@lists.debian.org a lista de discussão de tradutores .ME .