[0m


MSGS(1)             UNIX Programmer's Manual		  MSGS(1)



[1mNAME
     [0mmsgs - system messages and junk mail program

[1mSYNOPSIS
     msgs [0m[ [1m-fhlpq [0m] [ number ] [ -number ]

     [1mmsgs -s

     msgs -c [0m[ -days ]

[1mDESCRIPTION
     [0m_M_s_g_s is used to read system messages.  These messages are
     sent by mailing to the login `msgs' and should be short
     pieces of information which are suitable to be read once by
     most users of the system.

     _M_s_g_s is normally invoked each time you login, by placing it
     in the file ._l_o_g_i_n (._p_r_o_f_i_l_e if you use /_b_i_n/_s_h).	It will
     then prompt you with the source and subject of each new mes-
     sage.  If there is no subject line, the first few non-blank
     lines of the message will be displayed.  If there is more to
     the message, you will be told how long it is and asked
     whether you wish to see the rest of the message.  The possi-
     ble responses are:

     [1my	    [0mtype the rest of the message.

     RETURN synonym for y.

     [1mn	    [0mskip this message and go on to the next message.

     [1m-	    [0mredisplay the last message.

     [1mq	    [0mdrops you out of _m_s_g_s; the next time you run the pro-
	    gram it will pick up where you left off.

     [1ms	    [0mappend the current message to the file ``Messages''
	    in the current directory; `s-' will save the previ-
	    ously displayed message. A `s' or `s-' may be fol-
	    lowed by a space and a file name to receive the mes-
	    sage replacing the default ``Messages''.

     [1mm	    [0mor `m-' causes a copy of the specified message to be
	    placed in a temporary mailbox and _m_a_i_l(1) to be
	    invoked on that mailbox.  Both `m' and `s' accept a
	    numeric argument in place of the `-'.

     _M_s_g_s keeps track of the next message you will see by a
     number in the file ._m_s_g_s_r_c in your home directory.  In the
     directory /_u_s_r/_m_s_g_s it keeps a set of files whose names are
     the (sequential) numbers of the messages they represent.
     The file /_u_s_r/_m_s_g_s/_b_o_u_n_d_s shows the low and high number of



Printed 31/1/92     Revision 1.2 of 19/10/88			1






MSGS(1)             UNIX Programmer's Manual		  MSGS(1)



     the messages in the directory so that _m_s_g_s can quickly
     determine if there are no messages for you.  If the contents
     of _b_o_u_n_d_s is incorrect it can be fixed by removing it; _m_s_g_s
     will make a new _b_o_u_n_d_s file the next time it is run.

     The [1m-s [0moption is used for setting up the posting of mes-
     sages.  The line

	  msgs: "| /usr/ucb/msgs -s"

     should be include in /_u_s_r/_l_i_b/_a_l_i_a_s_e_s to enable posting of
     messages.

     The [1m-c [0moption is used for performing cleanup on /_u_s_r/_m_s_g_s.
     An entry with the [1m-c [0moption should be placed in
     /_u_s_r/_l_i_b/_c_r_o_n_t_a_b to run every night.  This will remove all
     messages over 21 days old.  A different expiration may be
     specified on the command line to override the default.

     Options when reading messages include:

     [1m-f     [0mwhich causes it not to say ``No new messages.''.
	    This is useful in your ._l_o_g_i_n file since this is
	    often the case here.

     [1m-q     [0mQueries whether there are messages, printing ``There
	    are new messages.'' if there are.  The command ``msgs
	    -q'' is often used in login scripts.

     [1m-h     [0mcauses _m_s_g_s to print the first part of messages only.

     [1m-l     [0moption causes only locally originated messages to be
	    reported.

     _n_u_m    A message number can be given on the command line,
	    causing _m_s_g_s to start at the specified message rather
	    than at the next message indicated by your ._m_s_g_s_r_c
	    file.  Thus

		msgs -h 1

	    prints the first part of all messages.

     -_n_u_m_b_e_r
	    will cause _m_s_g_s to start _n_u_m_b_e_r messages back from
	    the one indicated by your ._m_s_g_s_r_c file, useful for
	    reviews of recent messages.

     [1m-p     [0mcauses long messages to be piped through _m_o_r_e(1).

     Within _m_s_g_s you can also go to any specific message by typ-
     ing its number when _m_s_g_s requests input as to what to do.



Printed 31/1/92     Revision 1.2 of 19/10/88			2






MSGS(1)             UNIX Programmer's Manual		  MSGS(1)



[1mFILES
     [0m/usr/msgs/*	 database
     ~/.msgsrc		 number of next message to be presented

[1mAUTHORS
     [0mWilliam Joy
     David Wasley

[1mSEE ALSO
     [0maliases(5), crontab(5), mail(1), more(1)

[1mBUGS








































[0mPrinted 31/1/92     Revision 1.2 of 19/10/88			3






[0m