OSDN Git Service

(split) LDP: Release pages for LDP v3.39.
[linuxjm/LDP_man-pages.git] / release / man7 / rtnetlink.7
index 5c62417..a17bb2b 100644 (file)
@@ -1,4 +1,4 @@
-'\" t
+.\" t
 .\" Don't remove the line above, it tells man that tbl is needed.
 .\" This man page is Copyright (C) 1999 Andi Kleen <ak@muc.de>.
 .\" Permission is granted to distribute possibly modified copies
@@ -7,47 +7,35 @@
 .\" of the modification is added to the header.
 .\" Based on the original comments from Alexey Kuznetsov, written with
 .\" help from Matthew Wilcox.
-.\" $Id: rtnetlink.7,v 1.10 2001/04/04 08:02:19 ysato Exp $
+.\" $Id: rtnetlink.7,v 1.8 2000/01/22 01:55:04 freitag Exp $
+.\"*******************************************************************
 .\"
-.\" Japanese Version Copyright (c) 1999 NAKANO Takeo all rights reserved.
-.\" Translated Mon 6 Dec 1999 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.\"WORD         queueing dicipline      キューイング(の)ルール
-.\"WORD         permanent               永続的な
-.\"WORD         neighbor                近傍
-.\"
-.TH RTNETLINK  7 2008-08-08 "Linux" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH RTNETLINK 7 2008\-08\-08 Linux "Linux Programmer's Manual"
 .SH 名前
 rtnetlink, NETLINK_ROUTE \- Linux IPv4 ルーティングソケット
 .SH 書式
-.B #include <asm/types.h>
+\fB#include <asm/types.h>\fP
 .br
-.B #include <linux/netlink.h>
+\fB#include <linux/netlink.h>\fP
 .br
-.B #include <linux/rtnetlink.h>
+\fB#include <linux/rtnetlink.h>\fP
 .br
-.B #include <sys/socket.h>
+\fB#include <sys/socket.h>\fP
 .sp
-.BI "rtnetlink_socket = socket(AF_NETLINK, int " socket_type ", NETLINK_ROUTE);"
+\fBrtnetlink_socket = socket(AF_NETLINK, int \fP\fIsocket_type\fP\fB,
+NETLINK_ROUTE);\fP
 .SH 説明
-.B rtnetlink
-はカーネルのルーティングテーブルを読んだり変更したり
-するためのものである。これはカーネルが内部のサブシステムと
-通信するためにも用いられているが、それはここでは記述しない。
-この man ページではユーザー空間のプログラムとの通信に関してのみ述べる。
-ネットワーク経路・IP アドレス・リンクパラメータ・
-近傍設定 (neighbor setup)・キューイングルール (queueing dicipline)・
-トラフィッククラス・パケットのクラス分類などが、すべて
-.B NETLINK_ROUTE
-ソケットを通して制御できる。
-.B rtnetlink
-は netlink メッセージをベースにしている。詳細は
-.BR netlink (7)
-を見ること。
 .\" FIXME ? all these macros could be moved to rtnetlink(3)
+\fBrtnetlink\fP はカーネルのルーティングテーブルを読んだり変更したり するためのものである。これはカーネルが内部のサブシステムと
+通信するためにも用いられているが、それはここでは記述しない。 この man ページではユーザー空間のプログラムとの通信に関してのみ述べる。
+ネットワーク経路・IP アドレス・リンクパラメータ・ 近傍設定 (neighbor setup)・キューイングルール (queueing
+dicipline)・ トラフィッククラス・パケットのクラス分類などが、すべて \fBNETLINK_ROUTE\fP ソケットを通して制御できる。
+\fBrtnetlink\fP は netlink メッセージをベースにしている。詳細は \fBnetlink\fP(7)  を見ること。
 .SS ルーティング属性
-rtnetlink メッセージには、初期ヘッダの後に付加的な属性を
-持つものがある。
+rtnetlink メッセージには、初期ヘッダの後に付加的な属性を 持つものがある。
 
 .in +4n
 .nf
