Ubuntu Manpage: davfs2.conf - Configuration file for mount.davfs

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