NOM¶

SYNOPSIS¶

#include <semaphore.h>

int sem_wait(sem_t *sem);

int sem_trywait(sem_t *sem);

int sem_timedwait(sem_t *sem, const struct timespec *abs_timeout);

Effectuez l'édition des liens avec l'option -pthread.

Exigences de macros de test de fonctionnalités pour la glibc (consulter feature_test_macros(7)) :

sem_timedwait(): _POSIX_C_SOURCE >= 200112L

DESCRIPTION¶

sem_trywait() est pareil à sem_wait(), excepté que si la décrémentation ne peut pas être effectuée immédiatement, l'appel renvoie une erreur (errno vaut EAGAIN) plutôt que bloquer.

sem_timedwait() est pareil à sem_wait(), excepté que abs_timeout spécifie une limite sur le temps pendant lequel l'appel bloquera si la décrémentation ne peut pas être effectuée immédiatement. L'argument abs_timeout pointe sur une structure qui spécifie un temps absolu en secondes et nanosecondes depuis l'époque, 1er janvier 1970 à 00:00:00 (UTC). Cette structure est définie de la manière suivante :

struct timespec {
    time_t tv_sec;      /* Secondes */
    long   tv_nsec;     /* Nanosecondes [0 .. 999999999] */
};

Si le délai est déjà expiré à l'heure de l'appel et si le sémaphore ne peut pas être verrouillé immédiatement, sem_timedwait() échoue avec l'erreur d'expiration de délai (errno vaut ETIMEDOUT).

Si l'opération peut être effectuée immédiatement, sem_timedwait() n'échoue jamais avec une valeur d'expiration de délai, quelque soit la valeur de abs_timeout. De plus, la validité de abs_timeout n'est pas vérifiée dans ce cas.

VALEUR RENVOYÉE¶

ERREURS¶

EINTR

L'appel a été interrompu par un gestionnaire de signal ; consultez signal(7).

EINVAL

sem n'est pas un sémaphore valable.

L'erreur supplémentaire suivante peut survenir pour sem_trywait() :

EAGAIN

L'opération ne peut pas être effectuée sans bloquer (c'est-à-dire, le sémaphore a une valeur nulle).

Les erreurs supplémentaires suivantes peuvent survenir pour sem_timedwait() :

EINVAL

La valeur de abs_timeout.tv_nsecs est plus petite que 0 ou supérieure ou égale à 1 milliard.

ETIMEDOUT

Le délai a expiré avant que le sémaphore ait pu être verrouillé.

ATTRIBUTS¶

CONFORMITɶ

EXEMPLE¶

$ ./a.out 2 3
About to call sem_timedwait()
sem_post() from handler
sem_timedwait() succeeded
$ ./a.out 2 1
About to call sem_timedwait()
sem_timedwait() timed out

#include <unistd.h>
#include <stdio.h>
#include <stdlib.h>
#include <semaphore.h>
#include <time.h>
#include <assert.h>
#include <errno.h>
#include <signal.h>
sem_t sem;
#define handle_error(msg) \
    do { perror(msg); exit(EXIT_FAILURE); } while (0)
static void
handler(int sig)
{
    write(STDOUT_FILENO, "sem_post() from handler\n", 24);
    if (sem_post(&sem) == -1) {
        write(STDERR_FILENO, "sem_post() failed\n", 18);
        _exit(EXIT_FAILURE);
    }
}
int
main(int argc, char *argv[])
{
    struct sigaction sa;
    struct timespec ts;
    int s;
    if (argc != 3) {
        fprintf(stderr, "Usage: %s <alarm-secs> <wait-secs>\n",
                argv[0]);
        exit(EXIT_FAILURE);
    }
    if (sem_init(&sem, 0, 0) == -1)
        handle_error("sem_init");
    /* Establish SIGALRM handler; set alarm timer using argv[1] */
    sa.sa_handler = handler;
    sigemptyset(&sa.sa_mask);
    sa.sa_flags = 0;
    if (sigaction(SIGALRM, &sa, NULL) == -1)
        handle_error("sigaction");
    alarm(atoi(argv[1]));
    /* Calculate relative interval as current time plus
       number of seconds given argv[2] */
    if (clock_gettime(CLOCK_REALTIME, &ts) == -1)
        handle_error("clock_gettime");
    ts.tv_sec += atoi(argv[2]);
    printf("main() about to call sem_timedwait()\n");
    while ((s = sem_timedwait(&sem, &ts)) == -1 && errno == EINTR)
        continue;       /* Restart if interrupted by handler */
    /* Check what happened */
    if (s == -1) {
        if (errno == ETIMEDOUT)
            printf("sem_timedwait() timed out\n");
        else
            perror("sem_timedwait");
    } else
        printf("sem_timedwait() succeeded\n");
    exit((s == 0) ? EXIT_SUCCESS : EXIT_FAILURE);
}

VOIR AUSSI¶

COLOPHON¶

TRADUCTION¶

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à <debian-l10n-french@lists.debian.org>.