]> git.lizzy.rs Git - plan9front.git/blob - sys/man/8/send
Import sources from 2011-03-30 iso image - lib
[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, it
48 returns the mail to the sender.
49 .IP \(bu
50 if the
51 .B -r
52 option is not given and the mail is undeliverable, it
53 appends the mail to
54 .BI /mail/box/ username /dead.letter
55 and prints a message to standard error.
56 .PP
57 The file
58 .B /mail/lib/rewrite
59 determines exactly how to deliver or queue the mail.
60 The decision is based purely on the recipient address.
61 .PP
62 The options are:
63 .TF -b
64 .TP
65 .B -b
66 suppresses the addition of the
67 .B To:
68 line.
69 .TP
70 .B -i
71 let the message input be terminated by a line
72 containing only a period, for
73 compatibility with
74 old mailers.
75 .TP
76 .B -x
77 do not send mail, but instead report
78 the full mail address of the recipient.
79 .TP
80 .B -#
81 do not send mail, but instead report
82 what command would be used to send the mail.
83 .TP
84 .B -r
85 input is via a pipe from another program.
86 Expect a From
87 line at the start of the message to provide the
88 name of the sender and timestamp.  This implies
89 the
90 .B -b
91 option.
92 .PD
93 .PP
94 .I Send
95 uses the login name as the reply address.
96 .SH FILES
97 .TF /mail/box/*/dead.letter
98 .TP
99 .B /sys/log/mail
100 mail log file
101 .TP
102 .B /mail/box/*/dead.letter
103 unmailable text
104 .TP
105 .B /mail/lib/rewrite
106 rules for handling addresses
107 .TP
108 .B /mail/box/*/names
109 personal alias files
110 .TP
111 .B /mail/lib/namefiles
112 lists names of files containing system aliases
113 .SH SOURCE
114 .TP
115 .B /sys/src/cmd/upas/send
116 .SH "SEE ALSO"
117 .IR aliasmail (8),
118 .IR faces (1),
119 .IR filter (1),
120 .IR mail (1),
121 .IR marshal (1),
122 .IR mlmgr (1),
123 .IR nedmail (1),
124 .IR qer (8),
125 .IR rewrite (6),
126 .IR smtp (8),
127 .IR upasfs (4)