version 1.14, 2003/06/03 02:56:13 |
version 1.15, 2003/10/04 21:55:12 |
|
|
.Nd system messages and junk mail program |
.Nd system messages and junk mail program |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm msgs |
.Nm msgs |
.Op Fl fhlpqr |
.Op Fl fhlopqr |
.Op Ar number |
.Op Oo Fl Oc Ar number |
.Op Ar \-number |
|
.Nm msgs |
.Nm msgs |
.Op Fl s |
.Op Fl s |
.Nm msgs |
.Nm msgs |
.Op Fl c Op Ar days |
.Op Fl c Op Fl Ns Ar days |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm msgs |
.Nm msgs |
is used to read system messages. |
is used to read system messages. |
|
|
of the system. |
of the system. |
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width "-number" |
|
.It Fl c Fl Ns Ar days |
|
The |
|
.Fl c |
|
option is used for performing cleanup on |
|
.Pa /var/msgs . |
|
An entry with the |
|
.Fl c |
|
option should be placed in the system |
|
.Xr crontab 5 |
|
to run every night. |
|
This will remove all messages over 21 days old. |
|
The optional |
|
.Fl Ns Ar days |
|
argument may be specified on the command line to override the default. |
.It Fl f |
.It Fl f |
Do not say |
Do not say |
.Dq \&No new messages. |
.Dq \&No new messages. |
This is useful in a |
This is useful in a |
.Pa .login |
.Pa .login |
file since this is often the case here. |
file since this is often the case here. |
|
.It Fl h |
|
Print the first part of messages only. |
|
.It Fl l |
|
Causes only locally originated messages to be reported. |
|
.It Fl o |
|
By default, |
|
.Nm |
|
exits when there are no more messages to read. |
|
If the |
|
.Fl o |
|
flag is specified, |
|
the user will be given the chance to save or read messages again. |
|
.It Fl p |
|
Pipe long messages through the program specified by the |
|
.Ev PAGER |
|
environment variable. |
|
If |
|
.Ev PAGER |
|
is null or not defined, |
|
.Xr more 1 |
|
is used. |
.It Fl q |
.It Fl q |
Queries whether there are messages, printing |
Queries whether there are messages, printing |
.Dq There are new messages. |
.Dq There are new messages. |
if there are. |
if there are. |
The command |
The command |
.Ic msgs \-q |
.Ic msgs -q |
is often used in login scripts. |
is often used in login scripts. |
.It Fl h |
|
Print the first part of messages only. |
|
.It Fl r |
.It Fl r |
Disables the ability to save messages or enter the mailer. |
Disables the ability to save messages or enter the mailer. |
It is assumed that the |
It is assumed that the |
.Ev PAGER |
.Ev PAGER |
environment is set to something secure. |
environment is set to something secure. |
.It Fl l |
.It Fl s |
Causes only locally originated messages to be reported. |
The |
|
.Fl s |
|
option is used for setting up the posting of messages. |
|
The line |
|
.Pp |
|
.Dl msgs: \&"| /usr/bin/msgs -s\&" |
|
.Pp |
|
should be included in |
|
.Pa /etc/mail/aliases |
|
(see |
|
.Xr newaliases 8 ) |
|
to enable posting of messages. |
.It Ar number |
.It Ar number |
A message number can be given |
A message number can be given |
on the command line, causing |
on the command line, causing |
.Nm msgs |
.Nm msgs |
to start at the specified message rather than at the next message |
to start at the specified message rather than at the next message |
indicated by your |
indicated by your |
.Pa \&.msgsrc |
.Pa .msgsrc |
file. |
file. |
Thus |
Thus |
.Pp |
.Pp |
.Dl msgs \-h 1 |
.Dl msgs -h 1 |
.Pp |
.Pp |
prints the first part of all messages. |
prints the first part of all messages. |
.It Ar \-number |
.It Fl Ns Ar number |
Start |
Start |
.Ar number |
.Ar number |
messages back from the one indicated in the |
messages back from the one indicated in the |
.Pa \&.msgsrc |
.Pa .msgsrc |
file, useful for reviews of recent messages. |
file; useful for reviews of recent messages. |
.It Fl p |
|
Pipe long messages through the program specified by the |
|
.Ev PAGER |
|
environment variable. |
|
If |
|
.Ev PAGER |
|
is null or not defined, |
|
.Xr more 1 |
|
is used. |
|
.El |
.El |
.Pp |
.Pp |
.Nm msgs |
.Nm msgs |
|
|
.It Ic n |
.It Ic n |
Skip this message |
Skip this message |
and go on to the next message. |
and go on to the next message. |
.It Ic \&- |
.It Ic - |
Redisplay the last message. |
Redisplay the last message. |
.It Ic q |
.It Ic q |
Drop out of |
Drop out of |
|
|
Append the current message to the file |
Append the current message to the file |
.Pa Messages |
.Pa Messages |
in the current directory; |
in the current directory; |
.Sq s\- |
.Sq s- |
will save the previously displayed message. |
will save the previously displayed message. |
An |
An |
.Sq s |
.Sq s |
or |
or |
.Sq s\- |
.Sq s- |
may be followed by a space and a file name to receive the message replacing |
may be followed by a space and a file name to receive the message replacing |
the default |
the default |
.Dq Messages . |
.Dq Messages . |
|
|
and |
and |
.Ic s |
.Ic s |
all accept a numeric argument in place of the |
all accept a numeric argument in place of the |
.Sq \&- . |
.Sq - . |
.Pp |
.Pp |
.Nm msgs |
.Nm msgs |
keeps track of the next message you will see by a number in the file |
keeps track of the next message you will see by a number in the file |
.Pa \&.msgsrc |
.Pa .msgsrc |
in your home directory. |
in your home directory. |
In the directory |
In the directory |
.Pa /var/msgs |
.Pa /var/msgs |
|
|
so that |
so that |
.Nm msgs |
.Nm msgs |
can quickly determine if there are no messages for you. |
can quickly determine if there are no messages for you. |
If the contents of |
.\" If the contents of |
.Pa bounds |
.\" .Pa bounds |
is incorrect it can be fixed by removing it; |
.\" is incorrect it can be fixed by removing it; |
.Nm msgs |
.\" .Nm msgs |
will make a new |
.\" will make a new |
.Pa bounds |
.\" .Pa bounds |
file the next time it is run. |
.\" file the next time it is run. |
.Pp |
.Pp |
The |
|
.Fl s |
|
option is used for setting up the posting of messages. |
|
The line |
|
.Pp |
|
.Dl msgs: \&"\&| /usr/bin/msgs \-s\&" |
|
.Pp |
|
should be included in |
|
.Pa /etc/mail/aliases |
|
(see |
|
.Xr newaliases 8 ) |
|
to enable posting of messages. |
|
.Pp |
|
The |
|
.Fl c |
|
option is used for performing cleanup on |
|
.Pa /var/msgs . |
|
An entry with the |
|
.Fl c |
|
option should be placed in |
|
.Pa /etc/crontab |
|
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. |
|
.Pp |
|
Within |
Within |
.Nm msgs |
.Nm msgs |
you can also go to any specific message by typing its number when |
you can also go to any specific message by typing its number when |
|
|
.Xr mail 1 , |
.Xr mail 1 , |
.Xr more 1 , |
.Xr more 1 , |
.Xr aliases 5 , |
.Xr aliases 5 , |
.\".Xr crontab 5 , |
.Xr crontab 5 , |
.Xr newaliases 8 |
.Xr newaliases 8 |
.Sh HISTORY |
.Sh HISTORY |
The |
The |