01/20/86 read_mail request: list, ls Syntax: ls {message_specifiers} {-selection_args} {-control_args} Syntax as an active request: [ls {message_specifiers} {-selection_args} {-control_args}] Function: displays a tabular summary of the selected messages. As an active request, returns the message numbers of the selected messages. Arguments: message_specifiers identifies which messages are to be listed. If no message_specifiers and no selection_args are specified, all messages are listed. For more information on message specifiers, type: help message_specifiers.gi Control arguments: -include_deleted, -idl includes all messages in the mailbox whether or not they have been deleted when processing message_specifiers and selection_args to determine which messages will be listed. -only_deleted, -odl includes only those messages which have been deleted. -only_non_deleted, -ondl includes only those messages which have not been deleted. (Default) -header, -he preceeds the message listing by a header line which identifies the columns of the list. (Default) -no_header, -nhe omits the header line from the listing. -line_length N, -ll N uses the supplied line length when determining where and if to truncate the message subject. (Default-- the terminal's line length) -no_line_length, -nll does not truncate the message subject. -reverse, -rv lists the messages in descending numeric order. -no_reverse, -nrv lists the messages in ascending numeric order. (Default) List of message selection control arguments: The following control arguments are used to further refine the list of messages to be listed. For more detailed information, type: help selection_control_args.gi -case_sensitive, -cs causes subject selections and qedx regular expression searches for author and recipient selections to be case sensitive. (Default) -non_case_sensitive, -ncs causes subject selections and qedx regular expression searches for author and recipient selections to be case insensitive. -subject STR, -subject /STR/, -sj STR, -sj /STR/ selects any messages whose Subject field contains STR. -in_reply_to STR, -in_reply_to /STR/, -irt STR, -irt /STR/ selects any messages whose In-Reply-To field contains STR. -between DT1 DT2, -bt DT1 DT2 selects any messages which were created between the dates DT1 and DT2 inclusively. -after DT, -af DT selects any messages which were created on or after the date specified by DT. -before DT, -be DT selects any messages which were created before the date specified by DT. -date DT, -dt DT selects any messages which were created on the date specified by DT. -between_time DT1 DT2, -btt DT1 DT2 selects any messages which were created between the date/times specified by DT1 and DT2 inclusively. -before_time DT, -bet DT selects any messages which were created before the date/time specified by DT. -after_time DT, -aft DT selects any messages which were created after the date/time specified by DT. -from address, -from /STR/, -fm address, -fm /STR/ selects any messages whose From field either contains the specified address or matches the given qedx regular expression. -reply_to address, -reply_to /STR/, -rpt address, -rpt /STR/ selects any messages whose Reply-To field either contains the specified address or matches the given qedx regular expression. -recipient address, -recipient /STR/, -rcp address, -rcp /STR/ selects any messages whose To, cc, bcc, or Redistributed-To fields either contains the specified address or matches the given qedx regular expression. -to address, -to /STR/ selects any messages whose To field either contains the specified address or matches the given regular expression. -cc address, -cc /STR/ selects any messages whose cc field either contains the specified address or matches the given qedx regular expression. -bcc address, -bcc /STR/ selects any messages whose bcc field either contains the specified address or matches the given qedx regular expression. -forwarded_to address, -forwarded_to /STR/, -fwdt address, -fwdt /STR/ selects any messages whose Redistributed-To field either contains the specified address or matches the given qedx regular expression. Notes on listing format: One line is printed for each message. Its format is: N*SA (L)F MM/DD/YY HH:MM AUTHOR SUBJECT where N is the message number and L is the number of lines in the body of the message. The "*", "S", "A", and "F" are optional flags and are described below. MM/DD/YY HH:MM is the date/time when the message was created. AUTHOR is that part of the first author's name which will fit in the space provided; if the first author does not have a name, the printed representation of his address is used instead; the authors of a message are listed in the From field. SUBJECT is that part of the message's subject which will fit on the remainder of the line; if the message is an interactive message and does not have a subject, the actual text of the message is used instead. The * after the message number appears if this is the current message. If "-idl" or "-odl" is specified and this message has been marked for deletion, an exclamation point (!) appears here instead. If this message cannot be deleted because its access class is not equal to the user's process authorization, an ampersand (&) appears here instead. An "S" appears in the next column if the message has previously been printed by the print request. The "S" indicates a "seen" message, as referred to by the "seen", "unseen", and "new" message specifier keywords. An "A" appears in the next column if the message requires an acknowledgement and one has not yet been delivered. An "F" appears after the line count if the message was forwarded by one of its recipients to the mailbox being examined. Examples of listing lines: 34* & (56) 03/27/83 12:56 Peter Kelley Mail system in 6 A (150)F 10/01/83 10:27 GMP at MIT-MC First draft of ----------------------------------------------------------- Historical Background This edition of the Multics software materials and documentation is provided and donated to Massachusetts Institute of Technology by Group BULL including BULL HN Information Systems Inc. as a contribution to computer science knowledge. This donation is made also to give evidence of the common contributions of Massachusetts Institute of Technology, Bell Laboratories, General Electric, Honeywell Information Systems Inc., Honeywell BULL Inc., Groupe BULL and BULL HN Information Systems Inc. to the development of this operating system. Multics development was initiated by Massachusetts Institute of Technology Project MAC (1963-1970), renamed the MIT Laboratory for Computer Science and Artificial Intelligence in the mid 1970s, under the leadership of Professor Fernando Jose Corbato. Users consider that Multics provided the best software architecture for managing computer hardware properly and for executing programs. Many subsequent operating systems incorporated Multics principles. Multics was distributed in 1975 to 2000 by Group Bull in Europe , and in the U.S. by Bull HN Information Systems Inc., as successor in interest by change in name only to Honeywell Bull Inc. and Honeywell Information Systems Inc. . ----------------------------------------------------------- Permission to use, copy, modify, and distribute these programs and their documentation for any purpose and without fee is hereby granted,provided that the below copyright notice and historical background appear in all copies and that both the copyright notice and historical background and this permission notice appear in supporting documentation, and that the names of MIT, HIS, BULL or BULL HN not be used in advertising or publicity pertaining to distribution of the programs without specific prior written permission. Copyright 1972 by Massachusetts Institute of Technology and Honeywell Information Systems Inc. Copyright 2006 by BULL HN Information Systems Inc. Copyright 2006 by Bull SAS All Rights Reserved