Provided by:
davfs2_1.3.3-1ubuntu1_i386 
NOMBRE
davfs2.conf - Archivo de Configuración para mount.davfs
DESCRIPCIÓN
Hay un archivo de configuración general /var/cache/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: 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.
ignore_home
Un usuario normal no está autorizado a montar en el directorio
home de otro usuario. Pero algunas veces los usuario de sistemas
(como nobody) tiene asignados directorios home (como /), que
incluyen puntos de montaje comunes. Esta opción permite que,
dada una lista de usuarios de sistema separada por comas,
excluirlos de éste chequeo.
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
Preguntar al usuario interactivamente por credenciales y
contraseñas si no son encontradas en el archivo secrets. 0 = no,
1 = sí
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: 1
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: 1 (this bug is in the most widely used HTTP-server)
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 flas 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
use_displayname
Crea un nombre de archivo desde la propiedad displayname, si
está disponible. 0 = no, 1 = sí. Nota: la codificación de
caracteres de displayname es conocida y siempre seráconvertida a
la codificación local.
Predeterminado: 0
Deprecated: This option will be removed in future versions.
Despite its name, it is not a name but some arbitrary text and
is not required to be unique (RFC 4918, 15.2). It is completely
useless for a file system. Please send a bug report if you think
you need it.
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
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. Example:
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
Una vez que mount.davfs haya obtenido información sobre un
directorio, dicha información se considerará valida durante éste
período de tiempo. Nota: Esto no afecta a los archivos abiertos
y directorios que una aplicación esté leyendo.
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
<wbaumann@users.sourceforge.net>.
DAVFS2 HOME
http://dav.sourceforge.net/
VER TAMBIÉN
mount.davfs(8), umount.davfs(8), mount(8), umount(8), fstab(5)