1.\" $Id: push.8,v 1.8 2001/01/11 16:16:28 assar Exp $
2.\"
3.Dd May 31, 1998
4.Dt PUSH 8
5.Os HEIMDAL
6.Sh NAME
7.Nm push
| 1.\" $Id: push.8,v 1.8 2001/01/11 16:16:28 assar Exp $
2.\"
3.Dd May 31, 1998
4.Dt PUSH 8
5.Os HEIMDAL
6.Sh NAME
7.Nm push
|
8.Nd
9fetch mail via POP
| 8.Nd fetch mail via POP
|
10.Sh SYNOPSIS
11.Nm
12.Op Fl 4 | Fl -krb4
13.Op Fl 5 | Fl -krb5
14.Op Fl v | Fl -verbose
15.Op Fl f | Fl -fork
16.Op Fl l | -leave
17.Op Fl -from
18.Op Fl c | -count
| 9.Sh SYNOPSIS
10.Nm
11.Op Fl 4 | Fl -krb4
12.Op Fl 5 | Fl -krb5
13.Op Fl v | Fl -verbose
14.Op Fl f | Fl -fork
15.Op Fl l | -leave
16.Op Fl -from
17.Op Fl c | -count
|
19.Op Fl -headers= Ns Ar headers
| 18.Op Fl -headers Ns = Ns Ar headers
|
20.Oo Fl p Ar port-spec \*(Ba Xo
| 19.Oo Fl p Ar port-spec \*(Ba Xo
|
21.Fl -port= Ns Ar port-spec
| 20.Fl -port Ns = Ns Ar port-spec
|
22.Xc
23.Oc
24.Ar po-box
25.Pa filename
26.Sh DESCRIPTION
27.Nm
28retrieves mail from the post office box
29.Ar po-box ,
30and stores the mail in mbox format in
31.Pa filename .
32The
33.Ar po-box
34can have any of the following formats:
35.Bl -hang -compact -offset indent
36.It Ql hostname:username
37.It Ql po:hostname:username
38.It Ql username@hostname
39.It Ql po:username@hostname
40.It Ql hostname
41.It Ql po:username
42.El
43.Pp
44If no username is specified,
45.Nm
46assumes that it's the same as on the local machine;
47.Ar hostname
48defaults to the value of the
49.Ev MAILHOST
50environment variable.
51.Pp
52Supported options:
53.Bl -tag -width Ds
54.It Xo
55.Fl 4 Ns ,
56.Fl -krb4
57.Xc
58use Kerberos 4 (if compiled with support for Kerberos 4)
59.It Xo
60.Fl 5 Ns ,
61.Fl -krb5
62.Xc
63use Kerberos 5 (if compiled with support for Kerberos 5)
64.It Xo
65.Fl f Ns ,
66.Fl -fork
67.Xc
68fork before starting to delete messages
69.It Xo
70.Fl l Ns ,
71.Fl -leave
72.Xc
73don't delete fetched mail
74.It Xo
75.Fl -from
76.Xc
77behave like from.
78.It Xo
79.Fl c Ns ,
80.Fl -count
81.Xc
82first print how many messages and bytes there are.
83.It Xo
| 21.Xc
22.Oc
23.Ar po-box
24.Pa filename
25.Sh DESCRIPTION
26.Nm
27retrieves mail from the post office box
28.Ar po-box ,
29and stores the mail in mbox format in
30.Pa filename .
31The
32.Ar po-box
33can have any of the following formats:
34.Bl -hang -compact -offset indent
35.It Ql hostname:username
36.It Ql po:hostname:username
37.It Ql username@hostname
38.It Ql po:username@hostname
39.It Ql hostname
40.It Ql po:username
41.El
42.Pp
43If no username is specified,
44.Nm
45assumes that it's the same as on the local machine;
46.Ar hostname
47defaults to the value of the
48.Ev MAILHOST
49environment variable.
50.Pp
51Supported options:
52.Bl -tag -width Ds
53.It Xo
54.Fl 4 Ns ,
55.Fl -krb4
56.Xc
57use Kerberos 4 (if compiled with support for Kerberos 4)
58.It Xo
59.Fl 5 Ns ,
60.Fl -krb5
61.Xc
62use Kerberos 5 (if compiled with support for Kerberos 5)
63.It Xo
64.Fl f Ns ,
65.Fl -fork
66.Xc
67fork before starting to delete messages
68.It Xo
69.Fl l Ns ,
70.Fl -leave
71.Xc
72don't delete fetched mail
73.It Xo
74.Fl -from
75.Xc
76behave like from.
77.It Xo
78.Fl c Ns ,
79.Fl -count
80.Xc
81first print how many messages and bytes there are.
82.It Xo
|
84.Fl -headers= Ns Ar headers
| 83.Fl -headers Ns = Ns Ar headers
|
85.Xc
86a list of comma-separated headers that should get printed.
87.It Xo
88.Fl p Ar port-spec Ns ,
| 84.Xc
85a list of comma-separated headers that should get printed.
86.It Xo
87.Fl p Ar port-spec Ns ,
|
89.Fl -port= Ns Ar port-spec
| 88.Fl -port Ns = Ns Ar port-spec
|
90.Xc
91use this port instead of the default
92.Ql kpop
93or
94.Ql 1109 .
95.El
96.Pp
97The default is to first try Kerberos 5 authentication and then, if
98that fails, Kerberos 4.
99.Sh ENVIRONMENT
100.Bl -tag -width Ds
101.It Ev MAILHOST
102points to the post office, if no other hostname is specified.
103.El
104.\".Sh FILES
105.Sh EXAMPLES
106.Bd -literal -offset indent
107$ push cornfield:roosta ~/.gnus-crash-box
108.Ed
109.Pp
110tries to fetch mail for the user
111.Ar roosta
112from the post office at
113.Dq cornfield ,
114and stores the mail in
115.Pa ~/.gnus-crash-box
116(you are using Gnus, aren't you?)
117.Bd -literal -offset indent
118$ push --from -5 havregryn
119.Ed
120.Pp
121tries to fetch
| 89.Xc
90use this port instead of the default
91.Ql kpop
92or
93.Ql 1109 .
94.El
95.Pp
96The default is to first try Kerberos 5 authentication and then, if
97that fails, Kerberos 4.
98.Sh ENVIRONMENT
99.Bl -tag -width Ds
100.It Ev MAILHOST
101points to the post office, if no other hostname is specified.
102.El
103.\".Sh FILES
104.Sh EXAMPLES
105.Bd -literal -offset indent
106$ push cornfield:roosta ~/.gnus-crash-box
107.Ed
108.Pp
109tries to fetch mail for the user
110.Ar roosta
111from the post office at
112.Dq cornfield ,
113and stores the mail in
114.Pa ~/.gnus-crash-box
115(you are using Gnus, aren't you?)
116.Bd -literal -offset indent
117$ push --from -5 havregryn
118.Ed
119.Pp
120tries to fetch
|
122.Nm From:
| 121.Sy From:
|
123lines for current user at post office
124.Dq havregryn
125using Kerberos 5.
126.\".Sh DIAGNOSTICS
127.Sh SEE ALSO
128.Xr movemail 8 ,
129.Xr popper 8 ,
130.Xr from 1 ,
131.Xr pfrom 1
132.\".Sh STANDARDS
133.Sh HISTORY
134.Nm
135was written while waiting for
136.Nm movemail
137to finish getting the mail.
138.\".Sh AUTHORS
139.\".Sh BUGS
| 122lines for current user at post office
123.Dq havregryn
124using Kerberos 5.
125.\".Sh DIAGNOSTICS
126.Sh SEE ALSO
127.Xr movemail 8 ,
128.Xr popper 8 ,
129.Xr from 1 ,
130.Xr pfrom 1
131.\".Sh STANDARDS
132.Sh HISTORY
133.Nm
134was written while waiting for
135.Nm movemail
136to finish getting the mail.
137.\".Sh AUTHORS
138.\".Sh BUGS
|