RTNETLINK

Section: Linux Programmer's Manual (3)
Updated: 2020-11-01
Index JM Home Page
 

名前

rtnetlink - rtnetlink メッセージを操作するマクロ  

書式

#include <asm/types.h>
#include <linux/netlink.h>
#include <linux/rtnetlink.h>
#include <sys/socket.h>

rtnetlink_socket = socket(AF_NETLINK, int socket_type, NETLINK_ROUTE);

int RTA_OK(struct rtattr *rta, int rtabuflen);

void *RTA_DATA(struct rtattr *rta);

unsigned int RTA_PAYLOAD(struct rtattr *rta);

struct rtattr *RTA_NEXT(struct rtattr *rta, unsigned int rtabuflen);

unsigned int RTA_LENGTH(unsigned int length);

unsigned int RTA_SPACE(unsigned int length);  

説明

全ての rtnetlink(7) メッセージは netlink(7) メッセージヘッダーと追加属性からなる。 属性の操作は、必ずここに挙げたマクロだけを使って行うべきである。

RTA_OK(rta, attrlen)rta が有効なルーティング属性へのポインターであれば真を返す。 attrlen は属性バッファーの実働時の長さ (running length) である。 真でなければ、例え attrlen がゼロでなくても、 メッセージ中にはもうそれ以上属性は無いと考えなければならない。

RTA_DATA(rta) はこの属性データの先頭へのポインターを返す。

RTA_PAYLOAD(rta) はこの属性データの長さを返す。

RTA_NEXT(rta, attrlen)rta の次にある属性を取得する。 このマクロを呼ぶと attrlen が更新される。 RTA_OK を使って、返されたポインターが正しいかをチェックすべきである。

RTA_LENGTH(len)len バイトのデータ + ヘッダーに必要な長さを返す。

RTA_SPACE(len)len バイトのデータを持つメッセージに必要とされる容量を返す。  

準拠

これらのマクロは非標準で、Linux での拡張である。  

バグ

このマニュアルは完全ではない。  

デバイスの MTU をセットする rtnetlink メッセージを生成する

#include <linux/rtnetlink.h>

...

struct {
    struct nlmsghdr  nh;
    struct ifinfomsg if;
    char             attrbuf[512]; } req;

struct rtattr *rta; unsigned int mtu = 1000;

int rtnetlink_sk = socket(AF_NETLINK, SOCK_DGRAM, NETLINK_ROUTE);

memset(&req, 0, sizeof(req)); req.nh.nlmsg_len = NLMSG_LENGTH(sizeof(req.if)); req.nh.nlmsg_flags = NLM_F_REQUEST; req.nh.nlmsg_type = RTM_NEWLINK; req.if.ifi_family = AF_UNSPEC; req.if.ifi_index = INTERFACE_INDEX; req.if.ifi_change = 0xffffffff; /* ??? */ rta = (struct rtattr *)(((char *) &req) +
                         NLMSG_ALIGN(req.nh.nlmsg_len)); rta->rta_type = IFLA_MTU; rta->rta_len = RTA_LENGTH(sizeof(mtu)); req.nh.nlmsg_len = NLMSG_ALIGN(req.nh.nlmsg_len) +
                              RTA_LENGTH(sizeof(mtu)); memcpy(RTA_DATA(rta), &mtu, sizeof(mtu)); send(rtnetlink_sk, &req, req.nh.nlmsg_len, 0);  

関連項目

netlink(3), netlink(7), rtnetlink(7)  

この文書について

この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。

関連キーワード

int, rtnetlink, struct, 属性, nlmsg, unsigned, rtattr, RTNETLINK, attrlen, LENGTH

Linux マニュアル 一覧

[man1] [man2] [man3] [man4] [man5] [man6] [man7] [man8]
[a] [b] [c] [d] [e] [f] [g] [h] [i] [j] [k] [l] [m] [n] [o] [p] [q] [r] [s] [t] [u] [v] [w] [x] [y] [z]

 

Index

名前
書式
説明
準拠
バグ
関連項目
この文書について

This document was created by man2html, using the manual pages.
Time: 12:08:44 GMT, June 11, 2022