日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
RTENTRY(9) FreeBSD カーネル開発者マニュアル RTENTRY(9)
名称
rtentry -- カーネル経路表中のエントリの構造体
書式
#include <sys/types.h>
#include <sys/socket.h>
#include <net/route.h>
解説
カーネルは、経路の中央のテーブルからエントリを格納し検索して取り出すこと
ができるすべてのプロトコルに共通のメカニズムを提供します。このメカニズム
の部分も、route(4) 疑似プロトコルファミリのソケットを用いてユーザレベルプ
ロセスと情報をやりとりするために使用されます。<net/route.h> ヘッダファイ
ルは、この機能の中で使用される構造体と明白な定数を定義します。
経路の基礎的な構造体は、次のフィールドを含んでいる、struct rtentry によっ
て定義されます。
struct radix_node rt_nodes[2];
基数ツリールーチンによって使用される接着剤です。これらのメ
ンバは、さらにそれらの下部構造体に経路が作られた時使用され
るキー (つまり目的アドレス) とマスクを含んでいます。
rt_key(rt) と rt_mask(rt) マクロは、struct rtentry * で与え
られた (struct sockaddr * の形式の) この情報を抽出するため
に使用することができます。
struct sockaddr *rt_gateway;
それ自体で (いくつかのプロトコルは、リンクレイヤ (層) アド
レスをここに置きます) 目的地を表示できる、または、
(RTF_GATEWAY フラグが設定される場合) その目的地へ行く途中で
ある中間の停止できるか、いずれかの経路の ``目標'' です。
int rt_flags;
下記を参照してください。RTF_UP フラグが存在しないなら、
rtfree() 関数は、最後の参照が落されるとき、radix ツリーから
経路を削除します。
int rt_refcnt;
経路エントリは、数えられた参照です。このフィールドは、外部
(基数ツリーへの) 参照の数を示します。
struct ifnet *rt_ifp;
struct ifaddr *rt_ifa;
これらの 2 つのフィールドは、経路の検索によってもたらされた
質問の、言ってみれば、``答え'' を表わします。すなわち、それ
らは、目的地またはこの経路が表わす目的地の設定へパケットを
送信するのに使用されるインタフェースとインタフェースアドレ
スを指定します。
u_long rt_mtu;
下記の rmx_mtu の説明を参照してください。
u_long rt_weight;
下記の rmx_weight の説明を参照してください。
u_long rt_expire;
下記の rmx_expire の説明を参照してください。
counter64_t rt_pksent;
下記の rmx_pksent の説明を参照してください。
struct rtentry *rt_gwroute;
このメンバは、その目的地が rt_gateway である経路への参照で
す。それは、RTF_GATEWAY 経路用に単に使用されます。
struct mtx rt_mtx;
この経路制御エントリをロックするミューテックス (mutex)。
次のフラグビットが定義されます。
RTF_UP 経路は、削除されません。
RTF_GATEWAY 最終の受取手ではなく中間の目的地への経路ポイントで
す。rt_gateway と rt_gwroute フィールドがその目的地
を指定します。
RTF_HOST これは、ホスト経路です。
RTF_REJECT 目的地は、現在到達不可能です。これは、出力ルーチンか
らの EHOSTUNREACH エラーで終るべきです。
RTF_DYNAMIC この経路は、rtredirect() によってダイナミックに作ら
れました。
RTF_MODIFIED この経路は、rtredirect() によって修正されました。
RTF_DONE リクエストが実行されたことを示す、route(4) プロトコ
ルの中でのみ使用します。
RTF_XRESOLVE この経路が検索の結果として返される時、外部プロセスが
この経路に対する転換を実行することを要求する
route(4) インタフェースに関する報告書を送ります。
RTF_STATIC この経路は、route(8) コマンドを使って手動で加えられ
たことを示します。
RTF_BLACKHOLE この経路経由で送信された出力が廃棄されることを要求し
ます。
RTF_PROTO1
RTF_PROTO2
RTF_PROTO3 プロトコルに特有です。
RTF_PINNED この経路が経路制御プロトコルに不変であることを示しま
す。
RTF_LOCAL この経路の目的地がこのシステムに属するように設定され
たアドレスであることを示します。
RTF_BROADCAST 目的地がブロードキャストアドレスであることを示しま
す。
RTF_MULTICAST 目的地がマルチキャストアドレスであることを示します。
いくつかのメトリクスは、route(4) API によって経路制御メッセージで渡された
struct rt_metrics に供給されます。現在、rmx_mtu, rmx_expire と rmx_pksent
メトリクスだけが供給されています。他のすべてのものは、無視されます。
次のメトリクスは、struct rt_metrics によって定義されます:
u_long rmx_locks;
カーネルがダイナミックに修正することが許されないどのメトリ
クスか示すフラグビットです。
u_long rmx_mtu;
このパス用の MTU。
u_long rmx_hopcount;
この目的地へのパス上の中間のシステムの数。
u_long rmx_expire;
この経路が終了するべき (time(3) 形式の) 時間、または、それ
が決して終了してはならない場合、0 です。一旦それらが終了す
れば経路が実際に削除されることを保証するのは個々のプロトコ
ルの責任です。
u_long rmx_recvpipe;
通常、目的地からこのシステムまでのパスのためのバンド (帯域)
幅ディレイ (遅れ) 結果です。実際には、この値は、受信バッ
ファ (したがって TCP のようなスライディングウィンドウプロト
コル中のウィンドウ) のサイズを設定するために使用されます。
u_long rmx_sendpipe;
前述と同様ですが、反対の方向です。
u_long rmx_ssthresh;
遅いスタートのしきい値は、TCP 雑踏回避の中で使用します。
u_long rmx_rtt;
毎秒 RMX_RTTUNIT のユニットでこの目的地への往復の時間です。
u_long rmx_rttvar;
毎秒 RMX_RTTUNIT のユニットでこの目的地への円形の往復の時間
の平均偏差です。
u_long rmx_pksent;
この経路経由で成功して送信されたパケットの数です。
u_long rmx_filler[4];
プロトコルに特有の情報に利用可能な空き空間です。
関連項目
route(4), route(8), rtalloc(9)
歴史
rtentry 構造体は、4.2BSD ではじめて登場しました。経路表と rt_metrics 構造
体の基数ツリー表現は、4.3BSD-Reno ではじめて登場しました。
作者
このマニュアルページは、Garrett Wollman によって書かれました。
バグ
このインタフェースには、多くの歴史的な遺物が残っています。rt_gateway と
rmx_filler フィールドは、より良く指定できるかもしれません。
FreeBSD 11.4 March 5, 2014 FreeBSD 11.4