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