Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / conf / doc / RCS / msgchk.rf,v
1 head    1.7;
2 access;
3 symbols;
4 locks; strict;
5
6
7 1.7
8 date    92.02.04.21.41.41;      author jromine; state Exp;
9 branches;
10 next    1.6;
11
12 1.6
13 date    90.04.09.20.22.46;      author sources; state Exp;
14 branches;
15 next    1.5;
16
17 1.5
18 date    90.04.05.15.13.33;      author sources; state Exp;
19 branches;
20 next    1.4;
21
22 1.4
23 date    90.03.22.11.31.29;      author sources; state Exp;
24 branches;
25 next    1.3;
26
27 1.3
28 date    90.03.20.19.42.08;      author sources; state Exp;
29 branches;
30 next    1.2;
31
32 1.2
33 date    90.03.20.17.36.24;      author sources; state Exp;
34 branches;
35 next    1.1;
36
37 1.1
38 date    90.03.20.17.21.08;      author sources; state Exp;
39 branches;
40 next    ;
41
42
43 desc
44 @@
45
46
47 1.7
48 log
49 @contributed patch
50 @
51 text
52 @.\"    @@(MHWARNING)
53 .\" @@(#)$Id: msgchk.rf,v 1.6 1990/04/09 20:22:46 sources Exp jromine $
54 .SC MSGCHK 1
55 .NA
56 msgchk \- check for messages
57 .SY
58 msgchk
59 \%[\-date] \%[\-nodate]
60 \%[\-notify\ all/mail/nomail] \%[\-nonotify\ all/mail/nomail]
61 @@BEGIN: POP
62 \%[\-host\ host] \%[\-user\ user]
63 \%[\-apop] \%[\-noapop]
64 \%[\-rpop] \%[\-norpop]
65 @@END: POP
66 \%[users\ ...]
67 \%[\-help]
68 .DE
69 The \fImsgchk\fR program checks all known mail drops for mail waiting
70 for you.
71 For those drops which have mail for you,
72 \fImsgchk\fR will indicate if it believes that you have seen the mail
73 in question before.
74
75 The `\-notify\ type' switch indicates under what circumstances \fImsgchk\fR
76 should produce a message.
77 The default is `\-notify\ all' which says that \fImsgchk\fR should always
78 report the status of the users maildrop.
79 Other values for `type' include `mail' which says that \fImsgchk\fR should
80 report the status of waiting mail;
81 and, `nomail' which says that \fImsgchk\fR should report the status of empty
82 maildrops.
83 The `\-nonotify\ type' switch has the inverted sense,
84 so `\-nonotify\ all' directs \fImsgchk\fR to never report the status of
85 maildrops.
86 This is useful if the user wishes to check \fImsgchk\fR's exit status.
87 A non\-zero exit status indicates that mail was \fBnot\fR waiting for at
88 least one of the indicated users.
89
90 If \fImsgchk\fR produces output,
91 then the `\-date' switch directs \fImsgchk\fR to print out the last date mail
92 was read,
93 if this can be determined.
94 @@BEGIN: POP
95
96 If the local host is configured as a POP client,
97 or if the `\-host\ host' switch is given,
98 \fImsgchk\fR will query the POP service host as to the status of mail waiting.
99 If the `\-user\ user' switch is not given,
100 then the current username is used.
101 Normally,
102 \fImsgchk\fR will prompt for a password to use.
103 However,
104 if the `\-apop' switch is given,
105 \fImsgchk\fR will generate authentication credentials to provide
106 for origin authentication and replay protection,
107 but which do not involve sending a password in the clear over the network.
108 Otherwise,
109 if the `\-rpop' switch is given,
110 then \fImsgchk\fR will try to use a \*(lqtrusted\*(rq connection
111 (ala the BSD r-commands).
112 @@END: POP
113 .Fi
114 ^$HOME/\&.mh\(ruprofile~^The user profile
115 ^@@(MHETCPATH)/mtstailor~^tailor file
116 ^@@(MHDROPLOC)~^Location of mail drop
117 .Pr
118 None
119 .Sa
120 @@BEGIN: POP
121 \fIPost Office Protocol - version 3\fR (aka RFC\-1081),
122 .br
123 @@END: POP
124 inc(1)
125 .De
126 `user' defaults to the current user
127 .Ds
128 `\-date'
129 .Ds
130 `\-notify\ all'
131 @@BEGIN: POP
132 .Ds
133 `\-rpop'
134 @@END: POP
135 .Co
136 None
137 .En
138 @
139
140
141 1.6
142 log
143 @fixup RFC references
144 @
145 text
146 @d2 1
147 a2 1
148 .\" @@(#)$Id: msgchk.rf,v 1.5 90/04/05 15:13:33 sources Exp Locker: sources $
149 d12 1
150 d48 13
151 a60 6
152 The `\-user\ user' switch may be given to specify the name of the POP
153 subscriber you wish to check mail for on the POP service host.
154 The `\-rpop' switch uses the UNIX \fIrPOP\fR
155 (authentication done via trusted connections).
156 In contrast, the `\-norpop' switch uses the ARPA \fIPOP\fR
157 (in which case \fImsgchk\fR will prompt for a password).
158 @
159
160
161 1.5
162 log
163 @add ID
164 @
165 text
166 @d2 1
167 a2 1
168 .\" @@(#)$Id:$
169 d62 1
170 a62 1
171 \fIPost Office Protocol (revised)\fR (aka RFC\-819 with revisions),
172 @
173
174
175 1.4
176 log
177 @put things back, do .NA stuff another way
178 @
179 text
180 @d2 1
181 @
182
183
184 1.3
185 log
186 @typo
187 @
188 text
189 @d2 2
190 a3 2
191 .TH MSGCHK 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
192 .SH .NA
193 d5 1
194 a5 1
195 .SH .SY
196 @
197
198
199 1.2
200 log
201 @fixup for makewhatis
202 @
203 text
204 @d2 1
205 a2 1
206 .TH MSGCHK 1 [mh.6] MH
207 @
208
209
210 1.1
211 log
212 @Initial revision
213 @
214 text
215 @d2 2
216 a3 2
217 .SC MSGCHK 1
218 .NA
219 d5 1
220 a5 1
221 .SY
222 @