Initial import from FreeBSD RELENG_4:
[dragonfly.git] / crypto / heimdal / appl / push / push.cat8
1 PUSH(8)                 NetBSD System Manager's Manual                 PUSH(8)
2
3 N\bNA\bAM\bME\bE
4      p\bpu\bus\bsh\bh - fetch mail via POP
5
6 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
7      p\bpu\bus\bsh\bh [-\b-4\b4 | -\b--\b-k\bkr\brb\bb4\b4] [-\b-5\b5 | -\b--\b-k\bkr\brb\bb5\b5] [-\b-v\bv | -\b--\b-v\bve\ber\brb\bbo\bos\bse\be] [-\b-f\bf | -\b--\b-f\bfo\bor\brk\bk] [-\b-l\bl |
8      -\b--\b-l\ble\bea\bav\bve\be] [-\b--\b-f\bfr\bro\bom\bm] [-\b-c\bc | -\b--\b-c\bco\bou\bun\bnt\bt] [-\b--\b-h\bhe\bea\bad\bde\ber\brs\bs=_\bh_\be_\ba_\bd_\be_\br_\bs] [-\b-p\bp _\bp_\bo_\br_\bt_\b-_\bs_\bp_\be_\bc |
9      -\b--\b-p\bpo\bor\brt\bt=_\bp_\bo_\br_\bt_\b-_\bs_\bp_\be_\bc] _\bp_\bo_\b-_\bb_\bo_\bx _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
10
11 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
12      p\bpu\bus\bsh\bh retrieves mail from the post office box _\bp_\bo_\b-_\bb_\bo_\bx, and stores the mail
13      in mbox format in _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be.  The _\bp_\bo_\b-_\bb_\bo_\bx can have any of the following
14      formats:
15            `hostname:username'
16            `po:hostname:username'
17            `username@hostname'
18            `po:username@hostname'
19            `hostname'
20            `po:username'
21
22      If no username is specified, p\bpu\bus\bsh\bh assumes that it's the same as on the
23      local machine; _\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be defaults to the value of the MAILHOST environment
24      variable.
25
26      Supported options:
27
28      -\b-4\b4, -\b--\b-k\bkr\brb\bb4\b4
29              use Kerberos 4 (if compiled with support for Kerberos 4)
30
31      -\b-5\b5, -\b--\b-k\bkr\brb\bb5\b5
32              use Kerberos 5 (if compiled with support for Kerberos 5)
33
34      -\b-f\bf, -\b--\b-f\bfo\bor\brk\bk
35              fork before starting to delete messages
36
37      -\b-l\bl, -\b--\b-l\ble\bea\bav\bve\be
38              don't delete fetched mail
39
40      -\b--\b-f\bfr\bro\bom\bm  behave like from.
41
42      -\b-c\bc, -\b--\b-c\bco\bou\bun\bnt\bt
43              first print how many messages and bytes there are.
44
45      -\b--\b-h\bhe\bea\bad\bde\ber\brs\bs=_\bh_\be_\ba_\bd_\be_\br_\bs
46              a list of comma-separated headers that should get printed.
47
48      -\b-p\bp _\bp_\bo_\br_\bt_\b-_\bs_\bp_\be_\bc, -\b--\b-p\bpo\bor\brt\bt=_\bp_\bo_\br_\bt_\b-_\bs_\bp_\be_\bc
49              use this port instead of the default `kpop' or `1109'.
50
51      The default is to first try Kerberos 5 authentication and then, if that
52      fails, Kerberos 4.
53
54 E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
55      MAILHOST
56              points to the post office, if no other hostname is specified.
57
58 E\bEX\bXA\bAM\bMP\bPL\bLE\bES\bS
59            $ push cornfield:roosta ~/.emacs-mail-crash-box
60
61      tries to fetch mail for the user _\br_\bo_\bo_\bs_\bt_\ba from the post office at
62      ``cornfield'', and stores the mail in _\b~_\b/_\b._\be_\bm_\ba_\bc_\bs_\b-_\bm_\ba_\bi_\bl_\b-_\bc_\br_\ba_\bs_\bh_\b-_\bb_\bo_\bx (you are
63      using Gnus, aren't you?)
64
65            $ push --from -5 havregryn
66
67      tries to fetch F\bFr\bro\bom\bm:\b: lines for current user at post office ``havregryn''
68      using Kerberos 5.
69
70 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
71      from(1), pfrom(1), movemail(8), popper(8)
72
73 H\bHI\bIS\bST\bTO\bOR\bRY\bY
74      p\bpu\bus\bsh\bh was written while waiting for m\bmo\bov\bve\bem\bma\bai\bil\bl to finish getting the mail.
75
76  HEIMDAL                         May 31, 1998                                2