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