Man Linux: Main Page and Category List

NAME

       davfs2.conf - Configuration file for mount.davfs

DESCRIPTION

       There  is  a system wide configuration file /etc/davfs2/davfs2.conf and
       user configuration files  ~/.davfs2/davfs2.conf.  When  mount.davfs  is
       invoked  by root, only the system wide configuration file is read. When
       invoked by an ordinary user, the user configuration  file  is  read  in
       addition.   Settings   from  the  user  configuration  file  will  take
       precedence over the system wide configuration.

       The configuration file consists of lines where  each  line  contains  a
       keyword  value  pair.  Keyword and value are seperated by spaces and/or
       tabs.

       The file may contain sections that are for  one  specific  mount  point
       only.   Such  a section starts with a line, that contains the full path
       of the mount point enclosed in square brackets. The section ends at the
       start  of the next section or the end of file. Options that shall apply
       to all mounted file system must come before the first sections. Options
       given in a mount specific section will have precedence.

EXAMPLE

       kernel_fs coda
       proxy     foo.bar:8080
       use_locks 0
       [/media/dav]
       use_locks 1
       [/home/otto/mywebspace]
       gui_optimize 1

       All  mounted  davfs2  file systems will use the coda kernel file system
       and the proxy foo.bar. All davfs2 file systems expect  /media/dav  will
       disable  the  use  of  the  locks.  /home/otto/mywebspace  will use the
       gui_optimize option.

GENERAL SYNTAX RULES

       Lines that only contain spaces and tabs (empty lines) are ignored.

       # indicates a comment. The rest of the line is ignored.

       \ is the escape character.

       "" is used for quotation.

       If a value contains one of the special characters space, tab, #, \,  or
       ", this character must be escaped by a preceding \. Use ’\ ’ instead of
       ’ ’, ’\#’ instead of ’#’, ’\\’ instead of ’\’ and ’\"’ instead of  ’"’.

       Values  containing  spaces, tabs or # may instead be enclosed in double
       quotes.  But " and ’ must be escaped even within double quotes. If  the
       starting  line  of  a  section is enclosed in double quotes, the square
       brakets must be within the quotes (like "[/home/otto/with space]").

       Boolean option values (yes/no) must be given as numerical value.  0 for
       no, 1 for yes.

AVAILABLE CONFIGURATION OPTIONS

General Options

       dav_user
              When  invoked  by  root  the mount.davfs daemon will run as this
              user.  Value must be given as name, not as numerical id.
              Default: davfs2
              Only allowed in the system wide configuration file.

       dav_group
              The group of the running mount.davfs daemon. Ordinary users must
              be  member of this group in order to mount a davfs2 file system.
              Value must be given as name, not as numerical id.
              Default: davfs2
              Only allowed in the system wide configuration file.

       ignore_home
              An ordinary user  is  not  allowed  to  mount  within  the  home
              directory  of  another  user.  But  sometimes system users (like
              nobody) get assigned home directories  (like  /),  that  include
              common  mount  points.  This  option  allows  to  give  a  comma
              seperated list of system users that will be excluded  from  this
              check.
              Only allowed in the system wide configuration file.

       kernel_fs
              Which  kernel  file system to use, to integrate into the virtual
              file system.  Possible values are fuse and coda.
              Default: fuse

       buf_size
              Size in KiByte of the buffer used to communicate with the kernel
              file  system.   Only  usefull  with  fuse,  where read and write
              operations may profit from a larger buffer.
              Default: 16

