svnserve 中文man頁面
NAME
svnserve - 使用 `svn' 訪問倉庫時的服務(wù)器
SYNOPSIS 總覽
- svnserve [options]
DESCRIPTION 描述
svnserve 允許使用 svn 網(wǎng)絡(luò)協(xié)議訪問 Subversion 倉庫。它可以運行為獨立的服務(wù)器進(jìn)程,也可以在 xinetd 控制下運行。在啟動 svnserver 時,必須選擇操作的模式。下列選項也被識別:
- -d, --daemon
- 使得 svnserve 以守護(hù)進(jìn)程方式運行。svnserve 使自身運行在后臺,在 svn 端口 (默認(rèn)是 3690) 監(jiān)聽并提供服務(wù)。
- --listen-port=port
- 使得 svnserve 在以守護(hù)進(jìn)程方式運行時監(jiān)聽 port 端口。
- --listen-host=host
- 使得 svnserver 監(jiān)聽 host 指定的接口,可以是一個主機(jī)名或是一個 IP 地址。
- --foreground
- 當(dāng)與 -d 一同使用時,這個選項使得 svnserve 在前臺運行。這個選項主要用于調(diào)試。
- -i, --inetd
- 使得 svnserve 使用標(biāo)準(zhǔn)輸入/標(biāo)準(zhǔn)輸出文件描述符,當(dāng)它在 xinetd 控制下運行時應(yīng)該這樣做。
- -h, --help
- 顯示用法信息,然后退出。
- -r root, --root=root
- 為它提供服務(wù)的所有倉庫設(shè)置虛根目錄。客戶端給出的 URL 中的路徑名將被解釋為相對于此 “根” 目錄的路徑,不允許超出根目錄的范圍。
- -t, --tunnel
- 使得 svnserver 運行于隧道模式,操作與 xinetd 模式類似 (在標(biāo)準(zhǔn)輸入/標(biāo)準(zhǔn)輸出提供一個連接),但是將連接視為已認(rèn)證的,認(rèn)證用戶就是當(dāng)前的 uid。這個選項是在客戶端運行于一個隧道代理上時使用。
- -T, --threads
- 當(dāng)運行在守護(hù)進(jìn)程模式時,使得 svnserve 為每個連接產(chǎn)生新線程而不是新進(jìn)程。svnserve 進(jìn)程在啟動時仍然將自身放到后臺。
- -X, --listen-once
- 使得 svnserve 接受 svn 端口的一個連接,提供服務(wù),然后退出。這個選項主要用于調(diào)試。
一旦客戶端通過傳遞 URL 選擇了一個倉庫,snvserve 讀取這個倉庫中名為 conf/svnserve.conf 的文件,判斷特定于倉庫的設(shè)置信息,例如使用什么認(rèn)證數(shù)據(jù)庫,接受什么樣的認(rèn)證規(guī)則。參見 svnserve.conf(5) 來查看文件格式的詳細(xì)信息。
#p#
NAME
svnserve - Server for the 'svn' repository access method
SYNOPSIS
- svnserve [options]
DESCRIPTION
svnserve allows access to Subversion repositories using the svn network protocol. It can both run as a standalone server process, or it can run out of inetd. You must choose a mode of operation when you start svnserve. The following options are recognized:
- -d, --daemon
- Causes svnserve to run in daemon mode. svnserve backgrounds itself and accepts and serves TCP/IP connections on the svn port (3690, by default).
- --listen-port=port
- Causes svnserve to listen on port when run in daemon mode.
- --listen-host=host
- Causes svnserve to listen on the interface specified by host, which may be either a hostname or an IP address.
- --foreground
- When used together with -d, this option causes svnserve to stay in the foreground. This option is mainly useful for debugging.
- -i, --inetd
- Causes svnserve to use the stdin/stdout file descriptors, as is appropriate for a daemon running out of inetd.
- -h, --help
- Displays a usage summary and exits.
- -r root, --root=root
- Sets the virtual root for repositories served by svnserve. The pathname in URLs provided by the client will be interpreted relative to this root, and will not be allowed to escape this root.
- -t, --tunnel
- Causes svnserve to run in tunnel mode, which is just like the inetd mode of operation (serve one connection over stdin/stdout) except that the connection is considered to be pre-authenticated with the username of the current uid. This flag is selected by the client when running over a tunnel agent.
- --tunnel-user=username
- When combined with --tunnel, overrides the pre-authenticated username with the supplied username. This is useful in combination with the ssh authorized_key file's "command" directive to allow a single system account to be used by multiple committers, each having a distinct ssh identity.
- -T, --threads
- When running in daemon mode, causes svnserve to spawn a thread instead of a process for each connection. The svnserve process still backgrounds itself at startup time.
- -X, --listen-once
- Causes svnserve to accept one connection on the svn port, serve it, and exit. This option is mainly useful for debugging.
Once the client has selected a repository by transmitting its URL, svnserve reads a file named conf/svnserve.conf in the repository directory to determine repository-specific settings such as what authentication database to use and what authorization policies to apply. See the svnserve.conf(5) man page for details of that file format.