Provided by: davfs2_1.5.5-1_amd64 bug

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)