crypto/dist/heimdal/appl/push/push.8

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