WebDAV Related Options

       use_proxy
              Whether to use a proxy to connect to the WebDAV server. 0 =  no,
              1 = yes.  If no proxy is defined in the configration file or the
              environment variables  https_proxy,  http_proxy  and  all_proxy,
              this option has no effect.
              Default: 1
              Only allowed in the system wide configuration file.

       proxy  Name  of  the proxy. The name must be the fully qualified domain
              name (no scheme). If the proxy port differs from the default  of
              8080,  it  must  be  appended,  seperated  by a colon. Examples:
              foo.bar:1704 or foo.bar
              Only allowed in the system wide configuration file.

       servercert
              Name of a certificate file in PEM format. The name of  the  file
              may  be  given  as  absolute  path  or as file name only. In the
              latter    case    the    directories     ~/.davfs2/certs     and
              /etc/davfs2/certs will be searched.
              This  option  is  intended  for self-signed server certificates.
              Self-signed means issuer and subject are the same.  Common  name
              (CN) must be the domain name of the server.
              In  case  the  server  certificate is not self-singed, this file
              must contain the certificate of the certificate  authority  (CA)
              that   signed   the  server  certificate,  not  the  the  server
              certificate itself. If an hirarchy of CA’s is involved  (the  CA
              that signed the server certificate is not the root CA), the file
              must  contain  all  the  certificates  from  the  chain  of  CAs
              involved,   beginning   with  the  CA  that  signed  the  server
              certificate, up to the self-signed certificate of the  root  CA.
              (The option name servertcert is a misnomer in this case. Sorry.)
              You can create the file by concatenating all the CA-certificates
              involved.
              Note:  Even if the certificate is trusted, that does not mean it
              is accepted.  There  is  the  additional  constraint,  that  the
              certificate  presented  by the server must belong to the server.
              The CN in the server certificate must be the domain name of  the
              server.  There  is  currently  no  way  to  automatically accept
              certificates that don’t belong to the server.

       clientcert
              Name of a certificate in PKCS#12 format that  will  be  used  to
              authenticate  with the server. The name of the file may be given
              as absolute path or as file name only. In the  latter  case  the
              directories              ~/.davfs2/certs/private             and
              /etc/davfs2/certs/private will be searched.

       secrets
              Name of a file that holds the credentials for  servers  and  the
              proxy, and passwords to decrypt the client certificate. The name
              must be an absolute path. The file must be read and writable  by
              the owner only (mode 600).
              Default: ~/.davfs2/secrets
              Only  allowed  in  the  user configuration file. The system wide
              secrets file is allways /etc/davfs2/secrets.

       ask_auth
              Ask the user interactively for credentials and passwords if  not
              found in the secretsfile. Ask the user if a servercert cannot be
              verified. 0 = no, 1 = yes.
              Default: 1

       use_locks
              Whether to lock files on the server when  they  are  opened  for
              writing.  0 = no, 1 = yes.
              Default: 1

       lock_owner
              A  string send to the server to identify the owner of a lock. If
              a WebDAV resource is used at the same time by different  clients
              using  the  same  credentials,  different  values for lock_owner
              should be choosen.
              Default: the username from the credentials

       lock_timeout
              How long in seconds locks should be  valid,  before  the  server
              removes  them.   The  server  may  ignore  this  and set its own
              timeout value.
              Default: 1800

       lock_refresh
              That many seconds before the lock times  out,  mount.davfs  will
              try  to  refresh  the  lock.  The  value should be substantially
              greater than delay_upload.
              Default: 60

       use_expect100
              To avoid  uploading big  files  that  will  be  refused  by  the
              server,  mount.davfs uses the header expect: 100-continue to get
              the o.k.  from the server  before  uploading.  Not  all  servers
              understand this.  0 = no, 1 = yes.
              Default: 0

       if_match_bug
              Some  servers  do  not handle If-Match and If-None-Match-headers
              correctly.  This otion tells mount.davfs to use HEAD instead  of
              thes headers.  0 = no, 1 = yes.
              Default: 0

       drop_weak_etags
              Popular  servers  send a weak etag whenever they are not able to
              calculate a strong one. This weak etag will never be valid,  but
              after  one  second  it  is  silently turned into a strong, valid
              etag. With this flag set to 1, mount.davfs will never  use  this
              weak  etags.  If  the  flag is 0, the weakness indicator will be
              removed and the etag is assumed to  be  strong.  There  is  some
              danger of the Lost-Update-Problem with this. But it is minimized
              when using locks.
              You should turn this on, when you can’t use locks and  there  is
              the  danger  of  concurrent access to the same resource. In this
              case the etag is not used at all  and  the  resource  cannot  be
              cached.
              0 = no, 1 = yes.
              Default: 0

       allow_cookie
              Some  servers  will  only  work  when  they are allowed to set a
              cookie and this cookie is returned in subsequent requests.  This
              option  adds  very  simple  cookie support. It supports just one
              cookie which should usually be a session ID.  0 = no, 1 = yes.
              Default: 0

       precheck
              If option if_match_bug is set: use HEAD-requests  to  check  for
              existence   or  modification  of  a  file  to  avoid  unintended
              overwriting what somebody else changed. Has no effect if  option
              if_match_bug  is  0.  You  should  only set it 0, if there is no
              concurrent access to the server.  0 = no, 1 = yes.
              Default: 1

       ignore_dav_header
              Some servers send wrong information about their capabilities  in
              the DAV-header.  In this case the header should be ignored.
              Default: 0

       server_charset
              When  extracting  file names from the path component of the URL,
              mount.davfs will assume they are encoded  using  this  character
              set and translate file names to the local character set. This is
              not about encoding of file contents and not about HTTP  escaping
              rules.
              There  is no means in HTTP to know the character encoding of the
              path component. There may be even different encodings within the
              same path, as the encoding of file names is often defined by the
              clients that created them.  Nowadays it  is  best  to  use  only
              UTF-8 encoding and to do no conversion. If you are not sure that
              all clients  understand  UTF-8,  restrict  file  names  to  pure
              us-ascii.  Never  use  characters in file names, that may have a
              special function on some operating systems (like /, : and \).
              Default: no character set conversion

       connect_timeout
              When creating a TCP connection to the  server  mount.davfs  will
              wait  that  many seconds for an answer before assuming an error.
              If a value of ’0’ is used then no explicit timeout  handling  is
              set  and  the  connect call will only timeout as dictated by the
              TCP stack.
              This parameter only takes effect if the version of neon  in  use
              (neon version > 0.26) and the OS support non-blocking I/O.
              Default: 10

       read_timeout
              How long in seconds mount.davfs will wait for an answer from the
              server before assuming an error.
              Default: 30

       retry  When mount.davfs can not reach the  server  it  will  try  again
              after retry seconds. For subsequent retries the interval will be
              increased up to max_retry seconds.
              Default: 30

       max_retry
              Maximum value of the retry interval.
              Default: 300

       max_upload_attempts
              When uploading a changed file fails temporarily mount.davfs will
              retry with increasing intervals, but not more often than this.
              With  a  bad  connection  this will cause additional traffic. To
              reduce  traffic   caused   by   unsuccessful   attempts   option
              use_expect100  can  be set. But please test it. Most proxies and
              some servers don’t support this header.
              Default: 15

       add_header
              Your server might expect special headers to do  what  you  want.
              Different  from  other  options,  this one takes two values: the
              name of the header and its value.  Some ASP-backends to IIS seem
              to require the Microsoft specific header "Translate: F". You can
              add it like this:
              add_header Translate F
              mount.davfs will add header "Translate: F" on all requests.
              This  option  is  cumulative.  You  can  enter  more  than   one
              add_header option and all of them will be added. Also add_header
              options from /etc/davfs2/davfs2.conf  and  ~/.davfs2/davfs2.conf
              are merged.

