sockatmark(3)              Library Functions Manual              sockatmark(3)

NOM
       sockatmark - Determiner si le socket a atteint la marque de donnees
       hors-bande

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <sys/socket.h>

       int sockatmark(int sockfd);

   Exigences de macros de test de fonctionnalites 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
       reference par le descripteur de fichier sockfd a atteint une marque de
       donnees 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 donnees hors-bande.

VALEUR RENVOYEE
       Un appel reussit a sockatmark() renvoie 1 si le socket a atteint la
       marque de donnees hors-bande, ou 0 dans le cas contraire. En cas
       d'erreur, elle renvoie -1 et errno est defini 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 utilises dans cette section, consulter
       attributes(7).

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |sockatmark()                     | Securite des threads     | MT-Safe |
       +---------------------------------+--------------------------+---------+
STANDARDS
       POSIX.1-2008.

HISTORIQUE
       glibc 2.2.4.  POSIX.1-2001.

NOTES
       Si sockatmark() renvoie 1, les donnees hors-bande peuvent etre lues en
       utilisant l'attribut MSG_OOB de recv(2).

       Les donnees hors-bande ne sont gerees que par certains protocoles de
       socket de flux.

       sockatmark() peut etre appelee de maniere sure par un gestionnaire pour
       le signal SIGURG.

       sockatmark() est implementee en utilisant l'operation ioctl(2)
       SIOCATMARK.

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

EXEMPLES
       Le code suivant peut etre utilise apres la reception d'un signal SIGURG
       pour lire (et abandonner) toutes les donnees jusqu'a la marque de
       donnees hors-bande, puis lit l'octet de donnee a 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 francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org>, Cedric Boutillier <cedric.boutillier@gmail.com> et
       Frederic Hantrais <fhantrais@gmail.com>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

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

Pages du manuel de Linux 6.06   31 octobre 2023                  sockatmark(3)