NOM

       sockatmark - Déterminer si le socket a atteint la marque de données hors-bande

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <sys/socket.h>

       int sockatmark(int sockfd);

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

       sockatmark() :
           _POSIX_C_SOURCE >= 200112L

DESCRIPTION

       sockatmark() renvoie une valeur indiquant si oui ou non le socket référencé par le descripteur de fichier
       sockfd  a atteint une marque de données hors-bande. Si le socket a atteint la marque, la fonction renvoie
       1, sinon elle renvoie 0. Cette fonction ne supprime pas la marque de données hors-bande.

VALEUR RENVOYÉE

       Un appel réussit à sockatmark() renvoie 1 si le socket a atteint la marque de données  hors-bande,  ou  0
       dans le cas contraire. En cas d'erreur, elle renvoie -1 et errno est défini pour indiquer l'erreur.

ERREURS

       EBADF  sockfd n'est pas un descripteur de fichier valable.

       EINVAL sockfd n'est pas un descripteur de fichier sur lequel sockatmark() peut s'appliquer.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │ Interface                                                            │ Attribut             │ Valeur  │
       ├──────────────────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │ sockatmark()                                                         │ Sécurité des threads │ MT-Safe │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       POSIX.1-2008.

HISTORIQUE

       glibc 2.2.4. POSIX.1-2001.

NOTES

       Si  sockatmark()  renvoie  1, les données hors-bande peuvent être lues en utilisant l'attribut MSG_OOB de
       recv(2).

       Les données hors-bande ne sont gérées que par certains protocoles de socket de flux.

       sockatmark() peut être appelée de manière sûre par un gestionnaire pour le signal SIGURG.

       sockatmark() est implémentée en utilisant l'opération ioctl(2) SIOCATMARK.

BOGUES

       Avant la glibc 2.4, sockatmark() ne fonctionnait pas.

EXEMPLES

       Le code suivant peut être utilisé après la réception d'un signal SIGURG pour lire (et abandonner)  toutes
       les données jusqu'à la marque de données hors-bande, puis lit l'octet de donnée à la marque :

           char buf[BUF_LEN];
           char oobdata;
           int atmark, s;

           for (;;) {
               atmark = sockatmark(sockfd);
               if (atmark == -1) {
                   perror("sockatmark");
                   break;
               }

               if (atmark)
                   break;

               s = read(sockfd, buf, BUF_LEN);
               if (s == -1)
                   perror("read");
               if (s <= 0)
                   break;
           }

           if (atmark == 1) {
               if (recv(sockfd, &oobdata, 1, MSG_OOB) == -1) {
                   perror("recv");
                   ...
               }
           }

VOIR AUSSI

       fcntl(2), recv(2), send(2), tcp(7)

TRADUCTION

       La   traduction   française   de   cette   page   de   manuel   a   été   créée   par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>,   Stéphan   Rafin   <stephan.rafin@laposte.net>,   Thierry   Vignaud
       <tvignaud@mandriva.com>,  François  Micaux,  Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard
       <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-luc.coulon@wanadoo.fr>,   Julien   Cristau
       <jcristau@debian.org>,      Thomas      Huriaux      <thomas.huriaux@gmail.com>,     Nicolas     François
       <nicolas.francois@centraliens.net>,    Florentin    Duneau    <fduneau@gmail.com>,     Simon     Paillard
       <simon.paillard@resel.enst-bretagne.fr>,     Denis    Barbier    <barbier@debian.org>,    David    Prévot
       <david@tilapin.org>,    Cédric    Boutillier     <cedric.boutillier@gmail.com>,     Frédéric     Hantrais
       <fhantrais@gmail.com> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

       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.

Pages du manuel de Linux 6.9.1                     2 mai 2024                                      sockatmark(3)