ИМЯ¶

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

LIBRARY¶

Standard C library (libc, -lc)

СИНТАКСИС¶

#include <sys/socket.h>

int sockatmark(int sockfd);

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).

СТАНДАРТЫ¶

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>

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

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