Provided by: davfs2_1.5.5-1ubuntu0.1_amd64 
NOMBRE
davfs2.conf - Archivo de Configuración para mount.davfs
DESCRIPCIÓN
Hay un archivo de configuración general /etc/davfs2/davfs2.conf y archivos de configuración propios del
usuario ~/.davfs2/davfs2.conf. Cuando mount.davfs es invocado como root, sólo el archivo de configuración
general es leído. Cuando es invocado por un usuario normal, el archivo de configuración del usuario es
leído adicionalmente. Las configuraciones del archivo de configuración del usuario tienen precedencia
sobre el archivo de configuración general.
The configuration file consists of lines where each line contains a keyword value pair. Keyword and value
are separated by spaces and/or tabs.
El archivo puede tener secciones que son aplicables solamente para un punto de montaje específico. Esta
sección empieza con una línea, que contiene la ruta completa del punto de montaje entre corchetes. La
sección termina cuando empieza la siguiente sección o cuando termina el archivo. Las opciones que deban
aplicarse a todas los sistemas de archivos montados deben ir antes de la primer sección. Las opciones
dadas en la sección específica tendrán precedencia.
EJEMPLO
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 except /media/dav will disable the use of the locks. /home/otto/mywebspace will use the
gui_optimize option.
REGLAS SINTÁCTICAS GENERALES
Líneas que sólo contienen espacios y tabs (líneas vacías) son ignoradas.
# indica un comentario. El resto de la línea es ignorada.
\ es el caracter de escape.
"" es usado para citar.
Si el parámetro contiene algún caracter especial como espacio, tab, #, \, o ", éste debe ser escapado por
el prefijo \. Use ’\ ’ en vez de ’ ’, ’\#’ en vez de ’#’, ’\\’ en vez de ’\’ y ’\"’
Valores que contengan espacios, tabs o # deben referirse entre comillas dobles. Pero " y ’ deben
escaparse incluso cuando están entre comillas dobles. Si la línea inicial de la sección está entre
comillas, los corchetes deben ir con las comillas (por ejemplo, "[/home/otto/con espacios]").
Opciones con valores booleanos deben ser dados como valores numéricos. 0 para no, 1 para sí.
OPCIONES DE CONFIGURACIÓN DISPONIBLES
Opciones Generales
dav_user
Cuando el demonio mount.davfs sea invocado como root correrá con éste usuario. El valor deber ser
dado como un nombre_de_usuario, no como un id numérico.
Predeterminado: davfs2
Sólo permitido en el archivo general de configuración del sistema.
dav_group
El grupo con el que corre el demonio mount.davfs. Los usuarios normales deben ser miembros de este
grupo para poder montar un sistemas de archivos @PACKAGES@. El valor debeser dado como un
nombre_de_grupo, no como un id numérico.
Predeterminado: davfs2
Sólo permitido en el archivo general de configuración del sistema.
kernel_fs
Qué sistema de archivos del kernel utilizar para integrar con el sistema de archivos virtual. Los
posibles valores son fuse y coda.
Predeterminado: fuse
buf_size
Size in KiByte of the buffer used to communicate with the kernel file system. Only useful with
fuse, where read and write operations may profit from a larger buffer.
Predeterminado: 16
Opciones Relacionadas con WebDAV
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.
Predeterminado: 1
Sólo permitido en el archivo general de configuración del sistema.
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, separated by a colon. Examples:
foo.bar:1704 or foo.bar
Sólo permitido en el archivo general de configuración del sistema.
trust_ca_cert
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 useful when the certificate presented by the server cannot be verified using the
system's data base of trusted certificate authorities (CA). The certificate file must contain the
self-signed certificate of the top level CA in the chain of trust. It may be a self-signed server
certificate (but see also trust_server_cert). With this option the system's CA data base is
ignored.
Note: Even if the server's certificate is trusted that does not mean it is accepted. Additionally
the certificate's date must be valid and either the CommonName or the SubjectAltName must match
the host name of the server.
servercert
Same as trust_ca_cert but badly named.
Deprecated
trust_server_cert
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.
Useful when the server's certificate can't be verified or is even invalid, but you know that you
can trust this certificate. When the server presents a certificate that is exactly equal to this
one and when the server is able to authenticate against the public key contained in this
certificate the connection will be established.
This is the preferred option for self signed server certificates.
No other ways to verify the certificate will be tried and the certificate will not be checked for
validity.
clientcert
El nombre de un certificado en formato PKCS#12 que será utilizado para autenticarse con el
servidor. El nombre del archivo puede ser dado como un camino absoluto o, simplemente, como el
nombre de archivo. En el caso anterior, los directorios ~/.davfs2/certs/private y
/etc/davfs2/certs/private serán buscados.
Warning: If the client certificate is issued by an intermediary CA and not by a top level CA then
the TLS-specification requires the client to send the complete chain of certificates (without the
top level CA-certificate). davfs2 only sends the client certificate. To work around this bug the
server must store and trust the complete chain of CA-certificates down to the one CA that isssued
the client certificate.
secrets
Nombre de archivo que contiene las credenciales de los servidores y del proxy, y contraseñas para
descifrar el certificado cliente. El nombre debe ser un camino absoluto. El archivo debe ser
legible y escribible únicamente por el dueño (modo 600).
Predeterminado: ~/.davfs2/secrets
Only allowed in the user configuration file. The system wide secrets file is always
/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.
Predeterminado: 1
use_locks
Si deben ser bloqueados los archivos en el servidor cuando son abiertos para escritura. 0 = no, 1
= sí.
Predeterminado: 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 chosen.
Predeterminado: el nombre de usuario utilizado en las credenciales
lock_timeout
Durante cuanto tiempo, en segundos, se considerará válido, antes de que el servidor los remueva.
El servidor puede ignorar este valor y tomar su propio valor de timeout.
Predeterminado: 1800
lock_refresh
Cuantos segundos antes del tiempo de bloqueo, mount.davfs intentarárefrescar el bloqueo. El valor
deberá ser sustancialmente más grande que delay_upload.
Predeterminado: 60
use_expect100
Para evitar subir archivos grandes que puede ser rechazados por el servidor, mount.davfs usa el
encabezado expect: 100-continue para obtener la confirmación del servidor antes de la subida. No
todos los servidores entienden esto. 0 = no, 1 = sí.
Predeterminado: 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.
Predeterminado: 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 = sí.
Predeterminado: 0
n_cookies
Some servers will only work when they are allowed to set a cookie and this cookie is returned in
subsequent requests. This option sets the number of cookies you are willing to accept and include
in subsequent requests. davfs2 will only care for the name and the value of the cookie and ignore
all of the possible attributes.
Predeterminado: 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.
Predeterminado: 1
ignore_dav_header
Some servers send wrong information about their capabilities in the DAV-header. In this case the
header should be ignored.
Predeterminado: 0
use_compression
Use gzip-compression for downloading files, if supported by the server. Uploads will still be
uncompressed.
Predeterminado: 0
min_propset
Some servers are reported to significantly slow down when the Etag and Last-Modified properties
are requested. This option will reduce the set of WebDAV-properties requested from the server to
the minimal set. Don't use it if your file system is used for reading and writing. Without Etag or
Last-Modified davfs2 will not be able to check for changes on the server which may result in
unnecessary downloads and lost updates. This option will also effectively disable caching of files
because files in the cache can't be reused.
Predeterminado: 0
follow_redirect
If the server redirects a GET-request to a different resource (maybe on a different server) then
follow this redirection.
Currently there are some restrictions: all redirects are treated as temporary redirects; if the
new server requires authentication then the same credentials are use as for the original server;
if the connection is over TLS the server certificate will be checked against the trusted CAs known
by the system; user configured server certificates and client certificates are not used for the
new server.
Predeterminado: 0
server_charset
Cuando se extraen los nombre de archivos desde la ruta del componente en la URL, mount.davfs
asumirá que están codificados usando este conjunto de caracteres y traducirá los nombre de archivo
al mapa de caracteres local. Esto no está relacionado conla codificación del contenido del archivo
ni tampoco tiene relación con las reglas de escapado de HTTP.
No hay manera en HTTP de saber las codificaciones de caracteres de los componentes de la
ruta.Puede que existan muchas codificaciones en una misma ruta, como así también nombres de
archivos codificados que suelen ser creados por ciertos clientes.Hoy en día, lo mejor es usar la
codificación UTF-8 y no hacer ninguna conversión.Si no está seguro de que todos los clientes
entienden UTF-8, limite el nombre de archivo a us-ascii puro. Nunca use caracteres en los nombres
de archivo que puedan tener una función especial en algún sistema operativo (como /, : y \).)
Predeterminado: no convertir el mapa de caracteres
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.
Predeterminado: 10
read_timeout
Cuánto tiempo, en segundos, esperará mount.davfs por una respuesta del servidor antes de asumir
un error.
Predeterminado: 30
retry Cuando mount.davfs no pueda localizar el servidor lo intentará nuevamente después de retry
segundos. Para subsiguientes intentos el intervalo irá en aumento hasta los max_retry segundos.
Predeterminado: 30
max_retry
Máximo valor para el intervalo de reintento.
Predeterminado: 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.
Opciones Relacionadas al Caché
backup_dir
Cada sistema de archivos davfs2 montado tiene un directorio donde almacenar archivos de respaldo
que no han podido ser almacenados en el servidor. Aquí se configura el nombre de ese directorio.
Este directorio debe ser examinado periodicamente.
Predeterminado: lost+found
cache_dir
El directorio donde mount.davfs almacenará los archivos caché. Para cadapunto de montaje un
subdirectorio será creado.
En el archivo de configuración general esto configurará el cachéusado por root. En el archivo de
configuración del usuario configurará el caché usado por ese usuario.
Predeterminado: /var/cache/davfs2 y ~/.davfs2/cache
cache_size
La cantidad espacio en disco, medido en MiByte, que será usado. mount.davfs tomará siempre el
espacio necesario de caché para abrir archivos, ignorando este valor si es necesario.
Predeterminado: 50
table_size
mount.davfs mantiene una tabla de hash con una entrada por cada archivo o directorio conocido.
Este valor es la cantidad de entradas en esta tabla. Para sistemas de archivos muy grandes (más de
cientos de archivos) incrementar este número puede darle velocidad a las operaciones de archivos.
El parámetro debe ser potencia de 2.
Predeterminado: 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.
Predeterminado: 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
unnecessary traffic mount.davfs will wait that many seconds before it send a new request for the
same information.
Predeterminado: 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.
Predeterminado: 10
gui_optimize
Cuando un archivo es abierto, mount.davfs tendrá que chequear el servidor por si hay una nueva
versión. Las Interfaces Gráficas de Usuario (GUI) intentan abrir cualquier archivo, haciendo las
cosas terriblemente lentas para directorios grandes. Con esta opción mount.davfs intentará
obtener esta información de todos los archivos en un directorio con un único pedido PROPFIND. 0 =
no, 1 = sí.
Predeterminado: 0
minimize_mem
davfs2 holds information about files and directories in the working memory. It will stay there as
long as the file system is mounted and the file is not deleted. By this memory usage by davfs2
will grow over time and may slow down davfs2. With this option set to 1 davfs2 will regularly
clean the memory from information that has not be used for some time. 0 = no, 1 = yes.
Warning: Most file attributes are only maintained locally because there is no corresponding WebDAV
property. So if users change attributes (owner, group, access bits) locally this changes will be
lost and attribute values will be reset to the default values.
Predeterminado: 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.
AUTORES
Este manual ha sido escrito por Werner Baumann <werner.baumann@onlinehome.de>.
DAVFS2 HOME
http://savannah.nongnu.org/projects/davfs2
VER TAMBIÉN
mount.davfs(8), umount.davfs(8), mount(8), umount(8), fstab(5)
davfs2 2014-06-09 davfs2.conf(5)