Provided by: davfs2_1.2.1-3ubuntu1_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 fuse
       proxy     foo.bar:8080
       use_displayname 0
       [/media/dav]
       use_displayname 1
       [/home/otto/mywebspace]
       use_locks 0

       All  mounted  davfs2  file systems will use the fuse kernel file system
       and the proxy foo.bar. All davfs2 file systems expect  /media/dav  will
       disable   the   use   of  the  displayname  property  for  file  names.
       /home/otto/mywebspace will not use locks.

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: coda

       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: 8

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 files or
              the environment variable http_proxy, this option has no  effect.
              Default: 1

       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

       servercert
              Name of a certificate file in PEM format. When a server presents
              this  cerificate it will be trusted without trying to verify it.
              You should only use this  for  certificates  you  have  verified
              yourself. Usefull for servers that use a selfsigned certificate,
              if you know and trust the administrator.  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.

       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 idle_time.
              Default: 60

       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.  0 = no, 1 = yes.
              Default: 0

       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.
              Default: 1

       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: 1

       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

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 hundrets of files)
              increasing  this  number may speed up file operations. The value
              should be a power of 2.
              Default: 1024

       idle_time
              mount.davfs tries to save back files on to the server and  clean
              the cache when there are no upcalls from the kernel file system.
              This is the time in seconds it will wait since the  last  upcall
              before  it starts this task.  Setting this value very short will
              increase the use of processor time.
              Default: 10

       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

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)