Provided by: davfs2_1.4.6-1ubuntu3_i386 bug

NOMBRE

       davfs2.conf - Archivo de Configuracion para mount.davfs

DESCRIPCI'ON

       Hay  un  archivo  de  configuracion  general  /etc/davfs2/davfs2.conf y
       archivos de configuracion propios  del  usuario  ~/.davfs2/davfs2.conf.
       Cuando   mount.davfs   es  invocado  como  root,  solo  el  archivo  de
       configuracion general es leido.  Cuando  es  invocado  por  un  usuario
       normal,   el   archivo   de   configuracion   del   usuario   es  leido
       adicionalmente. Las configuraciones del archivo  de  configuracion  del
       usuario tienen precedencia sobre el archivo de configuracion general.

       El  archivo de configuracion consiste en lineas donde cada una contiene
       pares de palabrasclave/valor. Las palabras claves y los  valores  estan
       separados por espacios y/o tabs.

       El  archivo  puede tener secciones que son aplicables solamente para un
       punto de montaje especifico. Esta seccion empieza con  una  linea,  que
       contiene  la  ruta  completa  del  punto de montaje entre corchetes. La
       seccion termina cuando empieza la siguiente seccion o cuando termina el
       archivo.  Las  opciones  que  deban  aplicarse  a todas los sistemas de
       archivos montados deben ir antes de la  primer  seccion.  Las  opciones
       dadas en la seccion especifica tendran 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'ACTICAS GENERALES

       Lineas  que  solo  contienen  espacios  y  tabs  (lineas  vacias)   son
       ignoradas.

       # indica un comentario. El resto de la linea es ignorada.

       \ es el caracter de escape.

       "" es usado para citar.

       Si  el parametro contiene algun caracter especial como espacio, tab, #,
       \, o ", este 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 estan entre  comillas
       dobles.  Si  la  linea  inicial  de la seccion esta entre comillas, los
       corchetes deben ir con  las  comillas  (por  ejemplo,  "[/home/otto/con
       espacios]").

       Opciones  con valores booleanos deben ser dados como valores numericos.
       0 para no, 1 para si.

OPCIONES DE CONFIGURACI'ON DISPONIBLES

Opciones Generales

       dav_user
              Cuando el demonio mount.davfs sea invocado como root correra con
              este usuario. El valor deber ser dado como un nombre_de_usuario,
              no como un id numerico.
              Predeterminado: davfs2
              S'olo permitido  en  el  archivo  general  de  configuraci'on  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 numerico.
              Predeterminado: davfs2
              S'olo permitido  en  el  archivo  general  de  configuraci'on  del
              sistema.

       ignore_home
              Un  usuario  normal no esta 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  opcion  permite  que,
              dada  una  lista  de  usuarios  de  sistema  separada por comas,
              excluirlos de este chequeo.
              S'olo permitido  en  el  archivo  general  de  configuraci'on  del
              sistema.

       kernel_fs
              Que 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
              Tamano  en  KiByte  del  buffer  usado  para  comunicarse con el
              sistema de archivos del kernel. Solamente util 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'olo  permitido  en  el  archivo  general  de  configuraci'on 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'olo  permitido  en  el  archivo  general  de  configuraci'on 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  sera
              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    seran
              buscados.

       secrets
              Nombre   de   archivo  que  contiene  las  credenciales  de  los
              servidores  y  del  proxy,  y  contrasenas  para  descifrar   el
              certificado  cliente.  El nombre debe ser un camino absoluto. El
              archivo debe ser legible y escribible unicamente  por  el  dueno
              (modo 600).
              Predeterminado: ~/.davfs2/secrets
              S'olo  permitido  en  el  archivo  general  de  configuraci'on 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 = si.
              Predeterminado: 1

       lock_owner
              Una cadena enviada al servidor para  identificar  al  dueno  del
              bloqueo.  Si  el  recurso  WebDav  es  usado al mismo tiempo por
              diferentes clientes que utilizan  las  mismas  credenciales,  se
              deberan elegir diferentes valores de lock_owner.
              Predeterminado:   el   nombre   de   usuario  utilizado  en  las
              credenciales

       lock_timeout
              Durante cuanto tiempo, en segundos, se considerara valido, 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
              intentararefrescar    el    bloqueo.   El   valor   debera   ser
              sustancialmente mas 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 confirmacion del servidor antes de la subida. No
              todos los servidores entienden esto. 0 = no, 1 = si.
              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 = si.
              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 asumira que estan  codificados
              usando  este  conjunto  de  caracteres y traducira los nombre de
              archivo al mapa de caracteres local. Esto  no  esta  relacionado
              conla  codificacion  del  contenido del archivo ni tampoco tiene
              relacion 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 asi  tambien  nombres  de
              archivos   codificados   que  suelen  ser  creados  por  ciertos
              clientes.Hoy en dia, lo mejor es usar la codificacion UTF-8 y no
              hacer  ninguna  conversion.Si  no  esta  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 funcion especial en algun 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
              Cuanto  tiempo,  en  segundos,  esperara  mount.davfs  por   una
              respuesta del servidor antes de  asumir un error.
              Predeterminado: 30

       retry  Cuando  mount.davfs  no pueda localizar el servidor lo intentara
              nuevamente  despues  de  retry  segundos.   Para   subsiguientes
              intentos  el  intervalo  ira  en  aumento  hasta  los  max_retry
              segundos.
              Predeterminado: 30

       max_retry
              Maximo 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'e

       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. Aqui se configura el nombre de ese
              directorio. Este directorio debe ser examinado periodicamente.
              Predeterminado: lost+found

       cache_dir
              El directorio donde mount.davfs almacenara los  archivos  cache.
              Para cadapunto de montaje un subdirectorio sera creado.
              En  el  archivo  de  configuracion  general  esto configurara el
              cacheusado por root. En el archivo de configuracion del  usuario
              configurara el cache usado por ese usuario.
              Predeterminado: /var/cache/davfs2 y ~/.davfs2/cache

       cache_size
              La  cantidad espacio en disco, medido en MiByte, que sera usado.
              mount.davfs tomara siempre el espacio necesario  de  cache  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
              (mas de cientos de archivos) incrementar este numero puede darle
              velocidad  a  las operaciones de archivos. El parametro 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 aplicacion,
              mount.davfschequeara primero en el servidor  si  hay  una  nueva
              version.  Pero  algunas  aplicaciones  hacen  estos chequeos del
              mismo archivo en periodos de tiempo muy corto.  Para  evitar  el
              trafico  innecesario  mount.davfs esperara varios segundos antes
              de enviar un nuevo chequeo que pida la misma informacion.
              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 tendra que chequear el
              servidor por si hay una nueva version. Las  Interfaces  Graficas
              de  Usuario (GUI) intentan abrir cualquier archivo, haciendo las
              cosas terriblemente lentas para directorios grandes.   Con  esta
              opcion  mount.davfs  intentara obtener esta informacion de todos
              los archivos en un directorio con un unico pedido PROPFIND. 0  =
              no, 1 = si.
              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'EN

       mount.davfs(8), umount.davfs(8), mount(8), umount(8), fstab(5)