ИМЯ

       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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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