.\"
.\"
.\"     Licensed to the Apache Software Foundation (ASF) under one
.\"     or more contributor license agreements.  See the NOTICE file
.\"     distributed with this work for additional information
.\"     regarding copyright ownership.  The ASF licenses this file
.\"     to you under the Apache License, Version 2.0 (the
.\"     "License"); you may not use this file except in compliance
.\"     with the License.  You may obtain a copy of the License at
.\"       http://www.apache.org/licenses/LICENSE-2.0
.\"     Unless required by applicable law or agreed to in writing,
.\"     software distributed under the License is distributed on an
.\"     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
.\"     KIND, either express or implied.  See the License for the
.\"     specific language governing permissions and limitations
.\"     under the License.
.\"
.\"
.\" You can view this file with:
.\" nroff -man [filename]
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\"
.\" translated for 1.14.2, 2022-04-11 ribbon <ribbon@users.osdn.me>
.\"
.TH svnserve 8   
.SH 名前
svnserve \- 'svn' リポジトリアクセス方式に対応するサーバー
.SH 書式
.TP 
\fBsvnserve\fP [\fIoptions\fP]
.SH 説明
\fBsvnserve\fP は、 ネットワークプロトコル svn を使って、 Subversion リポジトリへのアクセスを行います。
これはスタンドアロンのサーバープロセスとして実行可能であり、 また inetd を使って実行することも可能です。 \fBsvnserve\fP
を実行する際には、 操作モードを選んでおく必要があります。 以下に示すオプションが用いられます。
.PP
.TP  5
\fB\-d\fP, \fB\-\-daemon\fP
\fBsvnserve\fP をデーモンモードで起動します。 \fBsvnserve\fP がバックグラウンドで実行されて、 svn ポート (デフォルトで
3690) 上から TCP/IP 接続を受け付け、 また提供します。
.PP
.TP  5
\fB\-\-listen\-port\fP=\fIport\fP
デーモンモードでの実行時に、 \fBsvnserve\fP が待ち受ける \fIport\fP を指定します。
.PP
.TP  5
\fB\-\-listen\-host\fP=\fIhost\fP
\fIhost\fP によって指定されるインターフェースから \fBsvnserve\fP が待ち受けるようにします。 指定にあたっては、 ホスト名または IP
アドレスを用います。
.PP
.TP  5
\fB\-\-foreground\fP
\fB\-d\fP とともに用いることで、 \fBsvnserve\fP をフォアグラウンド実行のままとします。
このオプションは主にデバッグ目的で利用することができます。
.PP
.TP  5
\fB\-i\fP, \fB\-\-inetd\fP
\fBsvnserve\fP が stdin/stdout ファイルディスクリプターを用いるようにします。 inetd
からデーモン実行する場合に適しています。
.PP
.TP  5
\fB\-h\fP, \fB\-\-help\fP
使用方法の概要を示して終了します。
.PP
.TP  5
\fB\-\-version\fP
\fBsvnserve\fP のバージョンを表示します。 また特定の \fBsvnserve\fP
がサポートするリポジトリのファイルシステムバックエンドを表示します。
.PP
.TP  5
\fB\-r\fP \fIroot\fP, \fB\-\-root\fP=\fIroot\fP
\fBsvnserve\fP が提供するリポジトリの仮想ルートを設定します。 クライアントから指定される URL 内のパス名は、
このルートからの相対パスとして解釈されます。 このルート以外をアクセスすることはできません。
.PP
.TP  5
\fB\-R\fP \fB\-\-read\-only\fP
この \fBsvnserve\fP インスタンスを通じて行われる書き込み操作を、 強制的にすべて禁止します。 これは、
アクセスポリシーを定めた設定を上書きします。 このオプションは、 通常のリポジトリアクセスポリシーには用いないでください。 それを行うのは、
リポジトリ設定ファイル \fBconf/svnserve.conf\fP です。 このオプションは、 特定の方法によって起動した \fBsvnserve\fP
に対しての限定的なアクセス時に用いてください。 たとえば書き込みアクセスを \fBsvnserve\fP デーモン経由ではなく、 SSH
経由で行うような場合です。 あるいは、 読み込みアクセスにのみ利用する限定的な SSH 鍵を生成して利用するような場合です。
.PP
.TP  5
\fB\-t\fP, \fB\-\-tunnel\fP
トンネルモード (tonnel mode) により \fBsvnserve\fP を実行します。 これは inetd モードによる動作に似ています
(stdin/stdout を通じて一接続を提供します)。 ただしその際の接続は、 現在の uid によるユーザー名を使い、
あらかじめ事前承認されたものとして動作する点が異なります。 トンネルエージェントを介して動作しているクライアントにより、 本フラグが選択されます。
.PP
.TP  5
\fB\-\-tunnel\-user\fP=\fIusername\fP
\fB\-\-tunnel\fP とともに組み合わせて、 事前承認されたユーザー名を、 指定された \fIusername\fP によって上書きします。 これは ssh
の authorized_key ファイルにある "command" ディレクティブと合わせて用いると便利です。 複数のコミットユーザーが、
単一のシステムアカウントを利用するようなことが可能になります。 この場合、 ssh の認証は別々のものとなります。
.PP
.TP  5
\fB\-T\fP, \fB\-\-threads\fP
デーモンモードでの実行時に、 \fBsvnserve\fP が各接続に対してプロセスを実行するのではなく、 スレッドを実行するようにします。
\fBsvnserve\fP プロセスは、 起動直後にバックグラウンド実行されて起動し続けます。
.PP
.TP  5
\fB\-\-config\-file\fP=\fIfilename\fP
これが指定されると、 \fBsvnserve\fP は起動時に一度だけ \fIfilename\fP の内容を読み込み、 \fBsvnserve\fP
設定としてキャッシュします。 パスワードと認証の設定は \fIfilename\fP から参照されますが、 各接続ごとにロードされます。
このオプションが指定された場合、 \fBsvnserve\fP はリポジトリごとの \fBconf/svnserve.conf\fP ファイルは読み込みません。
\fBsvnserve.conf\fP(5) ファイルにおける本オプションの書式については、 その man ページを参照してください。
.PP
.TP  5
\fB\-\-pid\-file\fP=\fIfilename\fP
これを指定した場合、 \fBsvnserve\fP はプロセス ID を \fIfilename\fP に書き出します。
.PP
.TP  5
\fB\-X\fP, \fB\-\-listen\-once\fP
\fBsvnserve\fP が svn ポートからのアクセスを 1 度だけ行い、 それに対する返信を行って終了します。
このオプションは主にデバッグ目的で利用することができます。
.PP
\fB\-\-config\-file\fP オプションがコマンドラインから指定されなかった場合には、 クライアントから URL
送信によってリポジトリが選択された際に、 \fBsvnserve\fP はリポジトリ内の \fBconf/svnserve.conf\fP
というファイルを読み込みます。 このファイルは、 利用する認証データベースや認可ポリシーなど、 リポジトリ固有の設定を定めるものです。
\fBsvnserve.conf\fP(5) のファイルフォーマットの詳細は、 その man ページを参照してください。
.SH 関連項目
\fBsvnserve.conf\fP(5)