]> git.lizzy.rs Git - plan9front.git/blob - sys/man/8/send
merge
[plan9front.git] / sys / man / 8 / send
1 .TH SEND 8
2 .SH NAME
3 send \- mail routing and delivery
4 .SH SYNOPSIS
5 .PP
6 .B upas/send
7 [
8 .B -b
9 ] [
10 .B -i
11 ] [
12 .B -r
13 ] [
14 .B -x
15 ] [
16 .B -#
17 ] [
18 .I mailaddr ...
19 ]
20 .SH DESCRIPTION
21 .I Send
22 is not normally run directly by the user.  Instead, mail protocol
23 agents like
24 .I smtpd
25 (see
26 .IR smtp (8))
27 and mail preparers like
28 .IR marshal (1)
29 fork and execute
30 .IR send .
31 .PP
32 .I Send
33 reads a message from standard input and disposes of it in one
34 of four ways:
35 .IP \(bu 3
36 If
37 .I mailaddr
38 refers to a local mailbox, it appends it to the
39 recipient's mailbox.
40 .IP \(bu
41 If
42 .I mailaddr
43 is remote, it queues the mail for remote delivery.
44 .IP \(bu
45 If the
46 .B -r
47 option is given and the mail is undeliverable,
48 the message
49 .B "mail rejected:"
50 is printed on standard error, setting exit status.
51 .IP \(bu
52 if the
53 .B -r
54 option is not given and the mail is undeliverable, it
55 appends the mail to
56 .BI /mail/box/ username /dead.letter
57 and prints a message to standard error.
58 .PP
59 The file
60 .B /mail/lib/rewrite
61 determines exactly how to deliver or queue the mail.
62 The decision is based purely on the recipient address.
63 .PP
64 The options are:
65 .TF -b
66 .TP
67 .B -b
68 suppresses the addition of the
69 .B To:
70 line.
71 .TP
72 .B -i
73 let the message input be terminated by a line
74 containing only a period, for
75 compatibility with
76 old mailers.
77 .TP
78 .B -x
79 do not send mail, but instead report
80 the full mail address of the recipient.
81 .TP
82 .B -#
83 do not send mail, but instead report
84 what command would be used to send the mail.
85 .TP
86 .B -r
87 input is via a pipe from another program.
88 Expect a From
89 line at the start of the message to provide the
90 name of the sender and timestamp.  This implies
91 the
92 .B -b
93 option.
94 .PD
95 .PP
96 .I Send
97 uses the login name as the reply address.
98 .SH FILES
99 .TF /mail/box/*/dead.letter
100 .TP
101 .B /sys/log/mail
102 mail log file
103 .TP
104 .B /mail/box/*/dead.letter
105 unmailable text
106 .TP
107 .B /mail/lib/rewrite
108 rules for handling addresses
109 .TP
110 .B /mail/box/*/names
111 personal alias files
112 .TP
113 .B /mail/lib/namefiles
114 lists names of files containing system aliases
115 .SH SOURCE
116 .TP
117 .B /sys/src/cmd/upas/send
118 .SH "SEE ALSO"
119 .IR aliasmail (8),
120 .IR faces (1),
121 .IR filter (1),
122 .IR mail (1),
123 .IR marshal (1),
124 .IR mlmgr (1),
125 .IR nedmail (1),
126 .IR qer (8),
127 .IR rewrite (6),
128 .IR smtp (8),
129 .IR upasfs (4)