989d921f5d
I'm very pleased to announce the release of our new website and documentation using the new toolchain with Hugo and AsciiDoctor. To get more information about the new toolchain please read the FreeBSD Documentation Project Primer[1], Hugo docs[2] and AsciiDoctor docs[3]. Acknowledgment: Benedict Reuschling <bcr@> Glen Barber <gjb@> Hiroki Sato <hrs@> Li-Wen Hsu <lwhsu@> Sean Chittenden <seanc@> The FreeBSD Foundation [1] https://docs.FreeBSD.org/en/books/fdp-primer/ [2] https://gohugo.io/documentation/ [3] https://docs.asciidoctor.org/home/ Approved by: doceng, core
321 lines
7.4 KiB
Groff
321 lines
7.4 KiB
Groff
.\" @(#)rpcinfo.1m 1.23 93/03/29 SMI; from SVr4
|
|
.\" Copyright 1989 AT&T
|
|
.\" Copyright 1991 Sun Microsystems, Inc.
|
|
.\" %NetBSD: rpcinfo.8,v 1.6 2000/06/02 23:19:38 fvdl Exp %
|
|
.\" %FreeBSD: src/usr.bin/rpcinfo/rpcinfo.8,v 1.9 2002/10/16 15:38:28 charnier Exp %
|
|
.\" $FreeBSD$
|
|
.Dd August 18, 1992
|
|
.Dt RPCINFO 8
|
|
.Os
|
|
.Sh 名称
|
|
.Nm rpcinfo
|
|
.Nd RPC に関する情報を表示する
|
|
.Sh 書式
|
|
.Nm
|
|
.Op Fl m | s
|
|
.Op Ar host
|
|
.Nm
|
|
.Op Ar host
|
|
.Nm
|
|
.Fl T Ar transport
|
|
.Ar host prognum
|
|
.Op Ar versnum
|
|
.Nm
|
|
.Fl l
|
|
.Op Fl T Ar transport
|
|
.Ar host prognum
|
|
.Op Ar versnum
|
|
.Nm
|
|
.Op Fl n Ar portnum
|
|
.Fl u
|
|
.Ar host prognum
|
|
.Op Ar versnum
|
|
.Nm
|
|
.Op Fl n Ar portnum
|
|
.Op Fl t
|
|
.Ar host prognum
|
|
.Op Ar versnum
|
|
.Nm
|
|
.Fl a Ar serv_address
|
|
.Fl T Ar transport
|
|
.Ar prognum
|
|
.Op Ar versnum
|
|
.Nm
|
|
.Fl b
|
|
.Op Fl T Ar transport
|
|
.Ar prognum versnum
|
|
.Nm
|
|
.Fl d
|
|
.Op Fl T Ar transport
|
|
.Ar prognum versnum
|
|
.Sh 解説
|
|
.Nm
|
|
ユーティリティは、RPC サーバに対して
|
|
RPC 呼び出しを行ない、得られた情報を表示します。
|
|
.Pp
|
|
最初の書式では、
|
|
.Nm
|
|
は
|
|
.Nm rpcbind
|
|
により
|
|
.Ar host
|
|
に登録されたすべての RPC サービスのリストを表示します。
|
|
.Ar host
|
|
が指定されない場合、ローカルホストがデフォルトの値となります。
|
|
オプション
|
|
.Fl s
|
|
が使用されたときは、情報は簡潔な形式で表示されます。
|
|
.Pp
|
|
2 番目の書式では、
|
|
.Nm
|
|
は
|
|
.Nm rpcbind
|
|
バージョン 2 により登録された全ての RPC サービスのリストを表示します。
|
|
最初の書式と 2 番目の書式とで、情報の形式が異なることにも注意して下さい。
|
|
この理由は、2 番目の書式では、表示する情報を集めるのに使用するプロトコル
|
|
(
|
|
.Nm rpcbind
|
|
プロトコルのバージョン 2) がより古いからです。
|
|
.Pp
|
|
3 番目の書式は、指定した
|
|
.Ar host
|
|
に対し、
|
|
.Ar prognum
|
|
と
|
|
.Ar versnum
|
|
の手続き 0 の RPC 呼び出しを行ない、応答を受信したかどうかを報告します。
|
|
.Ar transport
|
|
は、指定したサービスに接触するために用いる必要があるトランスポートです。
|
|
このサービスのリモートアドレスは、リモートへの
|
|
.Nm rpcbind
|
|
呼び出しを行ない取得します。
|
|
.Pp
|
|
引数
|
|
.Ar prognum
|
|
は PPC プログラム番号を表す数値です。
|
|
.Ar versnum
|
|
を指定した場合、
|
|
.Nm
|
|
は指定した
|
|
.Ar prognum
|
|
の該当バージョンを呼び出そうとします。この指定がない場合、
|
|
次のようにします。
|
|
まず、バージョン番号が存在しないと考えられる場合、
|
|
.Nm
|
|
はバージョン 0 を呼び出し、指定した
|
|
.Ar prognum
|
|
に対し登録されたバージョン番号全てを探し出そうと試みます。
|
|
バージョン番号が存在するならば、代わりに
|
|
.Nm
|
|
は極めて高いバージョン番号で呼び出しこの情報を得ようと試み、
|
|
そして登録されたバージョンそれぞれを呼び出そうとします。
|
|
注意:
|
|
バージョン番号は、
|
|
オプション
|
|
.Fl b ,
|
|
.Fl d
|
|
に必要です。
|
|
.Sh オプション
|
|
.Bl -tag -width indent
|
|
.It Fl T Ar transport
|
|
サービスを要求する際のトランスポートを指定します。このオプションが
|
|
指定されていない場合、
|
|
.Nm
|
|
は環境変数
|
|
.Ev NETPATH
|
|
で指定するトランスポートを使用します。これが set されていないか、
|
|
この値が空の場合、
|
|
.Xr netconfig 5
|
|
データベースの中のトランスポートを使用します。
|
|
これは汎用のオプションであり、
|
|
.Sx 書式
|
|
で示された他のオプションといっしょに使用できます。
|
|
.It Fl a Ar serv_address
|
|
.Ar serv_address
|
|
を (ユニバーサルな) アドレスとして使用し、
|
|
.Ar transport
|
|
上のサービスを使い、指定した
|
|
.Ar prognum
|
|
の手続き 0 を ping し、受けとった応答を報告します。
|
|
オプション
|
|
.Fl a
|
|
には、オプション
|
|
.Fl T
|
|
が必要です。
|
|
.Pp
|
|
.Ar versnum
|
|
の指定がない場合、
|
|
.Nm
|
|
は、そのプログラム番号で利用可能なバージョン番号全てを
|
|
ping しようとします。
|
|
このオプションにより、サービスのアドレスを見つけ出すための
|
|
リモート
|
|
.Nm rpcbind
|
|
呼び出しを避けることができます。
|
|
.Ar serv_address
|
|
は与えられたトランスポートのユニバーサルアドレス形式で指定します。
|
|
.It Fl b
|
|
指定した
|
|
.Ar prognum
|
|
と
|
|
.Ar versnum
|
|
の手続き 0 に対し RPC ブロードキャストを行ない、応答したホスト全てを
|
|
報告します。
|
|
.Ar transport
|
|
が指定されている場合、指定されたトランスポート上でのみ
|
|
ブロードキャストします。
|
|
どのトランスポートもブロードキャストをサポートしていない場合、
|
|
エラーメッセージを表示します。他のシステムに対し悪影響を及ぼす可能性が
|
|
あるため、ブロードキャストの使用は節度を持って行なわねばなりません。
|
|
.It Fl d
|
|
指定した
|
|
.Ar prognum
|
|
と
|
|
.Ar versnum
|
|
を持つ RPC サービスの登録を削除します。
|
|
.Ar transport が指定された場合、
|
|
そのトランスポート上のサービスのみを登録解除します。それ以外の場合、
|
|
登録されたトランスポート全ての上のサービスを登録解除します。
|
|
スーパユーザを除き、サービスの所有者のみが登録を削除できます。
|
|
スーパユーザは任意のサービスを削除できます。
|
|
.It Fl l
|
|
指定された
|
|
.Ar host
|
|
の上にある、与えられた
|
|
.Ar prognum
|
|
と
|
|
.Ar versnum
|
|
を持つエントリのリストを表示します。
|
|
リモート
|
|
.Nm rpcbind
|
|
に接触する際に用いたものと同じプロトコルファミリの中の
|
|
全てのトランスポートに対し、エントリを返されます。
|
|
.It Fl m
|
|
指定した
|
|
.Ar host
|
|
に対する
|
|
.Nm rpcbind
|
|
操作の統計情報表を表示します。
|
|
この表は
|
|
.Nm rpcbind
|
|
の各バージョン (バージョン 2, 3, 4) における統計情報を表示します。
|
|
それは、
|
|
各手続きがリクエストされ、サービスが成功した回数、
|
|
行なわれたリモート呼び出しリクエストの回数とタイプ、
|
|
処理した RPC アドレス検出に関する情報を与えてくれます。
|
|
これは、
|
|
.Ar host
|
|
上の RPC 活動をモニタするのに有益です。
|
|
.It Fl n Ar portnum
|
|
.Fl t ,
|
|
.Fl u
|
|
のためのポート番号として、
|
|
.Nm rpcbind
|
|
により与えられるポート番号を使わずに、
|
|
.Ar portnum
|
|
を代わりに使用します。
|
|
このオプションを使用することで、サービスのアドレスを見つけ出すための
|
|
リモート
|
|
.Nm rpcbind
|
|
呼び出しを避けることができます。
|
|
このオプションは
|
|
.Fl a
|
|
オプションにより非推奨にされました。
|
|
.It Fl p
|
|
.Nm rpcbind
|
|
プロトコルのバージョン 2 を用い、ホスト
|
|
.Ar host
|
|
上の
|
|
.Nm rpcbind
|
|
を探査し、登録された RPC プログラム全てのリストを表示します。
|
|
.Ar host
|
|
の指定がない場合、ローカルホストをデフォルトとします。
|
|
注意:
|
|
.Nm rpcbind
|
|
プロトコルのバージョン 2 は、かつて、ポートマッパ (portmapper)
|
|
プロトコルという名前で知られていました。
|
|
.It Fl s
|
|
.Ar host
|
|
上の、登録された RPC プログラム全ての簡潔なリストを表示します。
|
|
.Ar host
|
|
の指定がない場合、ローカルホストをデフォルトとします。
|
|
.It Fl t
|
|
TCP を用いて、指定した
|
|
.Ar host
|
|
上の
|
|
.Ar prognum
|
|
の手続き 0 に対して RPC 呼び出しを行ない、応答があったかどうかを
|
|
報告します。このオプションは、3 番目の書式で示した
|
|
.Fl T
|
|
オプションにより非推奨になりました。
|
|
.It Fl u
|
|
UDP を用いて、指定した
|
|
.Ar host
|
|
上の
|
|
.Ar prognum
|
|
の手続き 0 に対して RPC 呼び出しを行ない、応答があったかどうかを
|
|
報告します。このオプションは、3 番目の書式で示した
|
|
.Fl T
|
|
オプションにより非推奨になりました。
|
|
.El
|
|
.Sh 使用例
|
|
ローカルマシンに登録されている全ての RPC
|
|
サービスを見るには、次のようにします。
|
|
.Pp
|
|
.Dl "example% rpcinfo"
|
|
.Pp
|
|
ホスト名
|
|
.Dq klaxon
|
|
を持つマシン上の
|
|
.Nm rpcbind
|
|
に登録されている全ての RPC サービスを見るには、次のようにします。
|
|
.Pp
|
|
.Dl "example% rpcinfo klaxon"
|
|
.Pp
|
|
上記のコマンドにより表示される情報は、かなり長くなる可能性が
|
|
あります。オプション
|
|
.Fl s
|
|
を使うことで、より簡潔なリストを表示させることができます。
|
|
.Pp
|
|
.Dl "example$ rpcinfo -s klaxon"
|
|
.Pp
|
|
.Bl -column "program" "version(s)" "unix,tcp,udp,tcp6,udp6" "nlockmgr" "super-user"
|
|
.It "program version(s) netid(s) service owner"
|
|
.It "100000 2,3,4 unix,tcp,udp,tcp6,udp6 rpcbind super-user"
|
|
.It "100008 1 udp,tcp,udp6,tcp6 walld super-user"
|
|
.It "100002 2,1 udp,udp6 rusersd super-user"
|
|
.It "100001 2,3,4 udp,udp6 rstatd super-user"
|
|
.It "100012 1 udp,tcp sprayd super-user"
|
|
.It "100007 3 udp,tcp ypbind super-user"
|
|
.El
|
|
.Pp
|
|
トランスポート TCP に対し、名前
|
|
.Dq klaxon
|
|
を持つマシン上にプログラム番号
|
|
.Ar prognum
|
|
とバージョン
|
|
.Ar versnum
|
|
を持つ RPC サービスが登録されているかどうかを示すには、
|
|
次のようにします。
|
|
.Dl "example% rpcinfo -T tcp klaxon prognum versnum"
|
|
.Pp
|
|
ローカルマシン上で、
|
|
.Nm rpcbind
|
|
プロトコルのバージョン 2 により登録された全ての RPC サービスを
|
|
表示させるには、次のようにします。
|
|
.Dl "example% rpcinfo -p"
|
|
.Pp
|
|
全てのトランスポートに対し、
|
|
バージョン 1 の
|
|
.Nm walld
|
|
(プログラム番号 100008)
|
|
サービスの登録を削除するには、次のようにします。
|
|
.Pp
|
|
.Dl "example# rpcinfo -d 100008 1"
|
|
または、
|
|
.Dl "example# rpcinfo -d walld 1"
|
|
.Sh 関連項目
|
|
.Xr rpc 3 ,
|
|
.Xr netconfig 5 ,
|
|
.Xr rpc 5 ,
|
|
.Xr rpcbind 8
|