Cache Related Options

       backup_dir
              Each mounted davfs2 file system has a directory to store backups
              of files that could not be stored back to the server. This  sets
              the  name  of  this  directory.  You should regularly check this
              directory.
              Default: lost+found

       cache_dir
              The directory where mount.davfs will  store  cached  files.  For
              every mount point a subdirectory will be created.
              In  the  systemwide  configuration file this will set the system
              wide cache, used by root. In a users configuration file it  will
              set the cache used by this user.
              Defaults: /var/cache/davfs2 and ~/.davfs2/cache

       cache_size
              The amount of disk space in MiByte that may be used. mount.davfs
              will always take enough space to cache open files, ignoring this
              value if necessary.
              Default: 50

       table_size
              mount.davfs  maintains a hash table with an entry for each known
              file or directory. This gives the  number  of  entries  in  this
              table. For large file systems (more than some hundreds of files)
              increasing this number may speed up file operations.  The  value
              should be a power of 2.
              Default: 1024

       dir_refresh
              After mount.davfs has got information about files in a directory
              it considers it valid for this time in seconds. Note: This  does
              not  affect  opening  of  files  and  reading  a directory by an
              application.
              Default: 60

       file_refresh
              When  a  file  or  directory  is  opened  by   an   application,
              mount.davfs will first check the server for a newer version. But
              some applications do open  calls  on  the  same  file  in  short
              sequence. To avoid unecessary traffic mount.davfs will wait that
              many  seconds  before  it  send  a  new  request  for  the  same
              information.
              Default: 1

       delay_upload
              When  a  file  that has been changed is closed, mount.davfs will
              wait that many seconds before it will upload it to  the  server.
              This  will  avoid  uploading  of  temporary  files  that will be
              removed immediately after closing.  If you  need  the  files  to
              appear  on the server immediately after closing, set this option
              to 0.
              Default: 10

       gui_optimize
              When a file is opened, mount.davfs will have to check the server
              whether there is a newer version. Graphical User Interfaces tend
              to open just any file,  slowing  down  things  dramatically  for
              large directories.  With this option mount.davfs will try to get
              this information from all files in a directory with one PROPFIND
              request. 0 = no, 1 = yes.
              Default: 0

Debugging Options

       debug  Send  debug  messages to the syslog daemon. The value tells what
              kind of information shall be logged. The messages are send  with
              facility  LOG_DAEMON and priority LOG_DEBUG. It depends from the
              configuration of the syslog daemon where the  messages  will  go
              (propably       /var/log/messages,       /var/log/syslog      or
              /var/log/daemon.log). Whether HTTP related  debug  messages  are
              available depends on your neon library.
              Unlike  other  options,  this option is cumulative. If there are
              several debug entries with different values, all of them will be
              applied.  Also  debug  options  from /etc/davfs2/davfs2.conf and
              ~/.davfs2/davfs2.conf are merged.
              Note: Debug messages let the log-files grow quickly.  Never  use
              this option in normal operation of mount.davfs.
              Default: no debugging messages

              Recognized values:

              config Command line and configuration options.

              kernel Upcalls from the kernel file system.

              cache  Cache operations like adding and removing nodes.

              http   HTTP headers.

              xml    Parsing of the XML-body of WebDAV-requests.

              httpauth
                     Negotiation of authentication.

              locks  Information about locks.

              ssl    TLS/SSL related stuff like certificates.

              httpbody
                     Complete body of HTTP-responses.

              secrets
                     Also  print  confidential  information,  which is usually
                     omitted or obscured.

              most   Includes config, kernel, cache and http.

AUTHORS

       This    man    page    was    written    by    by    Werner     Baumann
       <werner.baumann@onlinehome.de>.

DAVFS2 HOME

       http://savannah.nongnu.org/projects/davfs2

SEE ALSO

       mount.davfs(8), umount.davfs(8), mount(8), umount(8), fstab(5)