1.\" Copyright (c) 1990, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"	@(#)mail.local.8	8.1 (Berkeley) 06/04/93
7.\"
8.Dd
9.Dt MAIL.LOCAL 8
10.Os
11.Sh NAME
12.Nm mail.local
13.Nd store mail in a mailbox
14.Sh SYNOPSIS
15.Nm mail.local
16.Op Fl f Ar from
17.Ar user ...
18.Sh DESCRIPTION
19.Nm Mail.local
20reads the standard input up to an end-of-file and appends it to each
21.Ar user 's
22.Pa mail
23file.
24The
25.Ar user
26must be a valid user name.
27.Pp
28The options are as follows:
29.Bl -tag -width xxxfrom
30.It Fl f Ar from
31Specify the sender's name.
32.El
33.Pp
34Individual mail messages in the mailbox are delimited by an empty
35line followed by a line beginning with the string ``From ''.
36A line containing the string ``From '', the sender's name and a time stamp
37is prepended to each delivered mail message.
38A blank line is appended to each message.
39A greater-than character (``>'') is prepended to any line in the message
40which could be mistaken for a ``From '' delimiter line.
41.Pp
42The mail files are exclusively locked with
43.Xr flock 2
44while mail is appended.
45.Pp
46If the ``biff'' service is returned by
47.Xr getservbyname 3 ,
48the biff server is notified of delivered mail.
49.Pp
50The
51.Nm mail.local
52utility exits 0 on success, and >0 if an error occurs.
53.Sh ENVIRONMENT
54.Bl -tag -width indent
55.It Ev TZ
56Used to set the appropriate time zone on the timestamp.
57.El
58.Sh FILES
59.Bl -tag -width /tmp/local.XXXXXX -compact
60.It Pa /tmp/local.XXXXXX
61temporary files
62.It Pa /var/mail/user
63user's mailbox directory
64.El
65.Sh SEE ALSO
66.Xr mail 1 ,
67.Xr xsend 1 ,
68.Xr flock 2 ,
69.Xr getservbyname 3 ,
70.Xr comsat 8 ,
71.Xr sendmail 8
72.Sh HISTORY
73A superset of
74.Nm mail.local
75(handling mailbox reading as well as mail delivery)
76appeared in
77.At v7 .
78as the program
79.Nm mail .
80