НАИМЕНОВАНИЕ

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

БИБЛИОТЕКА

       Стандартная библиотека языка C (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().

АТРИБУТЫ

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

СТАНДАРТЫ

       POSIX.1-2008.

ИСТОРИЯ

       glibc 2.2.4.  POSIX.1-2001.

ПРИМЕЧАНИЯ

       Если 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> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот перевод является свободной программной документацией; он распространяется на условиях  общедоступной
       лицензии  GNU  (GNU  General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите  об  этом
       разработчику(ам)   по   его(их)  адресу(ам)  электронной  почты  или  по  адресу  списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                    sockatmark(3)