.\" Updated 2012-05-05, Akihiro MOTOKI <amotoki@gmail.com>
.\" Updated 2013-07-24, Akihiro MOTOKI <amotoki@gmail.com>
.\"
-.TH REXEC 3 2013\-09\-26 Linux "Linux Programmer's Manual"
+.TH REXEC 3 2014\-05\-28 Linux "Linux Programmer's Manual"
.SH 名前
rexec, rexec_af \- リモートコマンドへのストリームを返す
.SH 書式
\fB#define _BSD_SOURCE\fP /* feature_test_macros(7) 参照 */
\fB#include <netdb.h>\fP
.sp
-\fBint rexec(char **\fP\fIahost\fP\fB, int \fP\fIinport\fP\fB, char *\fP\fIuser\fP\fB, \fP
-\fB char *\fP\fIpasswd\fP\fB, char *\fP\fIcmd\fP\fB, int *\fP\fIfd2p\fP\fB);\fP
+\fBint rexec(char **\fP\fIahost\fP\fB, int \fP\fIinport\fP\fB, const char *\fP\fIuser\fP\fB, \fP
+\fB const char *\fP\fIpasswd\fP\fB, const char *\fP\fIcmd\fP\fB, int *\fP\fIfd2p\fP\fB);\fP
.sp
-\fBint rexec_af(char **\fP\fIahost\fP\fB, int \fP\fIinport\fP\fB, char *\fP\fIuser\fP\fB, \fP
-\fB char *\fP\fIpasswd\fP\fB, char *\fP\fIcmd\fP\fB, int *\fP\fIfd2p\fP\fB,\fP
+\fBint rexec_af(char **\fP\fIahost\fP\fB, int \fP\fIinport\fP\fB, const char *\fP\fIuser\fP\fB, \fP
+\fB const char *\fP\fIpasswd\fP\fB, const char *\fP\fIcmd\fP\fB, int *\fP\fIfd2p\fP\fB,\fP
\fB sa_family_t \fP\fIaf\fP\fB);\fP
.fi
.SH 説明
-このインタフェースは \fBrcmd\fP(3) によって置き換えられた。
+ã\81\93ã\81®ã\82¤ã\83³ã\82¿ã\83¼ã\83\95ã\82§ã\83¼ã\82¹ã\81¯ \fBrcmd\fP(3) ã\81«ã\82\88ã\81£ã\81¦ç½®ã\81\8dæ\8f\9bã\81\88ã\82\89ã\82\8cã\81\9fã\80\82
\fBrexec\fP() 関数は \fBgethostbyname\fP(3) を使ってホスト \fI*ahost\fP を探す。ホストが存在しない場合は \-1
-を返し、それ以外の場合には \fI*ahost\fP にそのホストの標準的な名前を設定する。 ユーザ名とパスワードの両方が指定された場合には、これらは
-æ\8e¥ç¶\9aå\85\88ã\81®ã\83\9bã\82¹ã\83\88ã\81¸ã\81®èª\8d証ã\81«å\88©ç\94¨ã\81\95ã\82\8cã\82\8bã\80\82ã\81\9dã\81\86ã\81§ã\81ªã\81\84å ´å\90\88ã\81«ã\81¯ã\80\81 é\81©å\88\87ã\81ªæ\83\85å ±ã\82\92å\85¥æ\89\8bã\81\99ã\82\8bã\81\9fã\82\81ã\81«ã\80\81ç\92°å¢\83å¤\89æ\95°ã\81¨ã\80\81ã\81\9dã\81®ã\83¦ã\83¼ã\82¶ã\81® ã\83\9bã\83¼ã\83 ã\83\87ã\82£ã\83¬ã\82¯ã\83\88ã\83ªã\81® \fI.netrc\fP
-ファイルが検索される。情報が見つからなかった時には、 ユーザに対して情報を入力するプロンプトが表示される。
+を返し、それ以外の場合には \fI*ahost\fP にそのホストの標準的な名前を設定する。 ユーザー名とパスワードの両方が指定された場合には、これらは
+æ\8e¥ç¶\9aå\85\88ã\81®ã\83\9bã\82¹ã\83\88ã\81¸ã\81®èª\8d証ã\81«å\88©ç\94¨ã\81\95ã\82\8cã\82\8bã\80\82ã\81\9dã\81\86ã\81§ã\81ªã\81\84å ´å\90\88ã\81«ã\81¯ã\80\81 é\81©å\88\87ã\81ªæ\83\85å ±ã\82\92å\85¥æ\89\8bã\81\99ã\82\8bã\81\9fã\82\81ã\81«ã\80\81ç\92°å¢\83å¤\89æ\95°ã\81¨ã\80\81ã\81\9dã\81®ã\83¦ã\83¼ã\82¶ã\83¼ã\81® ã\83\9bã\83¼ã\83 ã\83\87ã\82£ã\83¬ã\82¯ã\83\88ã\83ªã\81®
+\&\fI.netrc\fP ファイルが検索される。情報が見つからなかった時には、 ユーザーに対して情報を入力するプロンプトが表示される。
.PP
ポート \fIinport\fP には、接続に使用する DARPA Internet の well\-known ポートを指定する。
-\fIgetservbyname("exec", "tcp")\fP を呼び出すと構造体へのポインタが返され (\fBgetservent\fP(3)
+\fIgetservbyname("exec", "tcp")\fP ã\82\92å\91¼ã\81³å\87ºã\81\99ã\81¨æ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81\8cè¿\94ã\81\95ã\82\8c (\fBgetservent\fP(3)
参照)、この構造体には必要なポートが入っている。 接続に使用されるプロトコルについての詳細は \fBrexecd\fP(8) に書かれている (訳注:
現在のところ存在しない)。
.PP
接続に成功すると、インターネットドメインの \fBSOCK_STREAM\fP 型のソケットが返され、そのソケットはリモートコマンドの
-標準入力および標準出力となる。 \fIfd2p\fP が 0 以外の場合、制御プロセスへの補助チャンネルがセットアップされ、 補助チャンネルのディスクリプタが
-\fI*fd2p\fP に書かれる。 制御プロセスはコマンドからの診断メッセージ出力 (ファイルディスクリプタ 2)
+標準入力および標準出力となる。 \fIfd2p\fP が 0 以外の場合、制御プロセスへの補助チャンネルがセットアップされ、
+補助チャンネルのディスクリプターが \fI*fd2p\fP に書かれる。 制御プロセスはコマンドからの診断メッセージ出力 (ファイルディスクリプター 2)
をこのチャンネルで返す。また、このチャンネル経由で UNIX のシグナル番号を示すバイトを受信する。受信したシグナルは
コマンドが属すプロセスグループに転送される。 診断情報にはリモートの認証失敗は含まれない。なぜなら、認証の確認が行われた
-後で補助チャンネルの接続はセットアップされるからである。 \fIfd2p\fP が 0 の場合、標準エラー (リモートコマンドのファイルディスクリプタ 2)
-は 標準出力と同様に扱われ、リモートプロセスに任意のシグナルを送るための 手段は提供されない。但し、リモートプロセスに対してトリガをかけるために、
+後で補助チャンネルの接続はセットアップされるからである。 \fIfd2p\fP が 0 の場合、標準エラー (リモートコマンドのファイルディスクリプター 2)
+ã\81¯ æ¨\99æº\96å\87ºå\8a\9bã\81¨å\90\8cæ§\98ã\81«æ\89±ã\82\8fã\82\8cã\80\81ã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82»ã\82¹ã\81«ä»»æ\84\8fã\81®ã\82·ã\82°ã\83\8aã\83«ã\82\92é\80\81ã\82\8bã\81\9fã\82\81ã\81® æ\89\8b段ã\81¯æ\8f\90ä¾\9bã\81\95ã\82\8cã\81ªã\81\84ã\80\82ä½\86ã\81\97ã\80\81ã\83ªã\83¢ã\83¼ã\83\88ã\83\97ã\83ã\82»ã\82¹ã\81«å¯¾ã\81\97ã\81¦ã\83\88ã\83ªã\82¬ã\83¼ã\82\92ã\81\8bã\81\91ã\82\8bã\81\9fã\82\81ã\81«ã\80\81
帯域外データ (out\-of\-band data) を使うことはできる。
.SS rexec_af()
\fBrexec\fP() 関数は IPv4 (\fBAF_INET\fP) 上で動作する。
.SH 関連項目
\fBrcmd\fP(3), \fBrexecd\fP(8)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.64 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
