davfs2.conf(5)

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.

El archivo de configuración consiste en líneas donde cada una contiene pares de palabrasclave/valor. Las palabras claves y los valores están separados por espacios y/o 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 expect /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: nobody
    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: network
    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
    Tamaño en KiByte del buffer usado para comunicarse con el sistema de archivos del kernel. Solamente útil con fuse, donde las operaciones de lectura y escritura pueden beneficiarse con un buffer grande.
    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
    Nombre del proxy. El nombre debe ser un FQDN (el nombre de la computadora y el nombre de dominio). Si el puerto del proxy es distinto de 8080, debeexplicitarse, separado por dos puntos. Por ejemplo: foo.bar:1704 o foo.bar
    Sólo permitido en el archivo general de configuración del sistema.

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

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
    Sólo permitido en el archivo general de configuración del sistema. El archivo "secrets" general del sistema es siempre /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
    Una cadena enviada al servidor para identificar al dueño del bloqueo. Si el recurso WebDav es usado al mismo tiempo por diferentes clientes que utilizan las mismas credenciales, se deberán elegir diferentes valores de lock_owner.
    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

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

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
    Cuando un archivo o un directorio es abierto por una aplicación, mount.davfschequeará primero en el servidor si hay una nueva versión. Pero algunas aplicaciones hacen estos chequeos del mismo archivo en períodos de tiempo muy corto. Para evitar el tráfico innecesario mount.davfs esperará varios segundos antes de enviar un nuevo chequeo que pida la misma información.
    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

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)