Provided by: manpages-es-extra_0.8a-19_all bug

NOMBRE

       lockfile - creador de fichero semáforo condicional

SINOPSIS

       lockfile -tiempodormido | -r reintentos |
            -l temporizador_bloqueo | -s suspend | -!  | -ml | -mu | nombre_fichero ...

DESCRIPCIÓN

       lockfile  Se  puede  usar  para  crear uno o más ficheros semáforo.  Si lockfile no puede crear todos los
       ficheros especificados (en el orden especificado),  espera  tiempodormido  segundos  (por  defecto  8)  y
       reintenta  el último fichero que no pudo crear. Puede especificar el número de reintentos a llevar a cabo
       hasta que devuelva un fallo.  Si el número de  reintentos  es  -1  (por  defecto,  i.e.   -r-1)  lockfile
       intentará indefinidamente.

       Si  el  número de reintentos expira antes de que se hayan creado todos los ficheros, lockfile devuelve un
       fallo y elimina todos los ficheros creados hasta ese punto.

       El valor devuelto por lockfile se puede invertir fácilmente especificando -!  como  un  argumento  (viene
       bien en los guiones de shell).

       Todas las banderas se pueden especificar en cualquier posición de la línea de mandato, se procesan cuando
       se encuentran. La línea de mandato es simplemente analizada de izquierda a derecha.

       Todos  los ficheros creados por lockfile serán de sólo lectura, y por tanto tendrán que eliminarse con rm
       -f.

       Si especifica un temporizador_bloqueo entonces el fichero de bloqueo se  eliminará  a  la  fuerza  cuando
       hayan  pasado temporizador_bloqueo segundos desde que el fichero fue creado/modificado por última vez (lo
       más probable por algún otro programa que murió inesperadamente hace cierto tiempo y no  pudo  borrar  los
       ficheros  de bloqueo restantes). Lockfile es inmune a las desviaciones del reloj. Tras haber eliminado un
       fichero de bloqueo a la fuerza se tiene en cuenta una suspensión de suspend segundos  (por  defecto  16),
       para  prevenir  la  eliminación  inmediata  de cualquier fichero de bloqueo creado recientemente por otro
       programa  (compare SUSPEND de procmail(1)).

   Bloqueo de Buzón
       Si los permisos del directorio de spool de correo del sistema lo permite  o  si  lockfile  tiene  setgid,
       podrá bloquear y desbloquear su buzón del sistema usando las opciones -ml y -mu respectivamente.

EJEMPLOS

       Supongamos  que quieres  estar seguro que el acceso al fichero "importante" es en serie, es decir, no más
       de  un  programa  o  guión  de shell podría acceder a él. Por motivos de simplicidad supongamos que es un
       guión de shell. En este caso podría resolverlo de la siguiente forma:
              ...
              lockfile importante.lock
              ...
              acceso_"importante"_al_contenido_de_su_corazón
              ...
              rm -f importante.lock
              ...
       Ahora, si todos los guiones que acceden a "importante" siguen esta directriz, tendrá la seguridad de que,
       como mucho, se ejecutará un único guión entre las órdenes `lockfile' y `rm'.

ENTORNO

       LOGNAME                usado como indicación para determinar el nombre del usuario que llama al programa.

FICHEROS

       /etc/passwd            para verificar y/o corregir el nombre de usuario que llama  al  programa  (y  para
                              encontrar el directorio HOME, si fuera necesario)

       /var/spool/mail/$LOGNAME.lock
                              fichero  de  bloqueo para el buzón del sistema, las variables de entorno presentes
                              aquí no se tomarán del entorno, sino que se determinarán mirando en /etc/passwd

VÉASE TAMBIÉN

       rm(1), mail(1), binmail(1), sendmail(8), procmail(1)

DIAGNÓSTICOS

       filename too long, ... Use un nombre de fichero más corto.

       Forced unlock denied on "x"
                              No hay permisos de escritura en el directorio donde reside el fichero  de  bloqueo
                              "x", o más de un fichero de bloqueo está intentando forzar un bloqueo  exactamente
                              al mismo tiempo.

       Forcing lock on "x"    El  fichero  de  bloqueo  "x"  va a ser eliminado a la fuerza por el sobrepaso del
                              temporizador (compare LOCKTIMEOUT en procmail(1)).

       Out of memory, ...     Al sistema no le queda espacio swap.

       Signal received, ...   Lockfile eliminará todo lo que haya creado hasta ahora y termina.

       Sorry, ...             Se ha alcanzado el límite de reintentos.

       Truncating "x" and retrying lock
                              "x" no parece ser un nombre_fichero válido.

       Try praying, ...       Subdirectorio no encontrado o privilegios insuficientes.

FALLOS (BUGS)

       Definitivamente menos de uno.

MISCELÁNEA

       Lockfile resistente a NFS y procesa los 8 bits.

NOTAS

       Al llamar un fichero de bloqueo con las opciones -h or -?  hará que muestre una página de ayuda  para  la
       línea de mandatos.  Llamándolo con la opción -v hará que muestre su información sobre la versión.

       Multiples banderas -!  alternan el estado de salida.

       Como las banderas pueden aparecer en cualquier posición de la línea de mandatos, cualquier nombre_fichero
       que empiece por  '-' tiene que ser precedido por  './'.

       El  número  de  reintentos  no se reiniciará cuando se cree cualquier fichero (i.e. simplemente se usan).
       Sin embargo, se puede reiniciar especificando -rnewreintentos tras cada fichero en la línea de mandatos.

       Aunque se pueden usar ficheros con cualquier nombre como ficheros de bloqueo, es una práctica común  usar
       la  extensión `.lock' para bloquear carpetas de correo (se añade al nombre de carpeta). En el caso de que
       uno no quiera preocuparse por los nombres de ficheros  demasiado  largos  y  no  tener  que  adaptarse  a
       cualquier  otra  convención  de  ficheros de blqueo, una excelente forma de generar nombres de fcheros de
       bloqueo correspondientes a algún fichero existente es tomar el prefijo `lock.' y añadir el número  de  i-
       nodo de fichero que se tiene que bloquear.

ORIGEN

       Este  programa  es  parte  del  paquete  de  procesamiento  de  correo  procmail  (v3.13.1) disponible en
       http://www.procmail.org/ o ftp.procmail.org en pub/procmail/.

LISTAS DE CORREO

       Existe un lista de correo para cuestiones relacionadas con cualquier programa del paquete procmail:
              <procmail-users@procmail.org>
                     para enviar preguntas/respuestas
              <procmail-users-request@procmail.org>
                     para solicitudes de suscripción.

       Si quisiera estar informado sobre nuevas versiones y parches oficiales envíe una solicitud de suscripción
       a
              procmail-announce-request@procmail.org
       (esta es una lista de sólo lectura).

AUTOR

       Stephen R. van den Berg
              <srb@cuci.nl>

BuGless                                            1999/01/20                                        LOCKFILE(1)