Return to notify.1 CVS log

Up to [Research Unix] / researchv10no / lbin / mailx / man

Annotation of researchv10no/lbin/mailx/man/notify.1, revision 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

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