.\"
.\" 2007-12-08, mtk, Converted from mdoc to man macros
.\"
+.\"*******************************************************************
.\"
-.\" Japanese Version Copyright (c) 1999 NAKANO Takeo all rights reserved.
-.\" Translated Mon Mar 1 1999 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
+.\" This file was generated with po4a. Translate the source file.
.\"
-.\"WORD: standard name (ホストの) 標準名
-.\"WORD: regular file 通常ファイル
-.\"
-.TH RCMD 3 2007-12-28 "Linux" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH RCMD 3 2012\-03\-29 Linux "Linux Programmer's Manual"
.SH 名前
rcmd, rresvport, iruserok, ruserok \- リモートコマンドにストリームを返す関数群
.SH 書式
.nf
-.B #include <netdb.h> \ \ \fP/* Or <unistd.h> on some systems */
+\fB#include <netdb.h> \ \ \fP/* Or <unistd.h> on some systems */
.sp
-.BI "int rcmd(char **" ahost ", int " inport ", const char *" locuser ", "
-.BI " const char *" remuser ", const char *" cmd ", int *" fd2p );
+\fBint rcmd(char **\fP\fIahost\fP\fB, int \fP\fIinport\fP\fB, const char *\fP\fIlocuser\fP\fB, \fP
+\fB const char *\fP\fIremuser\fP\fB, const char *\fP\fIcmd\fP\fB, int *\fP\fIfd2p\fP\fB);\fP
.sp
-.BI "int rresvport(int *" port );
+\fBint rresvport(int *\fP\fIport\fP\fB);\fP
.sp
-.BI "int iruserok(uint32_t " raddr ", int " superuser ", "
-.BI " const char *" ruser ", const char *" luser );
+\fBint iruserok(uint32_t \fP\fIraddr\fP\fB, int \fP\fIsuperuser\fP\fB, \fP
+\fB const char *\fP\fIruser\fP\fB, const char *\fP\fIluser\fP\fB);\fP
.sp
-.BI "int ruserok(const char *" rhost ", int " superuser ", "
-.BI " const char *" ruser ", const char *" luser );
+\fBint ruserok(const char *\fP\fIrhost\fP\fB, int \fP\fIsuperuser\fP\fB, \fP
+\fB const char *\fP\fIruser\fP\fB, const char *\fP\fIluser\fP\fB);\fP
.fi
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
-.BR rcmd (),
-.BR rresvport (),
-.BR ruserok ():
-_BSD_SOURCE
+\fBrcmd\fP(), \fBrresvport\fP(), \fBruserok\fP(): _BSD_SOURCE
.SH 説明
-.BR rcmd ()
-関数は、スーパーユーザーがリモートマシンでコマンドを実行するために
-用いられる。このとき特権ポート番号をもとにした認証スキームが
-用いられる。
-.BR rresvport ()
-関数は、特権ポート空間のアドレスを持つソケットの
-ディスクリプターを返す。
-.BR iruserok ()
-関数と
-.BR ruserok ()
-関数は、
-.BR rcmd ()
-でサービス要求を行ったクライアントの認証を行うために
-サーバーが用いる関数である。
-以上の 4 つの関数は、すべて同じファイルに記述されており、
-.BR rshd (8)
-サーバーによって (他の関数とともに) 利用される。
+\fBrcmd\fP() 関数は、スーパーユーザーがリモートマシンでコマンドを実行するために 用いられる。このとき特権ポート番号をもとにした認証スキームが
+用いられる。 \fBrresvport\fP() 関数は、特権ポート空間のアドレスを持つソケットの ディスクリプターを返す。 \fBiruserok\fP()
+関数と \fBruserok\fP() 関数は、 \fBrcmd\fP() でサービス要求を行ったクライアントの認証を行うために サーバーが用いる関数である。
+以上の 4 つの関数は、すべて同じファイルに記述されており、 \fBrshd\fP(8) サーバーによって (他の関数とともに) 利用される。
.PP
-.BR rcmd ()
-関数は
-.BR gethostbyname (3)
-を用いて
-.I *ahost
-の参照を行う。ホストが存在しない場合は \-1 を返す。
-見つかった場合は
-.I *ahost
-にホストの標準名 (standard name) をセットして、
-予約されているインターネットポート
-.I inport
-経由でサーバーへの接続を確立する。
+\fBrcmd\fP() 関数は \fBgethostbyname\fP(3) を用いて \fI*ahost\fP の参照を行う。ホストが存在しない場合は \-1
+を返す。 見つかった場合は \fI*ahost\fP にホストの標準名 (standard name) をセットして、 予約されているインターネットポート
+\fIinport\fP 経由でサーバーへの接続を確立する。
.PP
-接続に成功したら、インターネットドメインに存在するタイプ
-.B SOCK_STREAM
-のソケットが呼び出しもとに返される。
-このソケットの相手側はリモートコマンドの
-.I stdin
-および
-.I stdout
-に接続される。
-.I fd2p
-がゼロでない場合は、制御プロセスへの接続がもう一つ用意され、
-そのディスクリプターが
-.I *fd2p
-にセットされる。
-制御プロセスはリモートコマンドからの標準エラー出力 (unit 2) を
-このチャンネルに返す。
-また制御プロセスはこの接続から受け取ったバイトデータを
-UNIX シグナルの番号として扱い、リモートコマンドのプロセス
-グループへとシグナルを送る。
-.I fd2p
-がゼロの場合は、
-.I stderr
-(リモートコマンドの unit 2) は
-.I stdout
-と一緒にまとめられる。またこの場合はリモートプロセスへ
-任意のシグナルを送ることはできなくなる。
-ただし帯域外 (out-of-band) データを用いれば、
+接続に成功したら、インターネットドメインに存在するタイプ \fBSOCK_STREAM\fP のソケットが呼び出しもとに返される。
+このソケットの相手側はリモートコマンドの \fIstdin\fP および \fIstdout\fP に接続される。 \fIfd2p\fP
+がゼロでない場合は、制御プロセスへの接続がもう一つ用意され、 そのディスクリプターが \fI*fd2p\fP にセットされる。
+制御プロセスはリモートコマンドからの標準エラー出力 (unit 2) を このチャンネルに返す。 また制御プロセスはこの接続から受け取ったバイトデータを
+UNIX シグナルの番号として扱い、リモートコマンドのプロセス グループへとシグナルを送る。 \fIfd2p\fP がゼロの場合は、 \fIstderr\fP
+(リモートコマンドの unit 2) は \fIstdout\fP と一緒にまとめられる。またこの場合はリモートプロセスへ
+任意のシグナルを送ることはできなくなる。 ただし帯域外 (out\-of\-band) データを用いれば、
リモートプロセスの注意を引くことはできるかもしれない。
.PP
-プロトコルの詳細は
-.BR rshd (8)
-に記述されている。
+プロトコルの詳細は \fBrshd\fP(8) に記述されている。
.PP
-.BR rresvport ()
-関数は特権アドレスにバインドされたソケットを取得するために用いられる。
-このソケットは
-.BR rcmd ()
-などの関数での利用に適している。インターネットポートの特権ポートは、
-0 から 1023 の範囲である。スーパーユーザーだけがこれらのアドレスを
+\fBrresvport\fP() 関数は特権アドレスにバインドされたソケットを取得するために用いられる。 このソケットは \fBrcmd\fP()
+などの関数での利用に適している。インターネットポートの特権ポートは、 0 から 1023 の範囲である。スーパーユーザーだけがこれらのアドレスを
ソケットにバインドすることができる。
.PP
-.BR iruserok ()
-と
-.BR ruserok ()
-関数は、まず以下の引数を取る: リモートホスト
-.RB ( iruserok ()
-は IP アドレスで、
-.BR ruserok ()
-はホスト名で指定)、 2 つのユーザー名、ローカルユーザーの名前が
-スーパーユーザーのものであるかどうかを示すフラグ、である。
-もしユーザーが\fBスーパーユーザーではない\fP場合は、これらの関数は
-.I /etc/hosts.equiv
-ファイルをチェックする。ファイルが見つからなかったり、
-内容のチェックに失敗した場合には、
-ローカルユーザーのホームディレクトリにある
-.I .rhosts
-ファイルをチェックして、サービス要求が許可されているかどうか調べる。
+\fBiruserok\fP() と \fBruserok\fP() 関数は、まず以下の引数を取る: リモートホスト (\fBiruserok\fP() は IP
+アドレスで、 \fBruserok\fP() はホスト名で指定)、 2 つのユーザー名、ローカルユーザーの名前が
+スーパーユーザーのものであるかどうかを示すフラグ、である。 もしユーザーが\fBスーパーユーザーではない\fP場合は、これらの関数は
+\fI/etc/hosts.equiv\fP ファイルをチェックする。ファイルが見つからなかったり、 内容のチェックに失敗した場合には、
+ローカルユーザーのホームディレクトリにある \fI.rhosts\fP ファイルをチェックして、サービス要求が許可されているかどうか調べる。
.PP
-このファイルが存在しなかったり、
-通常ファイル (regular file) ではなかったり、
-指定ユーザーまたはスーパーユーザー以外の所有だったり、
-所有者以外から書き込み可能だったりした場合には、
-このチェックは自動的に失敗する。
-マシンの名前が
-.I hosts.equiv
-にリストされていたり、
-ホストとリモートユーザーの名前が
-.I .rhosts
-ファイルに書かれていた場合には 0 が返される。
-それ以外の場合には、
-.BR iruserok ()
-と
-.BR ruserok ()
-は \-1 を返す。
-.RB ( gethostname (2)
-によって取得される) ローカルドメインがリモートのドメインと同じ場合は、
-マシンの名前だけを指定すればよい。
+このファイルが存在しなかったり、 通常ファイル (regular file) ではなかったり、 指定ユーザーまたはスーパーユーザー以外の所有だったり、
+所有者以外から書き込み可能だったりした場合には、 このチェックは自動的に失敗する。 マシンの名前が \fIhosts.equiv\fP にリストされていたり、
+ホストとリモートユーザーの名前が \fI.rhosts\fP ファイルに書かれていた場合には 0 が返される。 それ以外の場合には、
+\fBiruserok\fP() と \fBruserok\fP() は \-1 を返す。 (\fBgethostname\fP(2) によって取得される)
+ローカルドメインがリモートのドメインと同じ場合は、 マシンの名前だけを指定すればよい。
.PP
-リモートホストの IP アドレスがわかっている場合は、
-.BR ruserok ()
-よりも
-.BR iruserok () を用いる方が良いだろう。
-.BR ruserok ()
-はリモートホストの所属するドメインの DNS サーバーが信頼できなくても
-使用できるからである。
+リモートホストの IP アドレスがわかっている場合は、 \fBruserok\fP() よりも \fBiruserok\fP()\fBを用いる方が良いだろう。\fP
+\fBruserok\fP() はリモートホストの所属するドメインの DNS サーバーが信頼できなくても 使用できるからである。
.SH 返り値
-.BR rcmd ()
-関数は成功すると有効なソケットディスクリプターを返す。
-失敗すると \-1 を返し、標準エラー出力に診断メッセージを
-表示する。
+\fBrcmd\fP() 関数は成功すると有効なソケットディスクリプターを返す。 失敗すると \-1 を返し、標準エラー出力に診断メッセージを 表示する。
.PP
-.BR rresvport ()
-関数は、成功するとバインドされた有効なソケットディスクリプターを返す。
-失敗すると \-1 を返し、グローバル変数
-.I errno
-をエラーの原因に対応する値にセットする。
-エラーコード
-.B EAGAIN
-は、この関数においては「すべてのネットワークポートが使用中」
-という意味を表す。
+\fBrresvport\fP() 関数は、成功するとバインドされた有効なソケットディスクリプターを返す。 失敗すると \-1 を返し、グローバル変数
+\fIerrno\fP をエラーの原因に対応する値にセットする。 エラーコード \fBEAGAIN\fP
+は、この関数においては「すべてのネットワークポートが使用中」 という意味を表す。
.SH 準拠
-POSIX.1-2001 にはない。
-BSD 系、Solaris や他の多くのシステムに存在する。
-これらの関数は 4.2BSD で登場した。
+POSIX.1\-2001 にはない。 BSD 系、Solaris や他の多くのシステムに存在する。 これらの関数は 4.2BSD で登場した。
.SH バグ
-.BR iruserok ()
-は glibc のヘッダでは宣言されていない。
.\" Bug filed 25 Nov 2007:
.\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=5399
+\fBiruserok\fP() は glibc バージョン 2.12 以降のヘッダでのみ宣言されている。
.SH 関連項目
-.BR rlogin (1),
-.BR rsh (1),
-.BR intro (2),
-.BR rexec (3),
-.BR rexecd (8),
-.BR rlogind (8),
-.BR rshd (8)
+\fBrlogin\fP(1), \fBrsh\fP(1), \fBintro\fP(2), \fBrexec\fP(3), \fBrexecd\fP(8),
+\fBrlogind\fP(8), \fBrshd\fP(8)
OSDN Git Service