@@ -59,21 +47,13 @@ struct rtattr {
 .fi
 .in
 
-これらの属性の操作は、 RTA_* マクロか libnetlink を通してのみ
-行うべきである。
-.BR rtnetlink (3)
-を見よ。
+これらの属性の操作は、 RTA_* マクロか libnetlink を通してのみ 行うべきである。 \fBrtnetlink\fP(3)  を見よ。
 .SS メッセージ
-rtnetlink は (標準的な netlink メッセージに加えて)
-以下のメッセージタイプから構成される。
-.TP
-.BR RTM_NEWLINK ", " RTM_DELLINK ", " RTM_GETLINK
-指定したネットワークインターフェースの情報を、生成・削除・取得する。
-これらのメッセージは
-.I ifinfomsg
-構造体と、それに続いていくつかの
-.I rtattr
-構造体を伴う。
+rtnetlink は (標準的な netlink メッセージに加えて)  以下のメッセージタイプから構成される。
+.TP 
+\fBRTM_NEWLINK\fP, \fBRTM_DELLINK\fP, \fBRTM_GETLINK\fP
+指定したネットワークインターフェースの情報を、生成・削除・取得する。 これらのメッセージは \fIifinfomsg\fP 構造体と、それに続いていくつかの
+\fIrtattr\fP 構造体を伴う。
 
 .nf
 struct ifinfomsg {
@@ -86,15 +66,9 @@ struct ifinfomsg {
 .fi
 
 .\" FIXME ifi_type
-.I ifi_flags
-はデバイスのフラグである。
-.BR netdevice (7)
-を見よ。
-.I ifi_index
-は他と重ならないインターフェースの index である。
-.I ifi_change
-は将来の利用のために予約されており、常に
-0xFFFFFFFF にセットすべきである。
+\fIifi_flags\fP はデバイスのフラグである。 \fBnetdevice\fP(7)  を見よ。 \fIifi_index\fP
+は他と重ならないインターフェースの index である。 \fIifi_change\fP は将来の利用のために予約されており、常に 0xFFFFFFFF
+にセットすべきである。
 .TS
 tab(:);
 c
@@ -102,13 +76,9 @@ l l l.
 ルーティング属性
 rta_type:値の型:説明
 _
-IFLA_UNSPEC:-:指定されていない。
-IFLA_ADDRESS:hardware address:T{
-インターフェース L2 アドレス
-T}
-IFLA_BROADCAST:hardware address:T{
-L2 ブロードキャストアドレス
-T}
+IFLA_UNSPEC:\-:指定されていない。
+IFLA_ADDRESS:hardware address:インターフェース L2 アドレス
+IFLA_BROADCAST:hardware address:L2 ブロードキャストアドレス
 IFLA_IFNAME:asciiz string:デバイス名
 IFLA_MTU:unsigned int:デバイスの MTU
 IFLA_LINK:int:リンクタイプ
@@ -119,17 +89,11 @@ T}:インターフェースの統計
 .TE
 .sp
 IFLA_STATS の値の型は \fIstruct net_device_stats\fP である。
-.TP
-.BR RTM_NEWADDR ", " RTM_DELADDR ", " RTM_GETADDR
-インターフェースの IP アドレスの情報を追加・削除・取得する。
-Linux 2.2 では、一つのインターフェースに複数の IP アドレスを
-保持させることができ、これは 2.0 の別名デバイスの概念を置き換える。
-Linux 2.2 では、これらのメッセージは
-IPv4 と IPv6 の両方のアドレスをサポートしている。
-これらは
-.I ifaddrmsg
-構造体を伴う。そのあとに
-.I rtattr
+.TP 
+\fBRTM_NEWADDR\fP, \fBRTM_DELADDR\fP, \fBRTM_GETADDR\fP
+インターフェースの IP アドレスの情報を追加・削除・取得する。 Linux 2.2 では、一つのインターフェースに複数の IP アドレスを
+保持させることができ、これは 2.0 の別名デバイスの概念を置き換える。 Linux 2.2 では、これらのメッセージは IPv4 と IPv6
+の両方のアドレスをサポートしている。 これらは \fIifaddrmsg\fP 構造体を伴う。そのあとに \fIrtattr\fP
 ルーティング属性が続くこともある。
 
 .nf
@@ -142,26 +106,12 @@ struct ifaddrmsg {
 };
 .fi
 
-.I ifa_family
-はアドレスファミリーのタイプである (現在は
-.B AF_INET
-または
-.BR AF_INET6 )。
-.I ifa_prefixlen
-はアドレスのアドレスマスクの長さである (IPv4 のように、
-そのファミリーで定義されている場合)。
-.I ifa_scope
-はアドレスのスコープである。
-.I ifa_index
-はアドレスが関連づけられているインターフェースの index である。
-.I ifa_flags
-はフラグワードで、
-二つめのアドレス (古い別名インターフェース) の場合は
-.B IFA_F_SECONDARY
-に、永続的なアドレスの場合は
-.B IFA_F_PERMANENT
-に適用される。ユーザーによってセットされるフラグと、
-undocumented なフラグがある。
+\fIifa_family\fP はアドレスファミリーのタイプである (現在は \fBAF_INET\fP または \fBAF_INET6\fP)。
+\fIifa_prefixlen\fP はアドレスのアドレスマスクの長さである (IPv4 のように、 そのファミリーで定義されている場合)。
+\fIifa_scope\fP はアドレスのスコープである。 \fIifa_index\fP はアドレスが関連づけられているインターフェースの index である。
+\fIifa_flags\fP はフラグワードで、 二つめのアドレス (古い別名インターフェース) の場合は \fBIFA_F_SECONDARY\fP
+に、永続的なアドレスの場合は \fBIFA_F_PERMANENT\fP に適用される。ユーザーによってセットされるフラグと、 undocumented
+なフラグがある。
 .TS
 tab(:);
 c
@@ -169,7 +119,7 @@ l l l.
 属性
 rta_type:値の型:説明
 _
-IFA_UNSPEC:-:指定されていない
+IFA_UNSPEC:\-:指定されていない
 IFA_ADDRESS:raw protocol address:インターフェースアドレス
 IFA_LOCAL:raw protocol address:ローカルアドレス
 IFA_LABEL:asciiz string:インターフェースの名前
@@ -178,24 +128,11 @@ IFA_ANYCAST:raw protocol address:anycast アドレス
 IFA_CACHEINFO:struct ifa_cacheinfo:アドレス情報
 .TE
 .\" FIXME struct ifa_cacheinfo
-.TP
-.BR RTM_NEWROUTE ", " RTM_DELROUTE ", " RTM_GETROUTE
-ネットワーク経路の情報を生成・削除・取得する。
-これらのメッセージは
-.I rtmsg
-構造体を伴う。そのあとにいくつかの
-.I rtattr
-構造体を続けることもできる。
-.B RTM_GETROUTE
-で
-.I rtm_dst_len
-と
-.I rtm_src_len
-に 0 をセットすると、
-指定されたルーティングテーブルの全てのエントリを所得する。
-.I rtm_table
-と
-.I rtm_protocol
+.TP 
+\fBRTM_NEWROUTE\fP, \fBRTM_DELROUTE\fP, \fBRTM_GETROUTE\fP
+ネットワーク経路の情報を生成・削除・取得する。 これらのメッセージは \fIrtmsg\fP 構造体を伴う。そのあとにいくつかの \fIrtattr\fP
+構造体を続けることもできる。 \fBRTM_GETROUTE\fP で \fIrtm_dst_len\fP と \fIrtm_src_len\fP に 0
+をセットすると、 指定されたルーティングテーブルの全てのエントリを所得する。 \fIrtm_table\fP と \fIrtm_protocol\fP
 以外の他のフィールドに 0 を入れると、ワイルドカードを意味する。
 
 .nf
@@ -222,12 +159,10 @@ RTN_UNSPEC:未知の経路
 RTN_UNICAST:ゲートウェイまたはダイレクトな経路
 RTN_LOCAL:ローカルインターフェースの経路
 RTN_BROADCAST:T{
-ローカルなブロードキャスト経路
-(ブロードキャストとして送信される)
+ローカルなブロードキャスト経路 (ブロードキャストとして送信される)
 T}
 RTN_ANYCAST:T{
-ローカルなブロードキャスト経路
-(ユニキャストとして送信される)
+ローカルなブロードキャスト経路 (ユニキャストとして送信される)
 T}
 RTN_MULTICAST:マルチキャスト経路
 RTN_BLACKHOLE:パケットを捨てる経路
@@ -253,18 +188,11 @@ RTPROT_BOOT:ブート時
 RTPROT_STATIC:管理者による
 .TE
 
-.B RTPROT_STATIC
-よりも大きな値はカーネルによって解釈されない。これは
-単なるユーザーへの情報である。これらは経路情報の情報源を
-タグ付けしたり、複数のルーティングデーモンからの情報を
-区別するために用いることができる。
-既に割り当てられているルーティングデーモンの識別子については
-.I <linux/rtnetlink.h>
-を見よ。
-
-.I rtm_scope
-は行き先への距離である。
+\fBRTPROT_STATIC\fP よりも大きな値はカーネルによって解釈されない。これは 単なるユーザーへの情報である。これらは経路情報の情報源を
+タグ付けしたり、複数のルーティングデーモンからの情報を 区別するために用いることができる。 既に割り当てられているルーティングデーモンの識別子については
+\fI<linux/rtnetlink.h>\fP を見よ。
 
+\fIrtm_scope\fP は行き先への距離である。
 .TS
 tab(:);
 l l.
@@ -277,14 +205,9 @@ RT_SCOPE_HOST:ローカルホスト上の経路
 RT_SCOPE_NOWHERE:行き先が存在しない
 .TE
 
-ユーザーは
-.B RT_SCOPE_UNIVERSE
-と
-.B RT_SCOPE_SITE
-の間の値を用いることができる。
+ユーザーは \fBRT_SCOPE_UNIVERSE\fP と \fBRT_SCOPE_SITE\fP の間の値を用いることができる。
 
-.I rtm_flags
-は以下の意味を持つ:
+\fIrtm_flags\fP は以下の意味を持つ:
 .TS
 tab(:);
 l l.
@@ -295,8 +218,7 @@ RTM_F_CLONED:経路は他の経路によって複製された。
 RTM_F_EQUALIZE:マルチパスイコライザ (まだ実装されていない)
 .TE
 
-.I rtm_table
-ではルーティングテーブルを指定する。
+\fIrtm_table\fP ではルーティングテーブルを指定する。
 .TS
 tab(:);
 l l.
@@ -306,11 +228,7 @@ RT_TABLE_MAIN:メインのテーブル
 RT_TABLE_LOCAL:ローカルテーブル
 .TE
 
-ユーザーは
-.B RT_TABLE_UNSPEC
-と
-.BR RT_TABLE_DEFAULT .
-の間の任意の値を用いることができる。
+ユーザーは \fBRT_TABLE_UNSPEC\fP と \fBRT_TABLE_DEFAULT\fP.  の間の任意の値を用いることができる。
 .TS
 tab(:);
 c
@@ -318,7 +236,7 @@ l l l.
 属性
 rta_type:値の型:説明
 _
-RTA_UNSPEC:-:無視される
+RTA_UNSPEC:\-:無視される
 RTA_DST:protocol address:経路の行き先アドレス
 RTA_SRC:protocol address:経路の発信元アドレス
 RTA_IIF:int:入力インターフェースの index
@@ -333,14 +251,11 @@ RTA_FLOW::
 RTA_CACHEINFO::
 .TE
 
-.B (これらの値を埋めること!)
-.TP
-.BR RTM_NEWNEIGH ", " RTM_DELNEIGH  ", " RTM_GETNEIGH
-近傍テーブル (neighbor table) のエントリ
-(例えば ARP エントリ) の情報を追加・削除・取得する。
-このメッセージは
-.I ndmsg
-構造体を伴う。
+\fB(これらの値を埋めること!)\fP
+.TP 
+\fBRTM_NEWNEIGH\fP, \fBRTM_DELNEIGH\fP, \fBRTM_GETNEIGH\fP
+近傍テーブル (neighbor table) のエントリ (例えば ARP エントリ) の情報を追加・削除・取得する。 このメッセージは
+\fIndmsg\fP 構造体を伴う。
 
 .nf
 struct ndmsg {
@@ -359,8 +274,7 @@ struct nda_cacheinfo {
 };
 .fi
 
-.I ndm_state
-は以下の状態のビットマスクである:
+\fIndm_state\fP は以下の状態のビットマスクである:
 .TS
 tab(:);
 l l.
@@ -374,9 +288,7 @@ NUD_NOARP:行き先キャッシュのないデバイス
 NUD_PERMANENT:静的なエントリ
 .TE
 
-有効な
-.I ndm_flags
-は以下の通り:
+有効な \fIndm_flags\fP は以下の通り:
 .TS
 tab(:);
 l l.
@@ -386,10 +298,7 @@ NTF_ROUTER:IPv6 ルータ
 
 .\" FIXME
 .\" document the members of the struct better
-.I rtattr
-構造体は、
-.I rta_type
-フィールドに応じてそれぞれ以下の意味を持つ:
+\fIrtattr\fP 構造体は、 \fIrta_type\fP フィールドに応じてそれぞれ以下の意味を持つ:
 .TS
 tab(:);
 l l.
@@ -399,23 +308,13 @@ NDA_LLADDR:近傍キャッシュリンク層のアドレス
 NDA_CACHEINFO:キャッシュの統計
 .TE
 
-.I rta_type
-フィールドが
-.B NDA_CACHEINFO
-の場合には、
-.I struct nda_cacheinfo
-ヘッダが続く。
-.TP
-.BR RTM_NEWRULE ", " RTM_DELRULE ", " RTM_GETRULE
-ルーティングルールを追加・削除・取得する。
-.I struct rtmsg
-を伴う。
-.TP
-.BR RTM_NEWQDISC ", " RTM_DELQDISC ", " RTM_GETQDISC
-キューイングルールを追加・削除・取得する。
-このメッセージは
-.I struct tcmsg
-を伴い、またそのあとに属性がいくつか続くこともある。
+\fIrta_type\fP フィールドが \fBNDA_CACHEINFO\fP の場合には、 \fIstruct nda_cacheinfo\fP ヘッダが続く。
+.TP 
+\fBRTM_NEWRULE\fP, \fBRTM_DELRULE\fP, \fBRTM_GETRULE\fP
+ルーティングルールを追加・削除・取得する。 \fIstruct rtmsg\fP を伴う。
+.TP 
+\fBRTM_NEWQDISC\fP, \fBRTM_DELQDISC\fP, \fBRTM_GETQDISC\fP
+キューイングルールを追加・削除・取得する。 このメッセージは \fIstruct tcmsg\fP を伴い、またそのあとに属性がいくつか続くこともある。
 
 .nf
 struct tcmsg {
@@ -433,7 +332,7 @@ l l l.
 属性
 rta_type:値の型:説明
 _
-TCA_UNSPEC:-:指定されていない
+TCA_UNSPEC:\-:指定されていない
 TCA_KIND:asciiz string:キューイングルールの名前
 TCA_OPTIONS:byte sequence:Qdisc 特有のオプションが続く
 TCA_STATS:struct tc_stats:Qdisc の統計
@@ -441,27 +340,16 @@ TCA_XSTATS:qdisc specific:モジュール特有の統計
 TCA_RATE:struct tc_estimator:レート制限
 .TE
 
-さらに、 qdisc モジュール特有の様々な属性を指定できる。
-詳細な情報は適切なインクルードファイルを見よ。
-.TP
-.BR RTM_NEWTCLASS ", " RTM_DELTCLASS ", " RTM_GETTCLASS
-トラフィッククラスを追加・削除・取得する。
-これらのメッセージは、上述の
-.I struct tcmsg
-を伴う。
-.TP
-.BR RTM_NEWTFILTER ", " RTM_DELTFILTER ", " RTM_GETTFILTER
-トラフィックフィルターの情報を追加・削除・取得する。
-これらのメッセージは、上述の
-.I struct tcmsg
-を伴う。
+さらに、 qdisc モジュール特有の様々な属性を指定できる。 詳細な情報は適切なインクルードファイルを見よ。
+.TP 
+\fBRTM_NEWTCLASS\fP, \fBRTM_DELTCLASS\fP, \fBRTM_GETTCLASS\fP
+トラフィッククラスを追加・削除・取得する。 これらのメッセージは、上述の \fIstruct tcmsg\fP を伴う。
+.TP 
+\fBRTM_NEWTFILTER\fP, \fBRTM_DELTFILTER\fP, \fBRTM_GETTFILTER\fP
+トラフィックフィルターの情報を追加・削除・取得する。 これらのメッセージは、上述の \fIstruct tcmsg\fP を伴う。
 .SH バージョン
-.B rtnetlink
-は Linux 2.2 の新機能である。
+\fBrtnetlink\fP は Linux 2.2 の新機能である。
 .SH バグ
-この man ページは不完全である
+このマニュアルは完全ではない
 .SH 関連項目
-.BR cmsg (3),
-.BR rtnetlink (3),
-.BR ip (7),
-.BR netlink (7)
+\fBcmsg\fP(3), \fBrtnetlink\fP(3), \fBip\fP(7), \fBnetlink\fP(7)