.\" $Id$
.\"
.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
.Oo Fl p Ar port-spec  \*(Ba Xo
.Fl -port= Ns Ar port-spec Oc
.Xc
.Ar hostname Ns Oo : Ns Ar username Oc 
.Pa filename
.Sh DESCRIPTION
.Nm
retrieves mail for
.Ar username
from the post office at 
.Ar hostname ,
and stores the mail in mbox format
.Pa filename .
If no username is specified,
.Nm
assumes that it's the same as on the local machine. If
.Ar hostname
is
.\" Li is parsed, so we need to quote po...
.Ql \&po ,
the hostname is taken from the
.Ev MAILHOST
environment variable.

Supported options:
.Bl -tag -width Ds
.It Xo
.Fl 4 Ns ,
.Fl -krb4
.Xc
use Kerberos 4 (if compiled with support for Kerberos 4)
.It Xo
.Fl 5 Ns ,
.Fl -krb5
.Xc
use Kerberos 5 (if compiled with support for Kerberos 5)
.It Xo
.Fl f Ns ,
.Fl -fork
.Xc
fork before starting to delete messages
.It Xo
.Fl l Ns ,
.Fl -leave
.Xc
don't delete fetched mail
.It Xo
.Fl p Ar port-spec Ns ,
.Fl -port= Ns Ar port-spec
.Xc
use this port instead of the default
.Ql kpop 
or
.Ql 1109 .
.El

The default is to first try Kerberos 5 authentication and then, if
that fails, Kerberos 4.
.Sh ENVIRONMENT

.Bl -tag -width Ds
.It Ev MAILHOST
points to the post office, if the hostname is specified as
.Ql \&po
.El
.\".Sh FILES
.Sh EXAMPLES
.Bd -literal -offset indent
$ push cornfield:roosta ~/.gnus-crash-box
.Ed

tries to fetch mail for the user
.Ar roosta
from the post office at
.Dq cornfield ,
and stores the mail in
.Pa ~/.gnus-crash-box  
(you are using Gnus, aren't you?)
.\".Sh DIAGNOSTICS
.Sh SEE ALSO
.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