.\"(c) Copyright 1992 by Panagiotis Tsirigotis
.\"(c) Sections Copyright 1998-2001 by Rob Braun
.\"All rights reserved.  The file named COPYRIGHT specifies the terms 
.\"and conditions for redistribution.
.\"
.\" $Id: xinetd.man,v 1.1.1.1 1999/10/12 17:28:59 bbraun Exp $
.\"
.\" Japanese Version Copyright (c) 2001 ANDO Yoko
.\"         all rights reserved.
.\" Translated Wed July 15, 2001
.\"         by ANDO Yoko
.\"
.\" Update and Modified on Fri Feb 24 03:07:22 JST 2003
.\"	by System Design and Research Institute Co.,Ltd. <info@sdri.co.jp>
.\"
.\"WORD facility		機能分類
.TH XINETD 8 "14 June 2001"
.\" *************************** NAME *********************************
.SH 名前
xinetd \- 拡張されたインターネットサービスデーモン
.\" *************************** SYNOPSIS *********************************
.SH 書式
.B xinetd
[\fIoptions\fP]
.\" *************************** DESCRIPTION *********************************
.SH 説明
\fBxinetd\fP は、\fBinetd\fPと同じ機能を提供する。
すなわち、インターネットサービスを提供するプログラムを起動させる。
インターネットサーバがシステムの初期化時に起動し、接続要求があるまで
休眠する代わりに、\fBxinetd\fP はデーモンプロセスのみを起動させ、
設定ファイルに記載された全てのサービスに対応したポートをリッスンする。
（リッスンしているポートの一つに）要求があったときに、
\fBxinetd\fP は適切なサーバを起動する。このような管理を行う事から、
\fBxinetd\fP は(\fBinetd\fP と同様に) スーパーサーバとも呼ばれる。
.LP
\fBxinetd\fP の設定ファイルに記載されたサービスは、2つのグループに
分けられる。1つ目は 
.I "マルチスレッド"
と呼ばれ、新しい接続要求がある度に新しいサーバプロセスをフォークする
必要がある。新しいサーバが新しい接続を処理する。
このようなサービスの場合、新しいサーバーをつくる事ができるように
\fBxinetd\fP は新しい要求をリッスンしつづける。
一方、2つ目のグループは、一つのサービスデーモンがすべての新しい
接続要求を処理する。このようなサービスは
.I "シングルスレッド"
と呼ばれ、\fBxinetd\fP はサーバが終了するまで新しい要求の受付を中断する。
このグループのサービスは通常データグラム上のものである。
.LP
今までは、スーパーサーバの存在理由は、ほとんどの生存時間を休眠している
多くのプロセスによるシステムリソースのフォークを避けて節約することにあった。
\fBxinetd\fP はこの機能を満たすだけでなく、スーパーサーバの概念を利用し、
アクセスコントロールやログ等の機能を提供する。さらにその上、
\fBxinetd\fP は
.I /etc/services
に記載されているサービスに制限されない。
したがって、だれでも特殊な目的のサービスを起動させるために
\fBxinetd\fP を利用できる。
.\" *************************** OPTIONS *********************************
.SH オプション
.TP
.BR \-d
デバッグモード。これは、多くのデバッグ出力を行なう。\fBxinetd\fP 上で
デバッガを使用可能にする。
.TP
.BI \-syslog " syslog_facility"
このオプションは指定された syslog 機能分類(facility)を利用して、
\fBxinetd\fPからの出力を syslog で記録する。
以下の機能分類がサポートされている。
.IR daemon ,
.IR auth ,
.IR user ,
.I "local[0-7]"
(それぞれの意味は\fIsyslog.conf(5)\fP で確認のこと)。
このオプションは、デバッグモードでは無効である。
デバッグモードでは、すべての関連するメッセージは端末に送られる。
.TP
.BI \-filelog " logfile"
\fBxinetd\fPからの出力は指定されたファイルに保存される。
出力は終始ファイルに追加される。
(指定された名前の)ファイルが存在しない場合は、新しく作成される。
このオプションは、デバッグモードでは無効である。
デバッグモードでは、すべての関連するメッセージは端末に送られる。
.TP
.BI \-f " config_file"
\fBxinetd\fP が設定に使用するファイルを指定する。デフォルトでは
\fI/etc/xinetd.conf\fP が使用される。
.TP
.BR \-pidfile " pid_file"
プロセス ID はファイルに記述される。このオプションは、デバッグモードでは
無効である。
.TP
.BI \-stayalive 
サービスが一つも指定されていなくても、xinetd に動作しつづけるよう命令する。
.TP
.BI \-limit " proc_limit"
このオプションは
.B xinetd
が、同時に動作させられるプロセス数の上限を定める。
プロセステーブルのオーバーフローを防止する目的がある。
.TP
.BI \-logprocs " limit"
このオプションはリモートのユーザ ID 取得の為に動作させるサーバ数の、
同時に動作する上限を定める。
.TP
.BI \-version
xinetd にバージョン情報を表示させる。
.TP
.BI \-inetd_compat
標準的な xinetd の設定ファイルに加え、
/etc/inetd.conf も追加で読み込むようにする。
/etc/inetd.conf は標準的な xinetd の設定ファイルの後に読み込まれる。
.TP
.BI \-cc " interval"
このオプションは
.B xinetd
の内部状態の定期的な整合性チェックを
.I interval
秒毎に
行なう。
.LP
\fIsyslog\fPと\fIfilelog\fPオプションは相互に排他的である。
どちらも設定されていない場合、デフォルトではsyslogの機能分類
.I daemon
を利用する。
\fBxinetd\fP のメッセージと、関連するサービスによるメッセージを混同しないよう
気をつけること。後者は設定ファイルによって指定された場合にのみログが残る。
.\" *********************** CONTROLLING XINETD ****************************
.SH "XINETD の制御"
.LP
\fBxinetd\fP は一定のシグナルを受け取った時に、一定の動作をする。
特定のシグナルに関連した動作は、\fIconfig.h\fPを変更し、リコンパイル
する事で再定義できる。
.TP 15
.B SIGHUP
.B SIGHUP は再設定を行なわせる。これは、設定ファイルを再読み込みし、
使用可能でなくなったサービスのサーバを停止する。
実行中のサーバに対しては、再びアクセスコントロールがなされ、
接続元、アクセス時間、サーバの実行数がチェックされる。
サーバ実行数の制限値が低くなった場合には、制限を満たすためにいくつかの
任意のサーバが killされる。
これは、接続元・アクセス時間のチェックに失敗したサーバを
終了させた\fI後に\fP行われる。
また、
.B INTERCEPT
フラグが新規に設定された場合、そのサービスのために動作中のサーバは
すべて停止される。
\fIこの目的は、再設定の後に、アクセス制御基準に合わないアドレスからの
パケットを受け取る事が可能な動作中のサーバがないことを確実にするため
である\fP。
.TP
.B SIGQUIT
はプログラムを終了させる。
.TP
.B SIGTERM
は \fBxinetd\fPを終了する前にすべての起動しているサーバを終了する。
.TP
.B SIGUSR1
は内部状態をダンプさせる(デフォルトのダンプファイルは
\fI/tmp/xinetd.dump\fP
であり、ファイル名を変更したい場合には、\fIconfig.h\fP の内容を
変更し、再コンパイルする)。
.TP
.B SIGIOT
はプログラムが利用しているデータ構造に問題がないかを確認するために
内部の一貫性チェックを行なわせる。
チェックが終了すると、
.B xinetd
は、チェックが成功したかあるいは失敗したかのメッセージを出力する。
.LP
再設定時、ログファイルは一旦閉じられ、再び開かれる。これは古いログファ
イルの削除を許可する。
.\" *********************** FILES ****************************
.SH 関連ファイル
.LP
.PD .1v
.TP 20
.B /etc/xinetd.conf
デフォルト設定ファイル
.TP
.B /var/run/xinetd.dump
デフォルトダンプファイル
.PD
.\" *********************** SEE ALSO ****************************
.SH "関連項目"
.I "inetd(8),"
.LP
.I "xinetd.conf(5),"
.LP
.I "xinetd.log(5)"
.\" *********************** AUTHOR ****************************
.SH 作者
Panos Tsirigotis, CS Dept, University of Colorado, Boulder
Rob Braun
.\" *********************** PRONUNCIATION ****************************
.SH 発音
zy-net-d
(訳注: ザイ-ネット-ディー)