svnserve(8) svnserve(8)

NAME
       svnserve - Server for the 'svn' repository access method

SYNOPSIS
       ssvvnnsseerrvvee [options]

DESCRIPTION
       ssvvnnsseerrvvee 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
       ssvvnnsseerrvvee.  The following options are recognized:


       -dd, --ddaaeemmoonn
            Causes ssvvnnsseerrvvee to  run  in  daemon  mode.   ssvvnnsseerrvvee  backgrounds
            itself  and  accepts and serves TCP/IP connections on the svn port
            (3690, by default).


       --lliisstteenn-ppoorrtt=port
            Causes ssvvnnsseerrvvee to listen on port when run in daemon mode.


       --lliisstteenn-hhoosstt=host
            Causes ssvvnnsseerrvvee to listen on  the  interface  specified  by  host,
            which may be either a hostname or an IP address.


       --ffoorreeggrroouunndd
            When used together with -dd, this option causes ssvvnnsseerrvvee to stay in
            the foreground.  This option is mainly useful for debugging.


       -ii, --iinneettdd
            Causes ssvvnnsseerrvvee to use the stdin/stdout file  descriptors,  as  is
            appropriate for a daemon running out of inetd.


       -hh, --hheellpp
            Displays a usage summary and exits.


       -rr root, --rroooott=root
            Sets  the  virtual  root for repositories served by ssvvnnsseerrvvee.  The
            pathname in URLs provided by the client will be interpreted  rela-
            tive to this root, and will not be allowed to escape this root.


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


       -tt, --ttuunnnneell
            Causes ssvvnnsseerrvvee 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.


       --ttuunnnneell-uusseerr=username
            When combined with --ttuunnnneell, overrides the pre-authenticated user-
            name  with  the  supplied username.  This is useful in combination
            with the ssh authorizedkey file's "command" directive to allow  a
            single system account to be used by multiple committers, each hav-
            ing a distinct ssh identity.


       -TT, --tthhrreeaaddss
            When running in daemon mode, causes ssvvnnsseerrvvee  to  spawn  a  thread
            instead  of  a  process for each connection.  The ssvvnnsseerrvvee process
            still backgrounds itself at startup time.


       -XX, --lliisstteenn-oonnccee
            Causes ssvvnnsseerrvvee 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,
       ssvvnnsseerrvvee reads a file named ccoonnff//ssvvnnsseerrvvee..ccoonnff in the repository direc-
       tory to determine repository-specific settings such as what authentica-
       tion database to use and what authorization policies to apply.  See the
       ssvvnnsseerrvvee..ccoonnff(5) man page for details of that file format.




                                                                   svnserve(8)