1 .\" This manpage copyright 1998 by Andi Kleen.
3 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
4 .\" Subject to the GPL.
7 .\" Based on the original comments from Alexey Kuznetsov
8 .\" $Id: netlink.3,v 1.1 1999/05/14 17:17:24 freitag Exp $
10 .\"*******************************************************************
12 .\" This file was generated with po4a. Translate the source file.
14 .\"*******************************************************************
16 .\" Japanese Version Copyright (c) 1999 Shouichi Saito
17 .\" all rights reserved.
18 .\" Translated Mon Jul 26 12:18:39 JST 1999
19 .\" by Shouichi Saito <ss236rx@ymg.urban.ne.jp>
20 .\" Proofed Fri Aug 20 1999 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
22 .TH NETLINK 3 2012\-08\-05 GNU "Linux Programmer's Manual"
24 netlink \- netlink マクロ
27 .\" FIXME . what will glibc 2.1 use here?
28 .\" May 2007: glibc 2.5, things look to be unchanged -- the header file
29 .\" is still linux/netlink.h -- mtk
30 \fB#include <asm/types.h>\fP
32 \fB#include <linux/netlink.h>\fP
34 \fBint NLMSG_ALIGN(size_t \fP\fIlen\fP\fB);\fP
36 \fBint NLMSG_LENGTH(size_t \fP\fIlen\fP\fB);\fP
38 \fBint NLMSG_SPACE(size_t \fP\fIlen\fP\fB);\fP
40 \fBvoid *NLMSG_DATA(struct nlmsghdr *\fP\fInlh\fP\fB);\fP
42 \fBstruct nlmsghdr *NLMSG_NEXT(struct nlmsghdr *\fP\fInlh\fP\fB, int \fP\fIlen\fP\fB);\fP
44 \fBint NLMSG_OK(struct nlmsghdr *\fP\fInlh\fP\fB, int \fP\fIlen\fP\fB);\fP
46 \fBint NLMSG_PAYLOAD(struct nlmsghdr *\fP\fInlh\fP\fB, int \fP\fIlen\fP\fB);\fP
49 \fI<linux/netlink.h>\fP では、 netlink データグラムにアクセスしたり、これを作成するための
50 標準マクロがいくつか定義されている。 これらは \fBcmsg\fP(3) で定義されている補助データ (auxiliary data) 用のマクロと、
51 その精神において似ているものである。 netlink ソケットに対してやりとりされるバッファには、 必ずこれらのマクロだけを使ってアクセスすべきである。
54 netlink メッセージの長さを丸めて正しく揃える。
57 格納領域 (payload) の長さ \fIlen\fP を引数にとり、 \fInlmsghdr\fP の \fInlmsg_len\fP フィールドに代入できる
58 揃えられた長さ (aligned length) を返す。
61 ペイロードの長さが \fIlen\fP の netlink メッセージのバイト数を返す。
64 与えた \fInlmsghdr\fP に関連づけられた格納領域へのポインタを返す。
66 .\" this is bizarre, maybe the interface should be fixed.
68 マルチパートメッセージにおいて、次の \fInlmsghdr\fP を入手する。これを呼び出すときには、 現在の nlmsghdr で NLMSG_DONE
69 がセットされていないことを 確認しなければならない。この関数は終端で NULL を返さないからである。 \fIlen\fP
70 引数はメッセージバッファの残り長さが入った左辺値である。 このマクロはこの引数からメッセージヘッダの長さ分を差し引く。
73 Netlink メッセージが途切れておらず、かつ解釈可能な形の場合であれば真を返す。
76 \fInlmsghdr\fP に関連づけられた格納領域の長さを返す。
78 これらのマクロは非標準で、Linux での拡張である。
80 通常はカーネルの低レベルインターフェイスよりも、 \fIlibnetlink\fP 経由で netlink を用いるほうが良い。
85 .UR ftp://ftp.inr.ac.ru\:/ip\-routing\:/iproute2*
88 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
89 である。プロジェクトの説明とバグ報告に関する情報は
90 http://www.kernel.org/doc/man\-pages/ に書かれている。