La commande svnserve permet les accès aux dépôts Subversion en utilisant le protocole réseau sur mesure de Subversion.
Vous pouvez faire tourner svnserve en tant
que serveur autonome (pour les clients qui utilisent la méthode
d'accès svn://) ; Vous pouvez aussi avoir
un démon tel que inetd ou xinetd
qui le lance pour vous à la demande (encore pour
svn://) ou vous pouvez avoir
sshd qui le lance à la demande pour les clients
qui utilisent la méthode d'accès svn+ssh://.
Quelle que soit la méthode d'accès, une fois que le client a
choisi un dépôt en spécifiant son URL, svnserve
lit le fichier conf/svnserve.conf dans le
répertoire du dépôt pour déterminer les réglages spécifiques au
dépôt tels que la base de données d'authentification à utiliser ou
quelle politique de contrôle d'accès appliquer. Reportez-vous à
la section intitulée « svnserve, un serveur sur mesure » pour les détails
relatifs au fichier svnserve.conf.
Au contraire des commandes décrites précédemment, svnserve ne possède pas de sous-commande, il est entièrement contrôlé par les options.
--daemon (-d)
Lance svnserve en mode démon.
svnserve passe en arrière-plan et
répond aux connexions TCP/IP sur le port
svn (3690 par défaut).
--foreground
Quand elle est utilisée avec l'option
-d, indique à svnserve
de rester en avant-plan. Cette option est principalement
utilisée à des fins de débogage.
--inetd (-i)
Indique à svnserve d'utiliser
l'entrée standard (stdin) et la
sortie standard (stdout), comme
requis pour une utilisation avec inetd.
--help (-h)
Affiche un court descriptif du programme et sort.
--listen-host=HOTE
Indique à svnserve d'écouter sur
l'interface spécifiée par HOTE,
qui peut être soit une adresse IP soit un nom d'hôte.
--listen-once (-X)
Indique à svnserve d'accepter une
connexion sur le port svn, d'y répondre
puis de se terminer. Cette option est principalement
utilisée à des fins de débogage.
--listen-port=PORT
Indique à svnserve d'écouter le
port PORT quand il fonctionne
en tant que démon (les démons FreeBSD n'écoutent par défaut
que sur les adresses IPv6 — Cette option indique
d'écouter également sur les adresses IPv4).
--pid-file NOM_FICHIER
Indique à svnserve d'écrire son
identifiant de processus dans
NOM_FICHIER ; l'utilisateur
sous lequel svnserve tourne doit
avoir le droit d'écrire dans ce fichier.
--root=RACINE
(-r=RACINE)
Définit la racine virtuelle pour les dépôts accessibles par svnserve. Les chemins dans les URL fournies par le client seront interprétés relativement à cette racine et le client ne pourra pas sortir de cette arborescence.
--threads (-T)
Quand il fonctionne en mode démon, indique à svnserve de créer un processus léger (thread) plutôt qu'un nouveau processus pour chaque connexion (par exemple lors d'un fonctionnement sous Windows). Le processus svnserve passe toujours en arrière-plan au démarrage.
--tunnel (-t)
Indique à svnserve de fonctionner
en mode tunnel, qui est le même que le mode de
fonctionnement que inetd : les
deux modes répondent aux connexions sur l'entrée et la
sortie standards (stdin/stdout)
puis terminent, sauf que la connexion est considérée comme
déjà authentifiée (l'identifiant correspond à l'UID
courant). Ce drapeau est passé automatiquement pour vous
par le client quand il utilise un tunnel tel que le
programme ssh. Cela signifie que vous
aurez rarement le besoin de passer cette option
vous-même à
svnserve. Aussi, si vous vous
surprenez à taper svnserve --tunnel sur
une ligne de commande et que vous vous demandez quoi faire
par la suite, reportez-vous à
la section intitulée « Encapsulation de svnserve dans un tunnel SSH ».
--tunnel-user NOM
Utilisée en conjonction avec l'option
--tunnel, indique à
svnserve que
NOM est l'utilisateur
authentifié, plutôt que l'UID du processus
svnserve. Cette option est utile pour
les utilisateurs qui souhaitent partager un compte unique
pour SSH, mais qui veulent continuer à avoir des identités
différentes pour les propagations.
--version
Affiche les informations de version ainsi que la liste des modules d'accès aux dépôts disponibles, puis se termine.