Linux
2017-09-15
man-pages-ru
Russian man pages from the Linux Documentation Project
manpages-dev
Manual pages about using GNU/Linux for development
man-pages
Linux kernel and C library user-space interface documentation
ИМЯ
sockatmark - определяет, есть ли в сокете отметка о внеполосных данных
ОБЗОР
#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() впервые появилась в 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;
char oobdata;
int atmark, s;
for (;;) {
atmark = sockatmark(sockfd);
if (atmark == -1) {
perror("sockatmark");
break;
}
atmark = sockatmark(sockfd);
if (atmark == -1) {
perror("sockatmark");
break;
}
if (atmark)
break;
break;
s = read(sockfd, buf, BUF_LEN);
if (s == -1)
perror("read");
if (s <= 0)
break;
}
if (s == -1)
perror("read");
if (s <= 0)
break;
}
if (atmark == 1) {
if (recv(sockfd, &oobdata, 1, MSG_OOB) == -1) {
perror("recv");
...
}
}
if (recv(sockfd, &oobdata, 1, MSG_OOB) == -1) {
perror("recv");
...
}
}
