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