Provided by: davfs2_1.4.5-1_i386 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.

       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)