Provided by: davfs2_1.3.3-1ubuntu1_i386 bug

NAME

       davfs2.conf - Configuration file for mount.davfs

DESCRIPTION

       There is a system wide configuration file /var/cache/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. 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: 1

       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: 1 (this bug is in the most widely used HTTP-server)

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

       use_displayname
              Create  file names from the displayname property if available. 0
              = no, 1 = yes.  Note: the character encoding of  displayname  is
              known and will always be converted to the local character set.
              Default: 0
              Deprecated:  This  option  will  be  removed in future versions.
              Despite its name, it is not a name but some arbitrary  text  and
              is  not required to be unique (RFC 4918, 15.2). It is completely
              useless for a file system. Please send a bug report if you think
              you need it.

       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

       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.  Example:
              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  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
       <wbaumann@users.sourceforge.net>.

DAVFS2 HOME

       http://dav.sourceforge.net/

SEE ALSO

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