ИМЯ¶

netlink - макросы netlink

СИНТАКСИС¶

#include <asm/types.h>
#include <linux/netlink.h>

int NLMSG_ALIGN(size_t len);
int NLMSG_LENGTH(size_t len);
int NLMSG_SPACE(size_t len);
void *NLMSG_DATA(struct nlmsghdr *nlh);
struct nlmsghdr *NLMSG_NEXT(struct nlmsghdr *nlh, int len);
int NLMSG_OK(struct nlmsghdr *nlh, int len);
int NLMSG_PAYLOAD(struct nlmsghdr *nlh, int len);

ОПИСАНИЕ¶

В <linux/netlink.h> описаны различные стандартные макросы для доступа или создания дейтаграмм netlink. По сути, они подобны макросам, определённым в cmsg(3) для обычных данных. Работа с буфером, передаваемом или получаемом из сокета netlink, должна выполняться только с помощью этих макросов.

NLMSG_ALIGN()

Выравнивает длину сообщения netlink до корректного значения.

NLMSG_LENGTH()

Рассматривает длину полезной нагрузки len как аргумент и возвращает выравненную длину в поле nlmsg_len структуры nlmsghdr.

NLMSG_SPACE()

Возвращает количество байтов сообщения netlink с полезной нагрузкой длинной len.

NLMSG_DATA()

Возвращает указатель на полезную нагрузку, относящуюся к указанной структуре nlmsghdr.

NLMSG_NEXT()

Получает следующую структуру nlmsghdr в сообщении, состоящем из нескольких частей. При вызове необходимо убедиться, что в текущей структуре nlmsghdr не установлен флаг NLMSG_DONE — эта функция не возвращает NULL в конце. Параметр len — это величина lvalue, указывающая на оставшуюся длину буфера сообщения. Этот макрос уменьшает её на размер заголовка сообщения.

NLMSG_OK()

Возвращает значение «истина», если сообщение netlink не обрезано и готово к обработке.

NLMSG_PAYLOAD()

Возвращает длину полезной нагрузки, связанной с nlmsghdr.

СООТВЕТСТВИЕ СТАНДАРТАМ¶

Данные макросы являются нестандартными расширениями Linux.

ЗАМЕЧАНИЯ¶

В большинстве случаев лучше использовать netlink с помощью функций библиотеки libnetlink, а не через низкоуровневый интерфейс ядра.

СМ. ТАКЖЕ¶

libnetlink(3), netlink(7)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

Русский перевод этой страницы руководства был сделан Alex Nik <rage.iz.me@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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