0
|
1 .\" This file is automatically generated. Do not edit!
|
|
2 .\" @(#)$Id$
|
|
3 .SC POPI 1
|
|
4 .NA
|
|
5 popi \- POP initiator
|
|
6 .SY
|
|
7 popi
|
|
8 \%[+folder]
|
|
9 \%[\-host\ host] \%[\-user\ user]
|
|
10 \%[\-apop] \%[\-noapop]
|
|
11 \%[\-rpop] \%[\-norpop]
|
|
12 \%[\-form\ formatfile]
|
|
13 \%[\-format\ string]
|
|
14 \%[\-width\ columns]
|
|
15 \%[\-help]
|
|
16 .DE
|
|
17 \fIpopi\fR is an interactive program that implements the client side
|
|
18 of the Post Office Protocol (version 3).
|
|
19
|
|
20 When invoked,
|
|
21 \fIpopi\fR establishes a POP connection,
|
|
22 and enters a command loop.
|
|
23 The user may type most of the normal POP commands,
|
|
24 with a couple of additions:
|
|
25 The commands that \fIpop\fR currently supports are:
|
|
26 .sp 1
|
|
27 .in +.5i
|
|
28 dele msg
|
|
29 .br
|
|
30 last
|
|
31 .br
|
|
32 list [msg]
|
|
33 .br
|
|
34 noop
|
|
35 .br
|
|
36 quit
|
|
37 .br
|
|
38 retr msg
|
|
39 .br
|
|
40 rset
|
|
41 .br
|
|
42 scan
|
|
43 .br
|
|
44 stat
|
|
45 .br
|
|
46 top
|
|
47 .in -.5i
|
|
48 .sp
|
|
49 The \fIretr\fR command retrieves a message into the folder specified
|
|
50 on the command line.
|
|
51 The \fIscan\fR command downloads an MH format-string to the server
|
|
52 (as determined from the `\-form\ formatfile' and `\-format switches),
|
|
53 so that future invocations of the \fIlist\fR command will include a
|
|
54 scan listing.
|
|
55 The \fIquit\fR command terminates \fIpopi\fR,
|
|
56 as does typing CTRL\-D.
|
|
57
|
|
58
|
|
59 The `\-host\ host' switch specifies the POP server to use.
|
|
60 If the `\-user\ user' switch is not given,
|
|
61 then the current username is used.
|
|
62 Normally,
|
|
63 \fIpopi\fR will prompt for a password to use.
|
|
64 However,
|
|
65 if the `\-apop' switch is given,
|
|
66 \fIpopi\fR will generate authentication credentials to provide
|
|
67 for origin authentication and replay protection,
|
|
68 but which do not involve sending a password in the clear over the network.
|
|
69 Otherwise,
|
|
70 if the `\-rpop' switch is given,
|
|
71 then \fIpopi\fR will try to use a \*(lqtrusted\*(rq connection
|
|
72 (ala the BSD r-commands).
|
|
73 .Fi
|
|
74 ^$HOME/\&.mh\(ruprofile~^The user profile
|
|
75 ^/usr/local/mh/lib/mtstailor~^tailor file
|
|
76 .Pr
|
|
77 ^Path:~^To determine the user's MH directory
|
|
78 .Ps
|
|
79 ^Msg\-Protect:~^To set mode when creating a new `file'
|
|
80 .Sa
|
|
81 msh(1)
|
|
82 .De
|
|
83 `+folder' defaults to \*(lqinbox\*(rq
|
|
84 .Ds
|
|
85 `\-noapop'
|
|
86 .Ds
|
|
87 `\-norpop'
|
|
88 .Ds
|
|
89 `\-format' defaulted as described above
|
|
90 .Ds
|
|
91 `\-width' defaulted to the width of the terminal
|
|
92 .Co
|
|
93 The folder into which messages are being incorporated will become the
|
|
94 current folder.
|
|
95 The current message is unchanged.
|
|
96 .Bu
|
|
97 The argument to the `\-format' switch must be interpreted as a single token
|
|
98 by the shell that invokes \fIinc\fR.
|
|
99 Therefore,
|
|
100 one must usually place the argument to this switch inside double\-quotes.
|
|
101 .En
|