Man page - sockatmark(3)

Packages contains this manual

Available languages:

en fr ja ru ro

Manual

sockatmark

НАИМЕНОВАНИЕ
БИБЛИОТЕКА
ОБЗОР
ОПИСАНИЕ
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
ОШИБКИ
АТРИБУТЫ
СТАНДАРТЫ
ИСТОРИЯ
ПРИМЕЧАНИЯ
ОШИБКИ
ПРИМЕРЫ
СМОТРИТЕ ТАКЖЕ
ПЕРЕВОД

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

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

Image grohtml-606228-1.png

СТАНДАРТЫ

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 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

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