Provided by: davfs2_1.3.3-1ubuntu1_i386 bug

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)