.Dd May 31, 1998 .Dt PUSH 8 .Os HEIMDAL .Sh NAME .Nm push .Nd fetch mail via POP .Sh SYNOPSIS .Nm .Op Fl 4 | Fl -krb4 .Op Fl 5 | Fl -krb5 .Op Fl v | Fl -verbose .Op Fl f | Fl -fork .Op Fl l | -leave .Op Fl -from .Op Fl c | -count .Op Fl -headers Ns = Ns Ar headers .Oo Fl p Ar port-spec \*(Ba Xo .Fl -port Ns = Ns Ar port-spec .Xc .Oc .Ar po-box
a filename .Sh DESCRIPTION .Nm retrieves mail from the post office box .Ar po-box , and stores the mail in mbox format in
a filename . The .Ar po-box can have any of the following formats: l -hang -compact -offset indent t Ql hostname:username t Ql po:hostname:username t Ql username@hostname t Ql po:username@hostname t Ql hostname t Ql po:username .El
p If no username is specified, .Nm assumes that it's the same as on the local machine; .Ar hostname defaults to the value of the .Ev MAILHOST environment variable.
p Supported options: l -tag -width Ds t Xo .Fl 4 , .Fl -krb4 .Xc use Kerberos 4 (if compiled with support for Kerberos 4) t Xo .Fl 5 , .Fl -krb5 .Xc use Kerberos 5 (if compiled with support for Kerberos 5) t Xo .Fl f , .Fl -fork .Xc fork before starting to delete messages t Xo .Fl l , .Fl -leave .Xc don't delete fetched mail t Xo .Fl -from .Xc behave like from. t Xo .Fl c , .Fl -count .Xc first print how many messages and bytes there are. t Xo .Fl -headers Ns = Ns Ar headers .Xc a list of comma-separated headers that should get printed. t Xo .Fl p Ar port-spec , .Fl -port Ns = Ns Ar port-spec .Xc use this port instead of the default .Ql kpop or .Ql 1109 . .El
p
The default is to first try Kerberos 5 authentication and then, if
that fails, Kerberos 4.
.Sh ENVIRONMENT
l -tag -width Ds t Ev MAILHOST points to the post office, if no other hostname is specified.
.El
.Sh FILES
.Sh EXAMPLES
d -literal -offset indent $ push cornfield:roosta ~/.emacs-mail-crash-box
.Ed
p tries to fetch mail for the user .Ar roosta from the post office at .Dq cornfield , and stores the mail in
a ~/.emacs-mail-crash-box (you are using Gnus, aren't you?) d -literal -offset indent $ push --from -5 havregryn .Ed
p
tries to fetch
.Sy From:
lines for current user at post office
.Dq havregryn
using Kerberos 5.
.Sh DIAGNOSTICS
.Sh SEE ALSO
.Xr from 1 ,
.Xr pfrom 1 ,
.Xr movemail 8 ,
.Xr popper 8
.Sh STANDARDS
.Sh HISTORY
.Nm
was written while waiting for
.Nm movemail
to finish getting the mail.
.Sh AUTHORS
.Sh BUGS