svnserve(8)                                                                                                          svnserve(8)



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.

       --version
            Print svnserve's version and the repository filesystem back-end(s) a particular svnserve supports.

       -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.

       -R --read-only
            Force all write operations through this svnserve instance to be forbidden, overriding all other access  policy  con-
            figuration.   Do  not  use this option to set general repository access policy - that is what the conf/svnserve.conf
            repository configuration file is for.  This option should be used only to restrict access via a  certain  method  of
            invoking  svnserve  -  for  example,  to  allow  write access via SSH, but not via a svnserve daemon, or to create a
            restricted SSH key which is only capable of read access.

       -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.

       --config-file=filename
            When  specified, svnserve reads filename once at program startup and caches the svnserve configuration and any pass-
            words and authorization  configuration  referenced  from  filename.   svnserve  will  not  read  any  per-repository
            conf/svnserve.conf files when this option is used.  See the svnserve.conf(5) man page for details of the file format
            for this option.

       --pid-file=filename
            When specified, svnserve will write its process ID to filename.

       -X, --listen-once
            Causes svnserve to accept one connection on the svn port, serve it, and exit.  This  option  is  mainly  useful  for
            debugging.

       Unless the --config-file option was specified on the command line, once the client has selected a repository by transmit-
       ting 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.

SEE ALSO
       svnserve.conf(5)



                                                                                                                     svnserve(8)