<STATUS> stat: DP ppkg: nginx 1.21.1 page: nginx.8 date: 2021/07/06 mail: michio_matsu****@yahoo***** name: Michio MATSUYAMA </STATUS> [原文] .Sh NAME .Nm nginx .Nd "HTTP and reverse proxy server, mail proxy server" [訳文] .Sh 名前 .Nm nginx .Nd "HTTP およびリバースプロキシーサーバー、メールプロキシーサーバー" ---------------------------------------- [原文] .Sh SYNOPSIS .Nm .Op Fl ?hqTtVv .Op Fl c Ar file .Op Fl e Ar file .Op Fl g Ar directives .Op Fl p Ar prefix .Op Fl s Ar signal [訳文] .Sh 書式 .Nm .Op Fl ?hqTtVv .Op Fl c Ar file .Op Fl e Ar file .Op Fl g Ar directives .Op Fl p Ar prefix .Op Fl s Ar signal ---------------------------------------- [原文] .Sh DESCRIPTION .Nm (pronounced .Dq engine x ) is an HTTP and reverse proxy server, a mail proxy server, and a generic TCP/UDP proxy server. It is known for its high performance, stability, rich feature set, simple configuration, and low resource consumption. [訳文] .Sh 説明 .Nm (発音は .Dq engine x ) は、 HTTP およびリバースプロキシーサーバー、 メールプロキシーサーバー、汎用的な TCP/UDP プロキシーサーバーです。 高性能、安定性、豊富な機能セット、簡単な設定、リソースの低消 費という特徴が知られています。 ---------------------------------------- [原文] .Pp The options are as follows: .Bl -tag -width ".Fl d Ar directives" .It Fl ? , h Print help. .It Fl c Ar file Use an alternative configuration .Ar file . .It Fl e Ar file Use an alternative error log .Ar file . Special value .Cm stderr indicates that the standard error output should be used. .It Fl g Ar directives Set global configuration directives. See [訳文] .Pp オプションは以下のとおりです。 .Bl -tag -width ".Fl d Ar directives" .It Fl ? , h ヘルプを表示します。 .It Fl c Ar file 別の設定ファイルとして .Ar file を用います。 .It Fl e Ar file 別のエラーログとして .Ar file を用います。 特別な設定値 .Cm stderr があって、 これは標準エラーへの出力が行われます。 .It Fl g Ar directives グローバル設定ディレクティブを設定します。 ---------------------------------------- [原文] .Sx EXAMPLES for details. .It Fl p Ar prefix Set the prefix path. The default value is .Pa /usr . .It Fl q Suppress non-error messages during configuration testing. .It Fl s Ar signal Send a signal to the master process. The argument .Ar signal can be one of: .Cm stop , quit , reopen , reload . The following table shows the corresponding system signals: [訳文] .Sx 例 のセクションを参照してください。 .It Fl p Ar prefix プレフィックスパスを設定します。デフォルトは .Pa /usr です。 .It Fl q 設定テストを行う際、 エラーではないメッセージは省略します。 .It Fl s Ar signal マスタープロセスにシグナルを送信します。 引数 .Ar signal には、 .Cm stop , quit , reopen , reload のいずれかを指定します。 以下に示す一覧は、 これに対応するシステムシグナルです。 ---------------------------------------- [原文] .Pp .Bl -tag -width ".Cm reopen" -compact .It Cm stop .Dv SIGTERM .It Cm quit .Dv SIGQUIT .It Cm reopen .Dv SIGUSR1 .It Cm reload .Dv SIGHUP .El .It Fl T Same as .Fl t , but additionally dump configuration files to standard output. .It Fl t Do not run, just test the configuration file. .Nm checks the configuration file syntax and then tries to open files referenced in the configuration file. .It Fl V Print the .Nm version, compiler version, and .Pa configure script parameters. .It Fl v Print the .Nm version. .El [訳文] .Pp .Bl -tag -width ".Cm reopen" -compact .It Cm stop .Dv SIGTERM .It Cm quit .Dv SIGQUIT .It Cm reopen .Dv SIGUSR1 .It Cm reload .Dv SIGHUP .El .It Fl T .Fl t と同様です。 ただしこれに加えて、 設定ファイル内容を標準出力に書き出します。 .It Fl t 実行は行わずに、 設定ファイルのテストだけを行います。 .Nm は、 設定ファイルの文法チェックを行い、 設定ファイル内から参照されているファイルの読み込みを試します 。 .It Fl V .Nm のバージョン、 コンパイラーバージョン、 .Pa configure スクリプトのパラメーターを表示します。 .It Fl v .Nm のバージョンを表示します。 .El ---------------------------------------- [原文] .Sh SIGNALS The master process of .Nm can handle the following signals: [訳文] .Sh シグナル .Nm のマスタープロセスは、 以下のシグナルを取り扱います。 ---------------------------------------- [原文] .Pp .Bl -tag -width ".Dv SIGINT , SIGTERM" -compact .It Dv SIGINT , SIGTERM Shut down quickly. .It Dv SIGHUP Reload configuration, start the new worker process with a new configuration, and gracefully shut down old worker processes. .It Dv SIGQUIT Shut down gracefully. .It Dv SIGUSR1 Reopen log files. .It Dv SIGUSR2 Upgrade the .Nm executable on the fly. .It Dv SIGWINCH Shut down worker processes gracefully. .El [訳文] .Pp .Bl -tag -width ".Dv SIGINT , SIGTERM" -compact .It Dv SIGINT , SIGTERM すぐに終了します。 .It Dv SIGHUP 設定を再ロードして、 新たな設定を用いた新たなワーカープロセスを起動します。 そして古いワーカープロセスは、 適切にシャットダウンします。 .It Dv SIGQUIT 適切にシャットダウンします。 .It Dv SIGUSR1 ログファイルを開き直します。 .It Dv SIGUSR2 .Nm 実行ファイルをその場でアップグレードします。 .It Dv SIGWINCH ワーカープロセスを適切にシャットダウンします。 .El ---------------------------------------- [原文] .Pp While there is no need to explicitly control worker processes normally, they support some signals too: [訳文] .Pp ワーカープロセスに対して、 通常の制御を明示的に行う必要がない場合には、 さらに以下のシグナルもサポートしています。 ---------------------------------------- [原文] .Pp .Bl -tag -width ".Dv SIGINT , SIGTERM" -compact .It Dv SIGTERM Shut down quickly. .It Dv SIGQUIT Shut down gracefully. .It Dv SIGUSR1 Reopen log files. .El [訳文] .Pp .Bl -tag -width ".Dv SIGINT , SIGTERM" -compact .It Dv SIGTERM すぐに終了します。 .It Dv SIGQUIT 適切にシャットダウンします。 .It Dv SIGUSR1 ログファイルを開き直します。 .El ---------------------------------------- [原文] .Sh DEBUGGING LOG To enable a debugging log, reconfigure .Nm to build with debugging: [訳文] .Sh デバッグログ デバッグログを有効にするために、 デバッグ機能を含めた .Nm のビルドの設定を行います。 ---------------------------------------- [原文] .Pp .Dl "./configure --with-debug ..." [訳文] .Pp .Dl "./configure --with-debug ..." ---------------------------------------- [原文] .Pp and then set the .Cm debug level of the .Va error_log : [訳文] .Pp そして .Cm debug レベルを .Va error_log に設定します。 ---------------------------------------- [原文] .Pp .Dl "error_log /path/to/log debug;" [訳文] .Pp .Dl "error_log /path/to/log debug;" ---------------------------------------- [原文] .Pp It is also possible to enable the debugging for a particular IP address: .Bd -literal -offset indent events { debug_connection 127.0.0.1; } .Ed [訳文] .Pp 特定の IP アドレスに対して、 デバッグを有効にすることもできます。 .Bd -literal -offset indent events { debug_connection 127.0.0.1; } .Ed ---------------------------------------- [原文] .Sh ENVIRONMENT The .Ev NGINX environment variable is used internally by .Nm and should not be set directly by the user. [訳文] .Sh 環境変数 環境変数 .Ev NGINX は、 .Nm が内部で利用しています。 これはユーザーが直接設定するものではありません。 ---------------------------------------- [原文] .Sh FILES .Bl -tag -width indent .It Pa /usr/logs/nginx.pid Contains the process ID of .Nm . The contents of this file are not sensitive, so it can be world-readable. .It Pa /etc/nginx/nginx.conf The main configuration file. .It Pa /var/log/error.log Error log file. .El [訳文] .Sh ファイル .Bl -tag -width indent .It Pa /usr/logs/nginx.pid .Nm のプロセス ID を保持します。 このファイルの内容は機密情報ではないため、 だれでも見ることができます (world-readable です)。 .It Pa /etc/nginx/nginx.conf メインの設定ファイル。 .It Pa /var/log/error.log エラーログファイル。 .El ---------------------------------------- [原文] .Sh EXIT STATUS Exit status is 0 on success, or 1 if the command fails. [訳文] .Sh 終了ステータス 終了ステータスは、 正常処理時に 0、 処理失敗時に 1 です。 ---------------------------------------- [原文] .Sh EXAMPLES Test configuration file .Pa ~/mynginx.conf with global directives for PID and quantity of worker processes: .Bd -literal -offset indent nginx -t -c ~/mynginx.conf \e -g "pid /var/run/mynginx.pid; worker_processes 2;" .Ed [訳文] .Sh 例 テストの設定ファイルとして .Pa ~/mynginx.conf を指定します。 そして PID に対するグローバルディレクティブを用いて、 ワーカープロセス量を設定します。 .Bd -literal -offset indent nginx -t -c ~/mynginx.conf \e -g "pid /var/run/mynginx.pid; worker_processes 2;" .Ed ---------------------------------------- [原文] .Sh SEE ALSO Documentation at .Pa http://nginx.org/en/docs/ . [訳文] .Sh 関連項目 ドキュメント: .Pa http://nginx.org/en/docs/ ---------------------------------------- [原文] .Pp For questions and technical support, please refer to .Pa http://nginx.org/en/support.html . [訳文] .Pp 疑問や技術サポートの必要がある場合は、 .Pa http://nginx.org/en/support.html に問い合わせてください。 ---------------------------------------- [原文] .Sh HISTORY Development of .Nm started in 2002, with the first public release on October 4, 2004. [訳文] .Sh 開発経緯 .Nm の開発は 2002 年に開始しました。 初めての公開版は 2004 年 10 月 4 日にリリースしています。 ---------------------------------------- [原文] .Sh AUTHORS .An -nosplit .An Igor Sysoev Aq Mt igor****@sysoe***** . [訳文] .Sh 著者 .An -nosplit .An Igor Sysoev Aq Mt igor****@sysoe***** . ---------------------------------------- [原文] .Pp This manual page was originally written by .An Sergey A. Osokin Aq Mt osa****@FreeB***** as a result of compiling many .Nm documents from all over the world. [訳文] .Pp このマニュアルページは、 もともとは .An Sergey A. Osokin Aq Mt osa****@FreeB***** が、 世界中から寄せられた .Nm のドキュメントを取りまとめた結果として記述しました。 ----------------------------------------