|
|
1.1 ! root 1: .TH MAILX 1 "Post 4.0" " " ! 2: .de Cm ! 3: .ne 3 ! 4: .TP ! 5: \\f3\\$1\\f1\\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 ! 6: .br ! 7: .. ! 8: .de C ! 9: .ne 2 ! 10: .TP ! 11: \\f3\\$1\\f1\\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 ! 12: .br ! 13: .. ! 14: .de Ti ! 15: .ne 2 ! 16: .TP ! 17: \\f3~\\^\\$1\\f1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 ! 18: .br ! 19: .. ! 20: .de Va ! 21: .ne 2 ! 22: .TP ! 23: \\f3\\$1\\f1=\\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 ! 24: .br ! 25: .. ! 26: .de V ! 27: .ne 2 ! 28: .TP ! 29: \\f3\\$1\\f1 ! 30: .br ! 31: .. ! 32: .ds Ma \\f2mailx\\f1 ! 33: .ds EV \s-1ENVIRONMENT VARIABLES\s+1 ! 34: .ds CM "\s-1COMMANDS\s+1 ! 35: .ds Te "\s-1TILDE ESCAPES\s+1 ! 36: .ds WA "\s-1WARNINGS\s+1 ! 37: .ds al \\f2alias\\f1 ! 38: .ds nu \\f2number\\f1 ! 39: .ds ms \\f2message\f1 ! 40: .ds sh \\f2shell-command\\f1 ! 41: .ds mc \\f2mail-command\\f1 ! 42: .ds dl \\fBdead.letter\\f1 ! 43: .ds mr \\f2.mailrc\\f1 ! 44: .ds mb \\f2mbox\\f1 ! 45: .ds mx \\f2mailbox\\f1 ! 46: .ds ml \\f2msglist\\f1 ! 47: .ds om [\\f2msglist\\f1] ! 48: .ds hf \\f2header-field\\f1 ! 49: .ds fn \\f2filename\\f1 ! 50: .ds st \\f2string\\f1 ! 51: .ds dr \\f2directory\\f1 ! 52: .ds nm \\f2address\\f1 ! 53: .ds vr \\f2variable\\f1 ! 54: .SH NAME ! 55: mailx \- interactive message processing system ! 56: .SH SYNOPSIS ! 57: .B mailx ! 58: [options] [address ...] ! 59: .SH DESCRIPTION ! 60: The command ! 61: \f2mailx\f1 provides a comfortable, flexible environment for sending and ! 62: receiving messages electronically. ! 63: When reading mail, ! 64: \*(Ma provides commands to facilitate saving, deleting, and responding to ! 65: messages. ! 66: When sending mail, ! 67: \*(Ma allows editing, reviewing and other modification of the message ! 68: as it is entered. ! 69: .PP ! 70: Incoming mail is stored in a standard file for each user, ! 71: called the \*(mx for that user. ! 72: When \*(Ma is called to read messages, ! 73: the \*(mx is the default place to find them. ! 74: As messages are read, ! 75: they may be marked to be moved to a secondary file for storage ! 76: (see ``hold''), ! 77: unless specific action is taken, ! 78: so that the messages need not be seen again. ! 79: This secondary file is called the \*(mb ! 80: and is normally located in the user's \s-1HOME\s+1 directory ! 81: (see ``\s-1MBOX\s+1''). ! 82: Messages can be saved in other secondary files named by the user. ! 83: Messages remain in a secondary file until forcibly removed. ! 84: .PP ! 85: The user can access a secondary file by using the ! 86: \f3\-f\f1 option of the \*(Ma command. ! 87: Messages in the secondary file can then be read or otherwise ! 88: processed using the same \*(CM as in the primary \*(mx. ! 89: This gives rise within these pages to the notion of a current \*(mx. ! 90: .PP ! 91: On the command line, ! 92: .I options ! 93: start with a dash (\-) and any other arguments are taken to be ! 94: addresses. ! 95: If no recipients are specified, ! 96: \*(Ma will attempt to read messages from the \*(mx. ! 97: Command line options are: ! 98: .PP ! 99: .PD 0 ! 100: .TP 14 ! 101: .B \-e ! 102: Test for presence of mail. ! 103: \f2mailx\f1 prints nothing and exits with a successful return code if there is ! 104: mail to read. ! 105: .TP ! 106: .BR \-f \ [\*(fn] ! 107: Read messages from \*(fn instead of \*(mx. ! 108: If no \*(fn is specified, ! 109: the \*(mb is used. ! 110: .TP ! 111: .B \-F ! 112: Record the message in a file named after the first recipient. ! 113: Overrides the ``record'' variable, if set. ! 114: .TP ! 115: .B \-H ! 116: Print header summary only. ! 117: .TP ! 118: .B \-i ! 119: Ignore interrupts. ! 120: See ``ignore''. ! 121: .TP ! 122: .B \-n ! 123: Do not initialize from the system default ! 124: .I mailx.rc ! 125: file. ! 126: .TP ! 127: .B \-N ! 128: Do not print initial header summary. ! 129: .TP ! 130: .BI \-s \ subject ! 131: Set the Subject header field to ! 132: .IR subject . ! 133: .TP ! 134: .BI \-u \ user ! 135: Read ! 136: .IR user 's ! 137: \*(mx. ! 138: This is only effective if ! 139: .IR user 's ! 140: \*(mx is not read protected. ! 141: .PD ! 142: .PP ! 143: When reading mail, ! 144: \*(Ma is in ! 145: command mode. ! 146: A header summary of the first several messages is displayed, ! 147: followed by a prompt indicating \*(Ma can accept regular commands ! 148: (see \*(CM below). ! 149: When sending mail, ! 150: \*(Ma is in ! 151: input mode. ! 152: If no subject is specified on the command line, ! 153: a prompt for the subject is printed. ! 154: As the message is typed, ! 155: \*(Ma will read the message and store it in a temporary ! 156: file. ! 157: Commands may be entered by beginning a line with the tilde (~) escape ! 158: character followed by a single command letter and optional arguments. ! 159: See \*(Te for a summary of these commands. ! 160: Outgoing mail may be saved in a local file (see ``record''). ! 161: .PP ! 162: At any time, ! 163: the behavior of \*(Ma is governed by a set of ! 164: \f2environment variables\f1. ! 165: These are flags and valued parameters which are set and cleared via the ! 166: ``set'' and ``unset'' commands. ! 167: See \*(EV below for a summary of these parameters. ! 168: .PP ! 169: \*(Ma accepts \fIpost\fP addressing. ! 170: Login names may be any network address, ! 171: including mixed network addressing. ! 172: If mail is found to to undeliverable, an attempt is ! 173: made to return it to the sender's \f2mailbox\f1. ! 174: If the recipient name begins with a plus (+), ! 175: the rest of the name is a file to append the mail to. ! 176: If the file is a relative path name, it is prepended ! 177: with the value of the ``folder'' variable. ! 178: If the recipient name begins with a pipe symbol (|), ! 179: the rest of the name is taken to be a shell command to pipe the ! 180: message through. ! 181: This provides an automatic interface with any program that reads the standard ! 182: input, such as ! 183: .IR lp (1) ! 184: for recording outgoing mail on paper. ! 185: Alias groups are set by the ``alias'' command ! 186: and are lists of recipients of any type. ! 187: .PP ! 188: Regular commands are of the form ! 189: .ti +.5i ! 190: [ ! 191: .B command ! 192: ] [ ! 193: .I msglist ! 194: ] [ ! 195: .I arguments ! 196: ] ! 197: .br ! 198: If no command is specified in command mode, ! 199: .BR p rint ! 200: is assumed. ! 201: In input mode, ! 202: commands are recognized by the escape character, ! 203: and lines not treated as commands are taken as input for the message. ! 204: .PP ! 205: Each message is assigned a sequential number, ! 206: and there is at any time the notion of a current message, ! 207: marked by a right angle bracket (>) in the header summary. ! 208: Many commands take an optional list of messages ! 209: (\*(ml) to operate on. ! 210: The default for \f2msglist\f1 is the current message. ! 211: A \*(ml is a list of message identifiers separated by spaces, ! 212: which may include: ! 213: .PP ! 214: .PD 0 ! 215: .TP 8 ! 216: .B n ! 217: Message number ! 218: .BR n . ! 219: .TP ! 220: .B . ! 221: The current message. ! 222: .TP ! 223: .B ^ ! 224: The first message. ! 225: .TP ! 226: .B $ ! 227: The last message. ! 228: .TP ! 229: .B * ! 230: All messages. ! 231: .TP ! 232: .B n\-m ! 233: An inclusive range of message numbers. ! 234: .TP ! 235: .B user ! 236: All messages from ! 237: .BR user , ! 238: where ! 239: .B user ! 240: is the network address of the sender. ! 241: .TP ! 242: .B /string ! 243: All messages with ! 244: .B string ! 245: in the subject line (case ignored). ! 246: .TP ! 247: .BI : c ! 248: All messages of type ! 249: .IR c , ! 250: where ! 251: .I c ! 252: is one of: ! 253: .RS 13 ! 254: .TP ! 255: .B d ! 256: deleted messages ! 257: .TP ! 258: .B n ! 259: new messages ! 260: .TP ! 261: .B o ! 262: old messages ! 263: .TP ! 264: .B r ! 265: read messages ! 266: .TP ! 267: .B u ! 268: unread messages ! 269: .RE ! 270: .PP ! 271: Note that the context of the command determines whether this type of ! 272: message specification makes sense. ! 273: .PD ! 274: .PP ! 275: Other arguments are usually arbitrary strings whose usage ! 276: depends on the command involved. ! 277: File names, ! 278: where expected, ! 279: are expanded via the normal shell conventions (see ! 280: .IR sh (1)). ! 281: Special characters are recognized by certain commands and are ! 282: documented with the commands below. ! 283: .PP ! 284: At start-up time, ! 285: \*(Ma tries to execute commands from the optional system-wide file ! 286: (\f3/usr/lib/mailx.rc\f1) to initialize ! 287: certain parameters, ! 288: then from a private start-up file (\f3$HOME/.mailrc\f1) for ! 289: personalized variables. ! 290: With the exceptions noted below, ! 291: regular commands are legal inside start-up files. ! 292: The most common use of a start-up file is ! 293: to set up initial display options and alias lists. ! 294: The following commands are not legal in the start-up file: ! 295: ``!'', ``Copy'', ``edit'', ``followup'', ``Followup'', ``hold'', ! 296: ``mail'', ``reply'', ``Reply'', ``shell'', and ``visual''. ! 297: An error in the start-up file causes the remaining lines in the file to ! 298: be ignored. ! 299: The \f3.mailrc\f1 file is optional, and must be constructed locally. ! 300: .SS \*(CM ! 301: The following is a complete list of \*(Ma commands: ! 302: .PP ! 303: .PD 0 ! 304: .Cm ! \*(sh ! 305: Escape to the shell. ! 306: See ``\s-1SHELL\s+1''. ! 307: .Cm # "" \f2comment\f1 ! 308: Null command (comment). ! 309: This may be useful in \*(mr files. ! 310: .Cm = ! 311: Print the current message number. ! 312: .Cm ? ! 313: Prints a summary of commands. ! 314: .Cm a lias \*(al \*(nm ... ! 315: Declare an alias for the given addresses. ! 316: The addresses will be substituted ! 317: when ! 318: \*(al is used as a recipient. ! 319: Useful in the \*(mr file. ! 320: .Cm alt ernates \*(nm ... ! 321: Declares a list of alternate addresses for your login. ! 322: When responding to a message, ! 323: these addresses are removed from the list of recipients for the response. ! 324: With no arguments, ! 325: .BR alt ernates ! 326: prints the current list of alternate addresses. ! 327: See also ``allnet''. ! 328: .Cm cd "" [\*(dr] ! 329: Change directory. ! 330: If \*(dr is not specified, ! 331: \s-1$HOME\s+1 is used. ! 332: .Cm c opy [\*(fn] ! 333: .C c opy \*(om \*(fn ! 334: Copy messages to the file without marking the messages as saved. ! 335: Otherwise equivalent to the ``save'' command. ! 336: .Cm C opy \*(om ! 337: Save the specified messages in a file whose name is derived from the ! 338: author of the ! 339: message to be saved, without marking the messages as saved. ! 340: Otherwise equivalent to the ``Save'' command. ! 341: .Cm d elete \*(om ! 342: Delete messages from the \*(mx. ! 343: If ``autoprint'' is set, ! 344: the next message after the last one deleted is printed. ! 345: .Cm di scard [\*(hf ...] ! 346: Suppresses printing of the specified header fields when displaying messages ! 347: on the screen. ! 348: Examples of header fields to ignore are ``status'' and ``cc''. ! 349: The fields are included when the message is saved. ! 350: The ``Print'' command overrides this command. ! 351: .Cm dp "" \*(om ! 352: Delete the specified messages from the \*(mx and print the next message ! 353: after the last one deleted. ! 354: Roughly equivalent to a ``delete'' ! 355: command followed by a ``print'' command. ! 356: .Cm ec ho \*(st ... ! 357: Echo the given strings (like ! 358: .IR echo (1)). ! 359: .Cm e dit \*(om ! 360: Edit the given messages. ! 361: The messages are placed in a temporary file and the ``EDITOR'' variable ! 362: is used to get the name of the editor. ! 363: Default editor is ! 364: .IR ed (1). ! 365: .Cm ex it ! 366: .C x it ! 367: Exit from \*(Ma, ! 368: without changing the \*(mx. ! 369: No messages are saved in the \*(mb (see also ! 370: .BR q uit). ! 371: .Cm fi le [\*(fn] ! 372: Quit from the current file of messages and read in the specified file. ! 373: Several special characters are recognized when used as file names, ! 374: with the following substitutions: ! 375: .RS 10 ! 376: .TP 8 ! 377: % ! 378: current \*(mx. ! 379: .TP ! 380: .RB % user ! 381: \*(mx for ! 382: .BR user . ! 383: .TP ! 384: # ! 385: previous file. ! 386: .TP ! 387: & ! 388: current \*(mb. ! 389: .RE ! 390: .RS 5 ! 391: Default file is the current \*(mx. ! 392: .RE ! 393: .Cm folders ! 394: Print the names of the files in the ! 395: directory set by the ``folder'' variable. ! 396: .Cm fo llowup \*(om ! 397: Reply to the first message in the \*(ml, ! 398: sending the message to the author of each message in the \*(ml. ! 399: The subject line is taken from the first message ! 400: and the response is recorded in a file whose name is derived ! 401: from the author of the first message. ! 402: See also the ``Followup'', ``Save'', and ``Copy'' ! 403: commands, and ``outfolder'' and ``flipf''. ! 404: .Cm F ollowup [\*(ms] ! 405: Reply to the specified message, ! 406: recording the response in a file whose name is derived from the ! 407: author of the message. ! 408: Overrides the ``record'' variable, if set. ! 409: See also the ``followup'', ``Save'', and ``Copy'' ! 410: commands, and ``outfolder'' and ``flipf''. ! 411: .Cm f rom \*(om ! 412: Prints the header summary for the specified messages. ! 413: .Cm h eaders [\*(ms] ! 414: Prints the page of headers which includes the message specified. ! 415: The ``screen'' variable sets the number of headers per page. ! 416: See also the ``z'' command. ! 417: .Cm hel p ! 418: Prints a summary of commands. ! 419: .Cm ho ld \*(om ! 420: Holds the specified messages in the \*(mx. ! 421: .Cm i f \fBs\f1 | \fBr\f1 ! 422: .C "" \*(mcs ! 423: .C el se ! 424: .C "" \*(mcs ! 425: .C en dif ! 426: Conditional execution, where ! 427: .B s ! 428: will execute following \*(mcs, up to an ! 429: .BR el se ! 430: or ! 431: .BR en dif, ! 432: if the program is in ! 433: send mode, and ! 434: .B r ! 435: causes the \*(mcs to be executed only in ! 436: receive mode. ! 437: Useful in the \*(mr file. ! 438: .Cm l ist ! 439: Prints all commands available. ! 440: No explanation is given. ! 441: .Cm m ail \*(nm ... ! 442: Mail a message to the specified \*(nm\fI(es)\fR. ! 443: If ``record'' is set to a file name, the reply is saved at the ! 444: end of that file. ! 445: .Cm M ail \*(nm ! 446: Mail a message to the specified \*(nm and record a copy of it ! 447: in a file named after that \*(nm. ! 448: .Cm mb ox \*(om ! 449: Arrange for the given messages to end up in the standard \*(mb save file ! 450: when \*(Ma terminates normally. ! 451: See ``MBOX'' for a description of this file. ! 452: See also the ``exit'' and ``quit'' commands. ! 453: .Cm n ext [\*(ms] ! 454: Go to next message matching \*(ms. ! 455: A \*(ml may be specified, ! 456: but in this case the first valid message in the list is the only one used. ! 457: This is useful for jumping to the next message from a specific user, ! 458: since the name would be taken as a command in the absence of a real command. ! 459: See the discussion of \*(mls above for a description of ! 460: possible message specifications. ! 461: .Cm pi pe \*(om [\*(sh] ! 462: Pipe the message through the given \*(sh. ! 463: The message is treated as if it were read. ! 464: If no arguments are given, ! 465: the current message is piped through the command specified by the ! 466: value of the ``cmd'' variable. ! 467: If the ``page'' variable is set, ! 468: a form feed character is inserted after each message. ! 469: .Cm p rint \*(om ! 470: Print the specified messages. ! 471: If ``crt'' is set, ! 472: the messages longer than the number of lines specified by the ! 473: ``crt'' variable are paged through the command specified by the ! 474: ``PAGER'' variable. ! 475: The default command is ! 476: .IR pg (1). ! 477: .Cm P rint \*(om ! 478: Print the specified messages on the screen, ! 479: including all header fields. ! 480: Overrides suppression of fields by the ``ignore'' command. ! 481: .Cm q uit ! 482: Exit from \*(Ma, ! 483: storing messages that were read in \*(mb and unread messages in the \*(mx. ! 484: Messages that have been explicitly saved in a file are deleted. ! 485: .Cm r eply [\*(ml] ! 486: Send a response to the author of each message in the \*(ml. ! 487: The subject line is taken from the first message. ! 488: If ``record'' is set to a file name, ! 489: the response is saved at the end of that file. ! 490: See ``flipr''. ! 491: .Cm R eply [\*(ms] ! 492: Reply to the specified message, ! 493: including all other recipients of the message. ! 494: If ``record'' is set to a file name, ! 495: the response is saved at the end of that file. ! 496: See ``flipr''. ! 497: .Cm s ave [\*(fn] ! 498: .C s ave \*(om \*(fn ! 499: Save the specified messages in the given file. ! 500: The file is created if it does not exist. ! 501: The message is deleted from the \*(mx when ! 502: \*(Ma terminates unless ``keepsave'' is set ! 503: (see the ``exit'' and ``quit'' commands). ! 504: .Cm S ave \*(om ! 505: Save the specified messages in a file whose name is derived from ! 506: the author of the first message. ! 507: The name of the file is taken to be the author's name with all ! 508: network addressing stripped off. ! 509: See also the ``Copy'', ``followup'', and ``Followup'' ! 510: commands and ``outfolder''. ! 511: .Cm se t ! 512: .C se t \*(vr ! 513: .C se t \*(vr=\*(st ! 514: .C se t \*(vr=\*(nu ! 515: Define a variable called \*(vr. ! 516: The variable may be given a null, string, or numeric value. ! 517: ``Set'' by itself prints all defined variables and their values. ! 518: See \*(EV for detailed descriptions of the \*(Ma variables. ! 519: .Cm sh ell ! 520: Invoke an interactive shell (see ``SHELL''). ! 521: .Cm si ze \*(om ! 522: Print the size in characters of the specified messages. ! 523: .Cm so urce \*(fn ! 524: Read commands from the given file and return to command mode. ! 525: .Cm to p \*(om ! 526: Print the top few lines of the specified messages. ! 527: If the ``toplines'' variable is set, ! 528: it is taken as the number of lines to print. ! 529: The default is 5. ! 530: .Cm tou ch \*(om ! 531: Touch the specified messages. ! 532: If any message in \*(ml is not specifically saved in a file, ! 533: it will be placed in the \*(mb, ! 534: or the file specified in the MBOX environment variable, upon normal termination. ! 535: See ``exit'' and ``quit''. ! 536: .Cm u ndelete \*(om ! 537: Restore the specified deleted messages. ! 538: Will only restore messages deleted in the current mail session. ! 539: If ``autoprint'' is set, the last message of those restored is printed. ! 540: .Cm undi scard [\*(hf ...] ! 541: Restore printing of the specified header fields when displaying messages ! 542: on the screen. ! 543: .Cm uns et \*(vr ... ! 544: Causes the specified variables to be erased. ! 545: If the variable was imported from the execution environment (i.e., a ! 546: shell variable) then it cannot be erased. ! 547: .Cm ve rsion ! 548: Prints the current version and release date. ! 549: .Cm v isual \*(om ! 550: Edit the given messages with a screen editor. ! 551: The messages are placed in a temporary file and the ``VISUAL'' variable ! 552: is used to get the name of the editor. ! 553: .Cm w rite \*(om \*(fn ! 554: Write the given messages on the specified file, ! 555: minus the header and trailing blank line. ! 556: Otherwise equivalent to the ``save'' command. ! 557: .Cm z [+|\-] ! 558: Scroll the header display forward or backward one screen\-full. ! 559: The number of headers displayed is set by the ``screen'' variable. ! 560: .PD ! 561: .SS \*(Te ! 562: The following commands may be entered only from ! 563: input mode, ! 564: by beginning a line with the tilde escape character (~). ! 565: See ! 566: ``escape'' ! 567: for changing this special character. ! 568: .PP ! 569: .PD 0 ! 570: .Ti ! \*(sh ! 571: Escape to the shell. ! 572: .Ti : \*(mc ! 573: Perform the command-level request. ! 574: .Ti ? ! 575: Print a summary of tilde escapes. ! 576: .Ti A ! 577: Insert the autograph string ``Sign'' into the message. ! 578: .Ti a ! 579: Insert the autograph string ``sign'' into the message. ! 580: .Ti b \*(nm ... ! 581: Add the \*(nmes to the blind carbon copy (Bcc) list. ! 582: See ``askcc''. ! 583: .Ti c \*(nm ... ! 584: Add the \*(nmes to the carbon copy (Cc) list. ! 585: See ``askbcc''. ! 586: .Ti d ! 587: Read in the \*(dl file. ! 588: See ``DEAD''. ! 589: .Ti e ! 590: Invoke the editor on the partial message. ! 591: See ``EDITOR''. ! 592: .Ti f \*(om ! 593: Forward the specified messages. ! 594: The messages are inserted into the message ! 595: without alteration. ! 596: .Ti h ! 597: Prompt for Subject, To, Cc, and Bcc lists. ! 598: If the field is displayed with an initial value, ! 599: it may be edited as if you had just typed it. ! 600: .Ti i \*(st ! 601: Insert the value of the named variable into the text of the message. ! 602: For example, ``~A''is equivalent to ``~i \ Sign''. ! 603: Environment variables set and exported in the shell are also ! 604: accessible by ``~i''. ! 605: .Ti m \*(om ! 606: Insert the specified messages into the letter, ! 607: shifting the new text to the right one tab stop (see ``mprefix''). ! 608: Valid only when sending a message while reading mail. ! 609: .Ti p ! 610: Print the message being entered. ! 611: .Ti q ! 612: Quit from input mode by simulating an interrupt. ! 613: If the body of the message is not null, ! 614: the partial message is saved in \*(dl. ! 615: See ``DEAD'' for a description of this file. ! 616: .Ti r \*(fn ! 617: .br ! 618: .Ti r !\*(sh ! 619: .br ! 620: Read in the specified file. ! 621: If the argument begins with an exclamation point, ! 622: the rest of the string is taken as a shell command ! 623: and is executed, ! 624: with the standard output inserted into the message. ! 625: .Ti R ! 626: Request a return-receipt when the recipient reads the mailbox. ! 627: The return-receipt is generated if the recipient reads the mail using ! 628: .IR post (1), ! 629: AT&T Mail, or OTS. ! 630: .Ti s \*(st ... ! 631: Set the subject line to \*(st. ! 632: .Ti t \*(nm ... ! 633: Add the given \*(nmes to the To list. ! 634: .Ti v ! 635: Invoke a preferred screen editor on the partial message. ! 636: See ``VISUAL''. ! 637: .Ti w \*(fn ! 638: .br ! 639: .Ti w !\*(sh ! 640: .br ! 641: Write the message without the headers onto the given file. ! 642: If the argument begins with an exclamation point, ! 643: the rest of the string is taken as a shell command ! 644: and is executed, ! 645: with the standard input being the message without the headers. ! 646: .Ti x ! 647: Exit as with ! 648: .B ~q ! 649: except the message is not saved in \*(dl. ! 650: .Ti | \*(sh ! 651: Pipe the body of the message through the given \*(sh. ! 652: If the \*(sh returns a successful exit status, ! 653: the output of the command replaces the message. ! 654: .PD ! 655: .SS \*(EV ! 656: The following are environment variables taken from the execution environment and ! 657: are not alterable within \*(Ma. ! 658: .PD 0 ! 659: .Va \s-1HOME\s+1 \*(dr ! 660: The user's base of operations. ! 661: .Va \s-1MAILRC\s+1 \*(fn ! 662: The name of the start-up file. ! 663: Default is \fB$HOME/.mailrc\fR. ! 664: .PD ! 665: .PP ! 666: The following variables are internal \*(Ma variables. ! 667: They may be imported from the execution environment or ! 668: set via the ``set'' command at any time. ! 669: The ``unset'' command may be used to erase variables. ! 670: .PD 0 ! 671: .V allnet ! 672: .Va allnet \fBuucp\f1 ! 673: .Va allnet \fBany\f1 ! 674: .Va allnet \fBheader\f1 ! 675: All network names whose last component (login name) match are treated as ! 676: identical. ! 677: If ! 678: .B uucp ! 679: is the argument, all network names whose two last components ! 680: (system and login name) that match are treated as identical. ! 681: This causes the \*(ml message specifications to behave similarly. ! 682: If ! 683: .B any ! 684: is the argument, ! 685: .I user ! 686: is treated as a pattern to be matched anywhere in the first ! 687: line of a message (similar to /bin/mail). ! 688: .If ! 689: .B header ! 690: is the argument, ! 691: .I user ! 692: is treated as a pattern to be used in a case-independent match ! 693: of either the network address in the first line of a message or ! 694: the full name, as printed by the ``headers'' command. ! 695: Default is ``allnet=any''. ! 696: See also the ``alternates'' command and the ``metoo'' variable. ! 697: .V append ! 698: Upon termination, append messages to the end of the \*(mb file instead of prepending them. ! 699: Enabled by default. ! 700: .V askbcc ! 701: Prompt for the Bcc list after message is entered. ! 702: Default is ``noaskbcc''. ! 703: .V askcc ! 704: Prompt for the Cc list after message is entered. ! 705: Default is ``noaskcc''. ! 706: .V asksub ! 707: Prompt for subject if it is not specified on the command line ! 708: with the \-s option. ! 709: Enabled by default. ! 710: .V autoprint ! 711: Enable automatic printing of messages after ``delete'' ! 712: and ``undelete'' commands. ! 713: Default is ``noautoprint''. ! 714: .V bang ! 715: Enable the special-casing of exclamation points (!) in shell escape ! 716: command lines ! 717: as in ! 718: .IR vi (1). ! 719: Default is ``nobang''. ! 720: .Va cmd \*(sh ! 721: Set the default command for the ``pipe'' command. ! 722: No default value. ! 723: .V crt ! 724: .Va crt \*(nu ! 725: Pipe messages having more than \f2number\f1 lines ! 726: through the command specified by the value of the ``\s-1PAGER\s+1'' variable. ! 727: Enabled by default. ! 728: .Va DEAD \*(fn ! 729: The name of the file in which to save partial letters ! 730: in case of untimely interrupt. ! 731: Default is ! 732: .BR $HOME/dead.letter . ! 733: .V debug ! 734: Enable verbose diagnostics for debugging. ! 735: Messages are not delivered. ! 736: Default is ``nodebug''. ! 737: .V dot ! 738: Take a period on a line by itself during input from a terminal as end-of-file. ! 739: Enabled by default. ! 740: .Va EDITOR \*(sh ! 741: The command to run when the ``edit'' or ``~e'' command is used. ! 742: Default is ``ed''. ! 743: .Va escape \f2c\f1 ! 744: Substitute ! 745: .I c ! 746: for the ~ escape character. ! 747: .V flipf ! 748: Reverse the meanings of the ``followup'' and ``Followup'' commands in ! 749: composition mode. ! 750: Enabled by default. ! 751: .V flipr ! 752: Reverse the meanings of the ``reply'' and ``Reply'' commands in ! 753: composition mode. ! 754: Enabled by default. ! 755: .Va folder \*(dr ! 756: The directory for saving standard mail files. ! 757: User-specified relative file names beginning with a plus (+) ! 758: are expanded by preceding the file name with ! 759: this directory name to obtain the real file name. ! 760: If \*(dr does not start with a slash (/), ! 761: $HOME is prepended to it. ! 762: Default is ! 763: .BR $HOME . ! 764: See also ``outfolder'' below. ! 765: .V header ! 766: Enable printing of the header summary when entering \*(Ma. ! 767: Enabled by default. ! 768: .V hold ! 769: Hold all messages that are read in the mailbox instead of putting them ! 770: in the standard \*(mb file. ! 771: Enabled by default. ! 772: .V ignore ! 773: Ignore interrupts while entering messages. ! 774: Handy for noisy dial-up lines. ! 775: Default is ! 776: .BR noignore . ! 777: .V ignoreeof ! 778: Ignore end-of-file during message input. ! 779: Input must be terminated by a period (.) on a line by itself ! 780: or by the ``~.'' command (see ``dot''). ! 781: Default is ``noignoreeof''. ! 782: .Va iprompt \*(st ! 783: Set the composition mode prompt to \fIstring\fP. ! 784: Default is no prompt. ! 785: .V keepsave ! 786: Keep messages that have been saved in other files in the mailbox ! 787: instead of deleting them. ! 788: Default is ``nokeepsave''. ! 789: .Va \s-1LISTER\s+1 \*(sh ! 790: The command (and options) to use when listing the contents of the ``folder'' ! 791: directory. ! 792: The default is ls. ! 793: .Va \s-1MBOX\s+1 \*(fn ! 794: The name of the file to save messages which have been read. ! 795: The ``xit'' command overrides this function, ! 796: as does saving the message explicitly in another file. ! 797: Default is ! 798: .BR $HOME/mbox . ! 799: .V metoo ! 800: If your login appears as a recipient, ! 801: do not delete it from the list. ! 802: Default is ``nometoo''. ! 803: .Va mprefix \*(st ! 804: Set the leading string to be used with the ``~m'' command. ! 805: Default is a tab character. ! 806: .V onehop ! 807: When responding to a message that was originally sent to several ! 808: recipients, ! 809: the other recipient addresses are normally forced to be relative to the ! 810: originating author's machine for the response. ! 811: This flag disables alteration of the recipients' addresses, ! 812: improving efficiency in a network where all machines can send directly ! 813: to all other machines (i.e., one hop away). ! 814: Disabled by default. ! 815: .V outfolder ! 816: Causes the files used to record outgoing messages to be located ! 817: in the directory specified by the ``folder'' variable unless the ! 818: path name is absolute. ! 819: Default is ``nooutfolder''. ! 820: See ``folder'' and the ! 821: ``Save'', ``Copy'', ``followup'', and ``Followup'' commands. ! 822: .V page ! 823: Used with the ``pipe'' ! 824: command to insert a form feed after each message sent through the pipe. ! 825: Default is ``nopage''. ! 826: .Va \s-1PAGER\s+1 \*(sh ! 827: The command to use as a filter for paginating output. ! 828: This can also be used to specify the options to be used. ! 829: Default is ``pg \-e'' . ! 830: .Va prompt \*(st ! 831: Set the command mode prompt to \*(st. ! 832: Default is ``? ''. ! 833: .V quiet ! 834: Don't print the opening message and version when entering \*(Ma. ! 835: Default is ``quiet''. ! 836: .Va record \*(fn ! 837: Record all outgoing mail in \*(fn. ! 838: Disabled by default. ! 839: See also ``outfolder'' above. ! 840: .V save ! 841: Enable saving of messages in \*(dl on interrupt or delivery error. ! 842: See ``DEAD'' for a description of this file. ! 843: Enabled by default. ! 844: .Va screen \*(nu ! 845: Sets the number of lines in a screen\-full of headers for the ! 846: ``headers'' command. ! 847: Default depends on baud rate. ! 848: .Va sendmail \*(sh ! 849: Alternate command for delivering messages. ! 850: Default is ! 851: .BR /bin/mail . ! 852: .V sendwait ! 853: Wait for background mailer to finish before returning. ! 854: Enabled by default. ! 855: .Va SHELL \*(sh ! 856: The name of a preferred command interpreter. ! 857: Default is ! 858: .BR /bin/sh . ! 859: .V showto ! 860: When displaying the header summary and the message is from you, ! 861: print the recipient's address instead of the author's address. ! 862: Enabled by default. ! 863: .Va sign \*(st ! 864: The variable inserted into the text of a message when the ``~a'' ! 865: command is given. ! 866: No default (see also ~i). ! 867: .Va Sign \*(st ! 868: The variable inserted into the text of a message when the ``~A'' ! 869: command is given. ! 870: No default (see also ~i). ! 871: .Va toplines \*(nu ! 872: The number of lines of header to print with the ``top'' command. ! 873: Default is 5. ! 874: .Va translate \fIcommand\fP ! 875: Run the given address(es) through ! 876: .I command ! 877: for resolution. ! 878: Disabled by default. ! 879: .Va \s-1VISUAL\s+1 \*(sh ! 880: The name of a preferred screen editor. ! 881: Default is ``vi''. ! 882: .PD ! 883: .SH FILES ! 884: .PD 0 ! 885: .TP 30 ! 886: $HOME/.mailrc ! 887: personal start-up file ! 888: .TP ! 889: $HOME/mbox ! 890: secondary storage file ! 891: .TP ! 892: /usr/mail/* ! 893: mailboxes ! 894: .TP ! 895: /usr/lib/mailx.help* ! 896: help message files ! 897: .TP ! 898: /usr/lib/mailx.rc ! 899: optional global start-up file ! 900: .TP ! 901: /tmp/R[emqsx]* ! 902: temporary files ! 903: .PD ! 904: .SH SEE ALSO ! 905: ls(1), ! 906: mail(1), ! 907: post(1), ! 908: pg(1).
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.