table of contents
- bookworm 4.18.1-1
- bookworm-backports 4.24.0-2~bpo12+1
- testing 4.24.0-2
- unstable 4.24.0-2
netlink(3) | Library Functions Manual | netlink(3) |
ИМЯ¶
netlink - макросы netlink
БИБЛИОТЕКА¶
Стандартная библиотека языка C (libc, -lc)
СИНТАКСИС¶
#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()
- Get the next nlmsghdr in a multipart message. The caller must check if the current nlmsghdr didn't have the NLMSG_DONE set—this function doesn't return NULL on end. The len argument is an lvalue containing the remaining length of the message buffer. This macro decrements it by the length of the message header.
- NLMSG_OK()
- Возвращает значение «истина», если сообщение netlink не обрезано и готово к обработке.
- NLMSG_PAYLOAD()
- Возвращает длину полезной нагрузки, связанной с nlmsghdr.
СТАНДАРТЫ¶
Данные макросы являются нестандартными расширениями Linux.
ПРИМЕЧАНИЯ¶
В большинстве случаев лучше использовать netlink с помощью функций библиотеки libnetlink, а не через низкоуровневый интерфейс ядра.
СМОТРИТЕ ТАКЖЕ¶
ПЕРЕВОД¶
Русский перевод этой страницы руководства разработал(и) 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 (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.
5 февраля 2023 г. | Справочные страницы Linux 6.03 |