This text is a work in progress—highly subject to change—and may not accurately describe any released version of the Apache™ Subversion® software. Bookmarking or otherwise referring others to this page is probably not such a smart idea. Please visit http://www.svnbook.com/ for stable versions of this book.
svnserve — Offrir l'accès aux dépôts Subversion via un protocole réseau sur mesure.
svnserve [-d | -i | -t | -X] OPTIONS...
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 (aussi
pour svn://
) ou vous pouvez avoir
sshd qui le lance à la demande pour les clients
utilisant la méthode d'accès svn+ssh://
.
À moins que l'option --config-file
ne soit
spécifiée sur la ligne de commande, 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, elle est entièrement contrôlée par les options.
--cache-fulltexts
ARG
Activer la fonctionnalité de mise en cache du contenu des fichiers textes (ne concerne que les dépôts FSFS).
--cache-txdeltas
ARG
Activer la fonctionnalité de mise en cache des deltas de fichiers (ne concerne que les dépôts FSFS).
--compression
NIVEAU
Spécifie le niveau de compression utilisé pour les
transmissions sur le réseau par un entier compris entre 0 et 9
inclus. Une valeur de 9
offre la compression
la plus élevée, 5
est la valeur par défaut
et 0
interdit la compression.
--config-file
NOM_FICHIER
Lorsque spécifiée, svnserve lit le
fichier NOM_FICHIER
au démarrage du
programme et garde en cache la configuration de
svnserve. Les configurations référencées
dans le fichier pour les mots de passe et le contrôle d'accès
sont lues à chaque connexion. svnserve
ne lit aucun fichier de configuration
conf/svnserve.conf
spécifique à un dépôt
lorsque cette option est utilisée. Reportez-vous à
la section intitulée « svnserve, un serveur sur mesure » pour les détails du
format de fichier spécifique à cette option.
--daemon
(-d
)
Lancer 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
)
Afficher un court descriptif du programme et sortir.
--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
)
Accepter une connexion sur le port svn
,
y répondre puis terminer. Cette option est principalement
utilisée à des fins de débogage.
--listen-port
PORT
Écouter le port PORT
quand
svnserve 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).
--log-file
NOM_FICHIER
Créer (si nécessaire) et utiliser le fichier
NOM_FICHIER
pour stocker les journaux de
Subversion, sous le même format que ceux produits par
mod_dav_svn. Voir
la section intitulée « Journalisation du haut-niveau » pour
les détails.
--memory-cache-size
(-M
) ARG
Configure la taille (en mégaoctets) de la mémoire cache
utilisée pour diminuer les opérations redondantes (ce cache ne
concerne que les dépôts FSFS). La valeur par défaut est
16
.
--pid-file
NOM_FICHIER
Écrire l'identifiant de processus utilisé dans
NOM_FICHIER
; l'utilisateur
sous lequel svnserve tourne doit
avoir le droit d'écrire dans ce fichier.
--prefer-ipv6
(-6
)
Lors de la résolution du nom d'hôte pour l'écoute de port, préférer une réponse en IPv6 par rapport à une réponse IPv4. IPv4 est préféré par défaut.
--quiet
Désactiver les notifications sur l'avancement du déroulement du programme. Les erreurs sont toujours affichées.
--root
(-r
) RACINE
Définir la racine virtuelle pour les dépôts accessibles par svnserve. Les chemins dans les URL fournies par le client sont interprétés relativement à cette racine et le client ne peut pas sortir de cette arborescence.
--threads
(-T
)
En fonctionnement en mode démon, 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
)
Fonctionner en mode tunnel, qui est le même que le mode de
fonctionnement de 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
Afficher les informations de version ainsi que la liste des modules d'accès aux dépôts disponibles, puis terminer.