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.

Nom

svnserve — Offrir l'accès aux dépôts Subversion via un protocole réseau sur mesure.

Synopsis

svnserve [-d | -i | -t | -X] OPTIONS...

Description

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.

Options

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.