qer(8) [plan9 man page]

QER(8)							      System Manager's Manual							    QER(8)

NAME

       qer, runq - queues management for spooled files

SYNOPSIS

       qer root tag reply args
       runq [ -ad ] root cmd

DESCRIPTION

       Qer  creates  a	control  and a data file in a queue directory.	The control file contents consist of the tag, reply, and args separated by
       spaces.	The data file contains the standard input to qer.  The files are created in the directory root/user, where user is the contents of
       /dev/user.  Mktemp(2) is used to create the actual names of the control and data file.

       Runq  processes	the files queued by qer.  Without the -a option, runq processes all requests in the directory root/user, where user is the
       contents of /dev/user.  With the -a it processes all requests.  Each request is processed by executing the command cmd with the contents of
       the  control  file  as  its  arguments,	the contents of the data file as its standard input, and standard error appended to the error file
       E.XXXXXX.

       The action taken by runq depends on the return status of cmd.  If cmd returns a null status, the processing is assumed successful  and  the
       control,  data,	and error files are removed.  If cmd returns an error status containing the word the files are left to be reprocessed at a
       later time.  For any other status, an error message is mailed to the requester and the files are removed.  Runq uses the reply field in the
       control file as a mail address to which to send an error notification.  The notification contains the contents of the control file to iden-
       tify the failed request.

       To avoid reprocessing files too often, the following algorithm is used: a data file younger than one hour will  not  be	processed  if  its
       error  file  exists  and  was  last modified within the preceding 10 minutes.  A data file older than one hour will not be processed if its
       error file exists and was last modified within the preceding hour.

       The -d option causes debugging output on standard error describing the progress through the queues.

       Runq is often called from cron(8) by an entry such as

	      0,10,20,30,40,50 * * * * kremvax
		      runq -a /mail/queue /mail/lib/remotemail

       The entry must be a single line; it is folded here only so it fits on the page.

FILES

       root/user
	      queue directory for user

       root/user/D.XXXXXX
	      data file

       root/user/C.XXXXXX
	      control file

       root/user/E.XXXXXX
	      error file

SOURCE

       /sys/src/cmd/upas/q

SEE ALSO

       mail(1)

																	    QER(8)

mail.local(1M)						  System Administration Commands					    mail.local(1M)

NAME

       mail.local - store mail in a mailbox

SYNOPSIS

       /usr/lib/mail.local [-f sender] [-d] recipient

DESCRIPTION

       mail.local  reads the standard input up to an end-of-file and appends it to each user's mail file (mailbox). This program is intended to be
       used by sendmail(1M) as a mail delivery agent for local mail. It is not a user interface agent.

       Messages are appended to the user's mail file in the /var/mail directory. The user must be a valid user name.

       Each delivered mail message in the mailbox is preceded by a "Unix From line" with the following format:

	      From sender_address time_stamp

       The sender_address is extracted from the SMTP envelope address (the envelope address is specified with the -f option).

       A trailing blank line is also added to the end of each message.

       The mail files are locked with a .lock file while mail is appended.

       The mail files are created with mode 660, owner is set to recipient, and group is set to mail. If the ``biff'' service is returned by  get-
       servbyname(3SOCKET),  the  biff	server	is notified of delivered mail. This program also computes the Content-Length: header which will be
       used by the mailbox reader to mark the message boundary.

OPTIONS

       The following options are supported:

       -f sender       Specifies the "envelope from address" of the message. This flag is technically optional,  but should be used.

       -d	       Specifies the recipient of the message. This flag is also optional and is supported here for backward  compatibility.  That
		       is, mail.local recipient is the same as mail.local -d recipient.

       -l	       Turn on LMTP mode.

       -r from	       Specify the sender's name (for backward compatibility).

       -7	       Do not advertise 8BITMIME support in LMTP mode.

       -b	       Return a permanent error instead of a temporary error if a mailbox exceeds quota.

OPERANDS

       The following operand is supported:

       recipient       The recipient of the mail message.

ENVIRONMENT VARIABLES

       TZ	Used to set the appropriate time zone on the timestamp.

EXIT STATUS

       The following exit values are returned:

       0	Successful operation.

       >0	An error occurred.

FILES

       /tmp/local.XXXXXX       temporary files

       /tmp/lochd.XXXXXX       temporary files

       /var/mail/user_name     user's mail file

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWsndmu 		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       mail(1), comsat(1M), sendmail(1M), getservbyname(3SOCKET), attributes(5)

SunOS 5.10							    11 Apr 1997 						    mail.local(1M)