xref: /freebsd/crypto/heimdal/appl/push/push.8 (revision 6a068746777241722b2b32c5d0bc443a2a64d80b)
1*ae771770SStanislav Sedov.\" $Id$
2b528cefcSMark Murray.\"
3b528cefcSMark Murray.Dd May 31, 1998
4b528cefcSMark Murray.Dt PUSH 8
5b528cefcSMark Murray.Os HEIMDAL
6b528cefcSMark Murray.Sh NAME
7b528cefcSMark Murray.Nm push
845524cd7SAssar Westerlund.Nd fetch mail via POP
9b528cefcSMark Murray.Sh SYNOPSIS
10b528cefcSMark Murray.Nm
11*ae771770SStanislav Sedov.Op Fl 5 | Fl Fl krb5
12*ae771770SStanislav Sedov.Op Fl v | Fl Fl verbose
13*ae771770SStanislav Sedov.Op Fl f | Fl Fl fork
14b528cefcSMark Murray.Op Fl l | -leave
15*ae771770SStanislav Sedov.Op Fl Fl from
16b528cefcSMark Murray.Op Fl c | -count
17*ae771770SStanislav Sedov.Op Fl Fl headers Ns = Ns Ar headers
18b528cefcSMark Murray.Oo Fl p Ar port-spec  \*(Ba Xo
19*ae771770SStanislav Sedov.Fl Fl port Ns = Ns Ar port-spec
20b528cefcSMark Murray.Xc
215e9cd1aeSAssar Westerlund.Oc
22b528cefcSMark Murray.Ar po-box
23b528cefcSMark Murray.Pa filename
24b528cefcSMark Murray.Sh DESCRIPTION
25b528cefcSMark Murray.Nm
26b528cefcSMark Murrayretrieves mail from the post office box
27b528cefcSMark Murray.Ar po-box ,
28b528cefcSMark Murrayand stores the mail in mbox format in
29b528cefcSMark Murray.Pa filename .
30b528cefcSMark MurrayThe
31b528cefcSMark Murray.Ar po-box
32b528cefcSMark Murraycan have any of the following formats:
33b528cefcSMark Murray.Bl -hang -compact -offset indent
34b528cefcSMark Murray.It Ql hostname:username
35b528cefcSMark Murray.It Ql po:hostname:username
36b528cefcSMark Murray.It Ql username@hostname
37b528cefcSMark Murray.It Ql po:username@hostname
38b528cefcSMark Murray.It Ql hostname
39b528cefcSMark Murray.It Ql po:username
40b528cefcSMark Murray.El
415e9cd1aeSAssar Westerlund.Pp
42b528cefcSMark MurrayIf no username is specified,
43b528cefcSMark Murray.Nm
44b528cefcSMark Murrayassumes that it's the same as on the local machine;
45b528cefcSMark Murray.Ar hostname
46b528cefcSMark Murraydefaults to the value of the
47b528cefcSMark Murray.Ev MAILHOST
48b528cefcSMark Murrayenvironment variable.
495e9cd1aeSAssar Westerlund.Pp
50b528cefcSMark MurraySupported options:
51b528cefcSMark Murray.Bl -tag -width Ds
52b528cefcSMark Murray.It Xo
538373020dSJacques Vidrine.Fl 5 ,
54*ae771770SStanislav Sedov.Fl Fl krb5
55b528cefcSMark Murray.Xc
56b528cefcSMark Murrayuse Kerberos 5 (if compiled with support for Kerberos 5)
57b528cefcSMark Murray.It Xo
588373020dSJacques Vidrine.Fl f ,
59*ae771770SStanislav Sedov.Fl Fl fork
60b528cefcSMark Murray.Xc
61b528cefcSMark Murrayfork before starting to delete messages
62b528cefcSMark Murray.It Xo
638373020dSJacques Vidrine.Fl l ,
64*ae771770SStanislav Sedov.Fl Fl leave
65b528cefcSMark Murray.Xc
66b528cefcSMark Murraydon't delete fetched mail
67b528cefcSMark Murray.It Xo
68*ae771770SStanislav Sedov.Fl Fl from
69b528cefcSMark Murray.Xc
70b528cefcSMark Murraybehave like from.
71b528cefcSMark Murray.It Xo
728373020dSJacques Vidrine.Fl c ,
73*ae771770SStanislav Sedov.Fl Fl count
74b528cefcSMark Murray.Xc
75b528cefcSMark Murrayfirst print how many messages and bytes there are.
76b528cefcSMark Murray.It Xo
77*ae771770SStanislav Sedov.Fl Fl headers Ns = Ns Ar headers
78b528cefcSMark Murray.Xc
795e9cd1aeSAssar Westerlunda list of comma-separated headers that should get printed.
80b528cefcSMark Murray.It Xo
818373020dSJacques Vidrine.Fl p Ar port-spec ,
82*ae771770SStanislav Sedov.Fl Fl port Ns = Ns Ar port-spec
83b528cefcSMark Murray.Xc
84b528cefcSMark Murrayuse this port instead of the default
85b528cefcSMark Murray.Ql kpop
86b528cefcSMark Murrayor
87b528cefcSMark Murray.Ql 1109 .
88b528cefcSMark Murray.El
895e9cd1aeSAssar Westerlund.Pp
90b528cefcSMark MurrayThe default is to first try Kerberos 5 authentication and then, if
91b528cefcSMark Murraythat fails, Kerberos 4.
92b528cefcSMark Murray.Sh ENVIRONMENT
93b528cefcSMark Murray.Bl -tag -width Ds
94b528cefcSMark Murray.It Ev MAILHOST
95b528cefcSMark Murraypoints to the post office, if no other hostname is specified.
96b528cefcSMark Murray.El
97b528cefcSMark Murray.\".Sh FILES
98b528cefcSMark Murray.Sh EXAMPLES
99b528cefcSMark Murray.Bd -literal -offset indent
100adb0ddaeSAssar Westerlund$ push cornfield:roosta ~/.emacs-mail-crash-box
101b528cefcSMark Murray.Ed
1025e9cd1aeSAssar Westerlund.Pp
103b528cefcSMark Murraytries to fetch mail for the user
104b528cefcSMark Murray.Ar roosta
105b528cefcSMark Murrayfrom the post office at
106b528cefcSMark Murray.Dq cornfield ,
107b528cefcSMark Murrayand stores the mail in
108adb0ddaeSAssar Westerlund.Pa ~/.emacs-mail-crash-box
109b528cefcSMark Murray(you are using Gnus, aren't you?)
110b528cefcSMark Murray.Bd -literal -offset indent
111b528cefcSMark Murray$ push --from -5 havregryn
112b528cefcSMark Murray.Ed
1135e9cd1aeSAssar Westerlund.Pp
114b528cefcSMark Murraytries to fetch
11545524cd7SAssar Westerlund.Sy From:
116b528cefcSMark Murraylines for current user at post office
117b528cefcSMark Murray.Dq havregryn
118b528cefcSMark Murrayusing Kerberos 5.
119b528cefcSMark Murray.\".Sh DIAGNOSTICS
120b528cefcSMark Murray.Sh SEE ALSO
1215e9cd1aeSAssar Westerlund.Xr from 1 ,
1224137ff4cSJacques Vidrine.Xr pfrom 1 ,
1234137ff4cSJacques Vidrine.Xr movemail 8 ,
1244137ff4cSJacques Vidrine.Xr popper 8
125b528cefcSMark Murray.\".Sh STANDARDS
126b528cefcSMark Murray.Sh HISTORY
127b528cefcSMark Murray.Nm
128b528cefcSMark Murraywas written while waiting for
129b528cefcSMark Murray.Nm movemail
130b528cefcSMark Murrayto finish getting the mail.
131b528cefcSMark Murray.\".Sh AUTHORS
132b528cefcSMark Murray.\".Sh BUGS
133