sys/man/1/nedmail

   1 .TH NEDMAIL 1
   2 .SH NAME
   3 nedmail \-  reading mail
   4 .SH SYNOPSIS
   5 .B upas/nedmail
   6 [
   7 .B -nr
   8 ]
   9 [
  10 .B -f
  11 .I mailfile
  12 ]
  13 [
  14 .B -s
  15 .I mailfile
  16 ]
  17 .PP
  18 .B upas/nedmail
  19 .B -c
  20 .I dir
  21 .SH DESCRIPTION
  22 .I Nedmail
  23 edits a mailbox.
  24 The default mailbox is
  25 .BI /mail/box/ username /mbox\f1.
  26 The
  27 .B -f
  28 command line option specifies an alternate mailbox.
  29 Unrooted path names are interpreted relative to
  30 .BI /mail/box/ username.
  31 If the
  32 .I mailfile
  33 argument is omitted, the name defaults to
  34 .BR stored .
  35 .PP
  36 The options are:
  37 .TF "-f mailfile"
  38 .TP
  39 .BI -c " dir
  40 Create a mailbox.  If
  41 .I dir
  42 is specified, the new mailbox is created in
  43 .BI /mail/box/ username / dir /mbox\f1.
  44 Otherwise, the default mailbox is created.
  45 .TP
  46 .B -r
  47 Reverse: show messages in first-in, first-out order; the default is last-in, first-out.
  48 .TP
  49 .B -n
  50 Make the message numbers the same as the file names in the mail
  51 box directory.  This implies the
  52 .B -r
  53 option.
  54 .TP
  55 .BI -f " mailfile"
  56 Read messages from the specified file (see above) instead of the default mailbox.
  57 .TP
  58 .BI -s " mailfile"
  59 Read a single message file
  60 .IR mailfile ,
  61 as produced by
  62 .IR fs ,
  63 and treat it as an entire mailbox.
  64 This is provided for
  65 use in plumbing rules; see
  66 .IR faces (1).
  67 .PD
  68 .PP
  69 .I Nedmail
  70 starts by reading the mail box, printing out the number
  71 of messages, and then prompting for commands from standard input.
  72 Commands, as in
  73 .IR ed (1),
  74 are of the form
  75 .RI `[ range ]
  76 .I command
  77 .RI [ arguments ]'.
  78 The command is applied to each message in the (optional) range.
  79 .PP
  80 The address range can be:
  81 .TP 1.4i
  82 .I address
  83 to indicate a single message header
  84 .PD 0
  85 .TP
  86 .IB address , address
  87 to indicate a range of contiguous message headers
  88 .TP
  89 .BI g/ expression /
  90 to indicate all messages whose headers match the regular
  91 .IR expression .
  92 .TP
  93 .BI g% expression %
  94 to indicate all messages whose contents match the regular
  95 .IR expression .
  96 .PD
  97 .PP
  98 The addresses can be:
  99 .TP 1.4i
 100 .I number
 101 to indicate a particular message
 102 .PD 0
 103 .TP
 104 .IB address . number
 105 to indicate a subpart of a particular message
 106 .TP
 107 .BI / expression /
 108 to indicate the next message whose header matches
 109 .I expression
 110 .TP
 111 .BI % expression %
 112 to indicate the next message whose contents match
 113 expression
 114 .TP
 115 .I "empty or .
 116 to indicate the current message
 117 .TP
 118 .BI - address
 119 to indicate backwards search or movement
 120 .PD
 121 .PP
 122 Since messages in MIME are hierarchical
 123 structures, in
 124 .I nedmail
 125 all the subparts are individually addressable.
 126 For example if message 2 contains 3 attachments,
 127 the attachments are numbered 2.1, 2.2, and 2.3.
 128 .PP
 129 The commands are:
 130 .TP 1.1i
 131 .BI a " args
 132 Reply to all addresses in the
 133 .BR To: ,
 134 .BR From: ,
 135 and
 136 .BR Cc:
 137 header lines.
 138 .I Marshal
 139 is used to format the reply and any arguments the
 140 user specifies are added to the command line to
 141 .I marshal
 142 before the recipient.
 143 The possibility of making a fool of yourself is very
 144 high with this command.
 145 .PD 0
 146 .TP
 147 .BI A " args
 148 Like
 149 .B a
 150 but with the message
 151 appended to the reply.
 152 .TP
 153 .B b
 154 Print the headers for the next ten messages.
 155 .TP
 156 .B d
 157 Mark message to be deleted upon exiting
 158 .IR nedmail .
 159 .TP
 160 .B f
 161 Append the message to the file
 162 .BI /mail/box/ username / sendername
 163 where
 164 .I sendername
 165 is the account name of the sender.
 166 .TP
 167 .B h
 168 Print the disposition, size in characters, reception time, sender,
 169 and subject of the message.
 170 .TP
 171 .B H
 172 Print the MIME structure of the message.
 173 .TP
 174 .B help
 175 Print a summary of the commands.
 176 .TP
 177 .BI m " person ...
 178 Forward the message as a mime attachment to the named
 179 .IR persons .
 180 .TP
 181 .BI M " person ...
 182 Like
 183 .B m
 184 but allow the user to type in text to be included
 185 with the forwarded message.
 186 .TP
 187 .B p
 188 Print message.  An interrupt stops the printing.
 189 .TP
 190 .BI r " args
 191 Reply to the sender of the message.
 192 .I Marshal
 193 is used to format the reply.
 194 If and optional
 195 .I Args
 196 are specified, they are added to the command line to
 197 .I marshal
 198 before the recipient's address.
 199 .TP
 200 .B R " args
 201 Like
 202 .B r
 203 but with the original message included as an attachment.
 204 .TP
 205 .B rf
 206 Like
 207 .B r
 208 but append the message and the reply to the file
 209 .BI /mail/box/ username / sendername
 210 where
 211 .I sendername
 212 is the account name of the sender.
 213 .TP
 214 .B Rf
 215 Like
 216 .B R
 217 but append the message and the reply to the file
 218 .BI /mail/box/ username / sendername
 219 where
 220 .I sendername
 221 is the account name of the sender.
 222 .TP
 223 .BI s " mfile"
 224 Append the message to the specified mailbox.
 225 If
 226 .I mfile
 227 doesn't start with a `/', it is interpreted relative to the directory in which the mailbox resides.
 228 If
 229 .I mfile
 230 is a directory then the destination is a file in that directry.
 231 If the MIME header specifies a file name, that one is used.
 232 Otherwise, one is generated using
 233 .IR mktemp (2)
 234 and the string
 235 .BR att.XXXXXXXXXXX .
 236 .TP
 237 .B q
 238 Put undeleted mail back in the mailbox and stop.
 239 .TP
 240 EOT (control-D)
 241 Same as
 242 .BR q .
 243 .TP
 244 .BI w " file
 245 Same as
 246 .B s
 247 with the mail header line(s) stripped.  This can be used to
 248 save binary mail bodies.
 249 .TP
 250 .B u
 251 Remove mark for deletion.
 252 .TP
 253 .B x
 254 Exit, without changing the mailbox file.
 255 .TP
 256 .B y
 257 Synchronize with the mail box.  Any deleted
 258 messages are purged and any new messages read.
 259 This is equivalent to quiting nedmail and restarting.
 260 .TP
 261 .BI | command
 262 Run the
 263 .I command
 264 with the message body as standard input.
 265 .TP
 266 .BI || command
 267 Run the
 268 .I command
 269 with the whole message as standard input.
 270 .TP
 271 .BI ! command
 272 Escape to the shell to do
 273 .IR command .
 274 .TP
 275 .B \&=
 276 Print the number of the current message.
 277 .PD
 278 .PP
 279 Here's an example of a mail session that looks at a summary
 280 of the mail messages, saves away an html file added as an
 281 attachment to a message and then deletes the message:
 282 .LP
 283 .EX
 284 % mail
 285 7 messages
 286 : ,h
 287 1   H  2129     07/22 12:30  noone@madeup.net  "Add Up To 2000 free miles"
 288 2       504     07/22 11:43  jmk
 289 3   H   784     07/20 09:05  presotto
 290 4       822     07/11 09:23  xxx@yyy.net  "You don't call, you don't write..."
 291 5       193     07/06 16:55  presotto
 292 6       529     06/01 19:42  jmk
 293 7       798     09/02  2000  howard
 294 : 1H
 295 1       multipart/mixed             2129   from=noone@madeup.net
 296  1.1      text/plain                115
 297  1.2      text/html                 1705   filename=northwest.htm
 298 : 1.2w /tmp/northwest.html
 299 !saved in /tmp/northwest.html
 300 1.2: d
 301 1: q
 302 !1 message deleted
 303 %
 304 .EE
 305 .PP
 306 Notice that the delete of message 1.2 deleted the entire message and
 307 not just the attachment.
 308 .SH FILES
 309 .TF /mail/box/*/dead.letter
 310 .TP
 311 .B /mail/box/*
 312 mail directories
 313 .TP
 314 .B /mail/box/*/mbox
 315 mailbox files
 316 .TP
 317 .B /mail/box/*/forward
 318 forwarding address(es)
 319 .TP
 320 .B /mail/box/*/pipeto
 321 mail filter
 322 .TP
 323 .B /mail/box/*/L.reading
 324 mutual exclusion lock for multiple mbox readers
 325 .TP
 326 .B /mail/box/*/L.mbox
 327 mutual exclusion lock for altering mbox
 328 .SH SOURCE
 329 .B /sys/src/cmd/upas/ned
 330 .SH "SEE ALSO"
 331 .IR mail (1),
 332 .IR aliasmail (8),
 333 .IR filter (1),
 334 .IR marshal (1),
 335 .IR mlmgr (1),
 336 .IR nedmail (1),
 337 .IR upasfs (4),
 338 .IR smtp (8),
 339 .IR faces (1),
 340 .IR rewrite (6)