Provided by: davfs2_1.4.7-3_amd64 bug

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.

       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)