1MAIL.LOCAL(8)                                                    MAIL.LOCAL(8)
2
3
4
5NAME
6       mail.local - store mail in a mailbox
7
8SYNOPSIS
9       mail.local [-7] [-b] [-d] [-D mbdb] [-l] [-f from|-r from] [-h filename
10       ] user ...
11
12DESCRIPTION
13       Mail.local reads the standard input up to an end-of-file and appends it
14       to each user's mail file.  The user must be a valid user name.
15
16       The options are as follows:
17
18       -7        Do not advertise 8BITMIME support in LMTP mode.
19
20       -b        Return  a  permanent  error instead of a temporary error if a
21                 mailbox exceeds quota.
22
23       -d        Specify this is  a  delivery  (for  backward  compatibility).
24                 This option has no effect.
25
26       -D mbdb   Specify  the  name  of  the mailbox database which is used to
27                 look up local recipient names.  This option defaults to "pw",
28                 which means use getpwnam().
29
30       -f from   Specify the sender's name.
31
32       -l        Turn on LMTP mode.
33
34       -r from   Specify the sender's name (for backward compatibility).  Same
35                 as -f.
36
37       -h filename
38                 Store incoming mail in filename in the user's home  directory
39                 instead of a system mail spool directory.
40
41       The  next  options  are  only available if mail.local has been compiled
42       with -DHASHSPOOL.
43
44       -H hashtypehashdepth
45              Select hashed mail directories.  Valid hash types are u for user
46              name  and  m for MD5 (requires compilation with -DHASHSPOOLMD5).
47              Example: -H u2 selects user name hashing with a hash depth of 2.
48              Note:  there  must  be  no  space  between the hash type and the
49              depth.
50
51       -p path
52              Specify an alternate mail spool path.
53
54       -n     Specify that the domain part of recipient addresses in LMTP mode
55              should not be stripped.
56
57       Individual  mail messages in the mailbox are delimited by an empty line
58       followed by a line beginning with the string ``From ''.   A  line  con-
59       taining  the  string  ``From  '', the sender's name and a time stamp is
60       prepended to each delivered mail message.  A blank line is appended  to
61       each  message.   A  greater-than  character (``>'') is prepended to any
62       line in the message which could be mistaken for a ``From  ''  delimiter
63       line (that is, a line beginning with the five characters ``From '' fol-
64       lowing a blank line).
65
66       The mail files are exclusively  locked  with  flock(2)  while  mail  is
67       appended,  and  a  user.lock  file also is created while the mailbox is
68       locked for compatibility with older MUAs.
69
70       If the ``biff'' service  is  returned  by  getservbyname(3),  the  biff
71       server is notified of delivered mail.
72
73       The mail.local utility exits 0 on success, and >0 if an error occurs.
74
75ENVIRONMENT
76       TZ     Used to set the appropriate time zone on the timestamp.
77
78FILES
79       /tmp/local.XXXXXX     temporary files
80       /var/mail/user        user's default mailbox directory
81       /var/mail/user.lock   lock file for a user's default mailbox
82
83SEE ALSO
84       mail(1), xsend(1), flock(2), getservbyname(3), comsat(8), sendmail(8)
85
86WARNING
87       mail.local  escapes  only "^From " lines that follow an empty line.  If
88       all lines starting with "From " should be escaped, use the 'E' flag for
89       the local mailer in the sendmail.cf file.
90
91HISTORY
92       A  superset  of  mail.local  (handling  mailbox reading as well as mail
93       delivery) appeared in Version 7 AT&T UNIX as the program mail.
94
95
96
97                         $Date: 2013-11-22 20:51:51 $            MAIL.LOCAL(8)
98