ИМЯ

       sockatmark - определяет, есть ли в сокете отметка о внеполосных данных

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

       #include <sys/socket.h>

       int sockatmark(int sockfd);

   Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

       sockatmark():
           _POSIX_C_SOURCE >= 200112L

ОПИСАНИЕ

       Функция  sockatmark()  возвращает  значение,  показывающее присутствует ли в сокете, на который ссылается
       файловый дескриптор sockfd, отметка о внеполосных данных (out-of-band mark). Если сокет имеет отметку, то
       возвращается 1; если сокет не имеет отметки,  то  возвращается  0.  Эта  функция  не  удаляет  отметку  о
       внеполосных данных.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       При  успешном  выполнении  sockatmark() возвращает 1, если сокет имеет отметку о внеполосных данных, и 0,
       если нет. При ошибке возвращается -1, и в errno записывается номер ошибки.

ОШИБКИ

       EBADF  Значение sockfd не является правильным файловым дескриптором.

       EINVAL Значение sockfd является файловым дескриптором, к которому не применима функция sockatmark().

ВЕРСИИ

       sockatmark()  was added in glibc 2.2.4.

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).
       ┌─────────────────────────────────────────────────────────────────────┬──────────────────────┬──────────┐
       │ Интерфейс                                                           │ Атрибут              │ Значение │
       ├─────────────────────────────────────────────────────────────────────┼──────────────────────┼──────────┤
       │ sockatmark()                                                        │ Безвредность в нитях │ MT-Safe  │
       └─────────────────────────────────────────────────────────────────────┴──────────────────────┴──────────┘

СТАНДАРТЫ

       POSIX.1-2001, POSIX.1-2008.

ЗАМЕЧАНИЯ

       Если sockatmark() возвращает 1, то внеполосные данные можно прочитать используя флаг MSG_OOB в recv(2).

       Внеполосные данные поддерживаются только для некоторых потоковых сокетных протоколов.

       Функцию sockatmark() можно безопасно вызывать из обработчика сигнала SIGURG.

       Функция sockatmark() реализована с помощью ioctl(2) с операцией SIOCATMARK.

ДЕФЕКТЫ

       До glibc 2.4, sockatmark() не работала.

ПРИМЕРЫ

       Следующий код можно использовать после получения сигнала SIGURG для чтения (и удаления)  всех  данных  до
       отметки, и затем для чтения байта данных отметки:

           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");
                   ...
               }
           }

СМ. ТАКЖЕ

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

ПЕРЕВОД

       Русский  перевод  этой  страницы  руководства  был  сделан  Alexander Golubev <fatzer2@gmail.com>, Azamat
       Hackimov  <azamat.hackimov@gmail.com>,  Hotellook,   Nikita   <zxcvbnm3230@mail.ru>,   Spiros   Georgaras
       <sng@hellug.gr>,  Vladislav  <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов
       <pavia00@gmail.com>

       Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3
       или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное  письмо
       на man-pages-ru-talks@lists.sourceforge.net.

Linux man-pages 6.03                           15 декабря 2022 г.                                  sockatmark(3)