exim_lock man page on OpenSuSE

Man page or keyword search:  
man Server   25941 pages
apropos Keyword Search (all sections)
Output format
OpenSuSE logo
[printable version]

EXIM_LOCK(8)							  EXIM_LOCK(8)

NAME
       exim_lock - Mailbox maintenance

SYNOPSIS
       exim_lock [options]mailbox-file

DESCRIPTION
       The  exim_lock utility locks a mailbox file using the same algorithm as
       Exim.  For a discussion of locking issues, see section 25.2.  Exim_lock
       can  be used to prevent any modification of a mailbox by Exim or a user
       agent while investigating a problem. The utility requires the  name  of
       the  file as its first argument. If the locking is successful, the sec‐
       ond argument is run as a command (using C's  "system()"	function);  if
       there  is  no second argument, the value of the SHELL environment vari‐
       able is used; if this is unset or empty, /bin/sh is run. When the  com‐
       mand  finishes,	the mailbox is unlocked and the utility ends. The fol‐
       lowing options are available:

       -fcntl Use "fcntl()" locking on the open mailbox.

       -interval
	      This must be followed by a number, which is a number of seconds;
	      it sets the interval to sleep between retries (default 3).

       -lockfile
	      Create a lock file before opening the mailbox.

       -mbx   Lock the mailbox using MBX rules.

       -q     Suppress verification output.

       -retries
	      This  must  be followed by a number; it sets the number of times
	      to try to get the lock (default 10).

       -timeout
	      This must be followed by a number, which is a number of seconds;
	      it  sets a timeout to be used with a blocking "fcntl()" lock. If
	      it is not set (the default), a non-blocking call is used.

       -v     Generate verbose output.

	      If none of -fcntl, -lockfile or -mbx are given, the  default  is
	      to  create  a  lock  file	 and also use "fcntl()" locking on the
	      mailbox, which is the same as Exim's default. The use of	-fcntl
	      requires	that  the  file	 be  writeable;	 the  use of -lockfile
	      requires that the directory containing the  file	be  writeable.
	      Locking by lock file does not last for ever; Exim assumes that a
	      lock file is expired if it is more than 30 minutes old.

	      The -mbx option is mutually exclusive with -fcntl.  It causes  a
	      shared  lock  to be taken out on the open mailbox, and an exclu‐
	      sive lock on the file /tmp/.n.m where n and  m  are  the	device
	      number and inode number of the mailbox file. When the locking is
	      released, if an exclusive lock can be obtained for the  mailbox,
	      the file in /tmp is deleted.

	      The  default  output  contains  verification of the locking that
	      takes place. The -v option causes some additional information to
	      be  given. The -q option suppresses all output except error mes‐
	      sages.

       A command such as

	 exim_lock /var/spool/mail/spqr

       runs an interactive shell while the file is locked, whereas

	 exim_lock -q /var/spool/mail/spqr <<End
	 <some commands>
	 End

       runs a specific non-interactive sequence of commands while the file  is
       locked,	suppressing  all  verification output. A single command can be
       run by a command such as

	 exim_lock  -q	 /var/spool/mail/spqr	    "cp	  /var/spool/mail/spqr
       /some/where"

       Note  that  if  a  command  is  supplied, it must be entirely contained
       within the second argument - hence the quotes.

SEE ALSO
       exim(8), /usr/share/doc/packages/exim/

AUTHOR
       This manual page was stitched together from spec.txt by Andreas Metzler
       <ametzler  at downhill.at.eu.org>, for the Debian GNU/Linux system (but
       may be used by others).

			       Oktober 15, 2002			  EXIM_LOCK(8)
[top]

List of man pages available for OpenSuSE

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net