1.\" $Id: push.8,v 1.4 1999/12/05 13:00:56 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 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 19.Op Fl -header 20.Oo Fl p Ar port-spec \*(Ba Xo 21.Fl -port= Ns Ar port-spec Oc 22.Xc 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 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 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 83.Fl -header 84.Xc 85which header from should print. 86.It Xo 87.Fl p Ar port-spec Ns , 88.Fl -port= Ns Ar port-spec 89.Xc 90use this port instead of the default 91.Ql kpop 92or 93.Ql 1109 . 94.El 95 96The default is to first try Kerberos 5 authentication and then, if 97that fails, Kerberos 4. 98.Sh ENVIRONMENT 99 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 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 121tries to fetch 122.Nm 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.\".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 139