|
|
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.