Annotation of researchv10no/lbin/mailx/man/notify.1, revision 1.1.1.1

1.1       root        1: '\"macro stdmacro
                      2: .if n .pH g1.notify %W% of %G%
                      3: .nr X
                      4: .if \nX=0 .ds x} notify 1 "Essential Utilities" "\&"
                      5: .if \nX=1 .ds x} notify 1 "Essential Utilities"
                      6: .if \nX=2 .ds x} notify 1 "" "\&"
                      7: .if \nX=3 .ds x} notify "" "" "\&"
                      8: .TH \*(x}
                      9: .SH NAME
                     10: \f4notify\f1 \- notify user of the arrival of new mail 
                     11: .SH SYNOPSIS
                     12: \f4notify\fP \f4\-y\fP [ \f4\-m\fP \f2mailfile\fP ]
                     13: .br
                     14: \f4notify\fP [ \f4\-n\fP ]
                     15: .SH DESCRIPTION
                     16: .PP
                     17: When a new mail message arrives,
                     18: the \f4mail\fP command first checks if the recipient's mailbox indicates
                     19: that the message is to be forwarded elsewhere (to some other recipient or
                     20: as the input to some command).
                     21: \f4notify\fP is used to set up forwarding on the user's mailbox so that the new
                     22: message is saved into an alternative mailbox and,
                     23: if the user is currently logged in,
                     24: he or she is notified immediately of the arrival of new mail.
                     25: .PP
                     26: Command-line options are:
                     27: .sp .5
                     28: .PD 0
                     29: .TP 12
                     30: \f4\-m\f2\0mailfile\f1
                     31: File to save mail messages into while automatic notification is activated.
                     32: If not specified, it defaults to \f2$HOME/.mailfile\fP.
                     33: .TP
                     34: \f4\-n\f1
                     35: Remove mail notification facility
                     36: .TP
                     37: \f4\-y\f1
                     38: Install mail notification facility
                     39: .PD
                     40: .PP
                     41: If invoked with no arguments,
                     42: \f4notify\fP reports whether automatic mail notification is activated or not.
                     43: .PP
                     44: The notification is done by looking in \f4/etc/utmp\f1 to
                     45: determine if the recipient is currently logged in,
                     46: and if so, on which terminal device. 
                     47: Then the terminal device is opened for writing and the user is notified about
                     48: the new message.
                     49: The notification will indicate who the message is from.
                     50: If the message contains a \f4Subject:\fP header line it will be included.
                     51: (For security, all unprintable characters within the header will be converted
                     52: to an exclamation point.)
                     53: .PP
                     54: If the user is logged in multiple times he or she will get multiple
                     55: notifications, one per terminal.
                     56: To disable notifications to a particular login session,
                     57: the \f4mesg\fP(1) command can be used to disable writing
                     58: to that terminal.
                     59: .PP
                     60: If there are multiple machines connected together via RFS or NFS,
                     61: \f4notify\f1 will look up the \f4/etc/utmp\fP files on the other systems as
                     62: well.
                     63: To do this, the file \f4/etc/mail/notify.sys\f1 will be
                     64: consulted, which will contain two columns, the first being the name of a
                     65: system and the second being a path to find the root filesystem for that
                     66: machine.
                     67: .PP
                     68: If \f4notify\fP has troubles delivering the mail to the specified mailfile,
                     69: \f4notify\fP
                     70: will look up the directory of the mailfile in \f4/etc/mail/notify.fsys\fP.
                     71: If the file's directory is found in the first column of the file, the mail will be
                     72: forwarded to the system listed in the second column instead of being returned
                     73: to the sender.
                     74: .SH FILES
                     75: .PD 0
                     76: .TP 18
                     77: \f4/tmp/notif\f1\(**
                     78: temporary file
                     79: .TP 18
                     80: \f4/var/mail/\f1\(**
                     81: users' standard mailboxes
                     82: .TP 18
                     83: \f4/usr/lib/mail/notify2\f1
                     84: program that performs the notification
                     85: .TP 18
                     86: \f4/etc/mail/notify.fsys\f1
                     87: list of file systems and home systems
                     88: .TP 18
                     89: \f4/etc/mail/notify.sys\f1
                     90: list of machines and paths to their root filesystems
                     91: .TP 18
                     92: \f4/etc/utmp\f1
                     93: list of users who are logged in
                     94: .PD
                     95: .SH SEE ALSO
                     96: \f4mail\fP(1), \f4mesg\fP(1).
                     97: .br
                     98: .IR "User\'s Guide" .
                     99: .br
                    100: .ne 8
                    101: .SH NOTES
                    102: Because \f4notify\fP uses the ``\f4Forward to \(bv\f2command\f1'' facility of
                    103: \f4mail\fP to implement notifications,
                    104: \f4/var/mail/\f2username\f1 should not be specified as the place
                    105: to put newly arrived messages via the \f4\-m\fP invocation option.
                    106: The \f4mail\fP command uses
                    107: \f4/var/mail/\f2username\f1 to hold either mail messages,
                    108: \f4or\fP indications of mail forwarding,
                    109: but not both simultaneously.
                    110: .PP
                    111: If the user is using \f4layers\fP(1),
                    112: the notification will \f4only\fP appear in the \f4login\fP window.
                    113: .\"@(#)notify.1        1.2
                    114: .Ee

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.