about summary refs log tree commit diff
path: root/imbox.1
blob: 791c996897be309c08d6f21328107e27a6a775e4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
.Dd December 20, 2019
.Dt IMBOX 1
.Os
.
.Sh NAME
.Nm imbox
.Nd IMAP to mboxrd
.
.Sh SYNOPSIS
.Nm
.Op Fl vw
.Op Fl h Ar host
.Op Fl m Ar mailbox
.Op Fl p Ar port
.Op Fl s Ar search
.Ar user
.
.Sh DESCRIPTION
The
.Nm
utility exports messages from an IMAP mailbox
to the mboxrd format on standard output.
IMAP login is performed as
.Ar user
with a password read from
.Pa /dev/tty ,
or standard input if
.Fl w
is used.
.
.Pp
The arguments are as follows:
.Bl -tag -width Ds
.It Fl h Ar host
Connect to
.Ar host .
The default host is
.Li imap.fastmail.com .
TLS without STARTTLS is assumed.
.
.It Fl m Ar mailbox
Export messages from
.Ar mailbox .
The default mailbox is INBOX.
.
.It Fl p Ar port
Connect to
.Ar port .
The default port is 993.
.
.It Fl s Ar search
Export messages matching
.Ar search .
The default search is
.Ql SUBJECT \(dq[PATCH\(dq .
.
.It Fl v
Log IMAP protocol to standard error.
.
.It Fl w
Read the IMAP password from standard input.
.El
.
.Sh EXAMPLES
.Bd -literal
imbox june@causal.agency | git am
.Ed
.
.Sh STANDARDS
.Bl -item
.It
.Rs
.%A M. Crispin
.%Q University of Washington
.%T INTERNET MESSAGE ACCESS PROTOCOL - VERSION 4rev1
.%I IETF
.%N RFC 3501
.%D March 2003
.%U https://tools.ietf.org/html/rfc3501
.Re
.It
.Rs
.%A E. Hall
.%T The application/mbox Media Type
.%I IETF
.%N RFC 4155
.%D September 2005
.%U https://tools.ietf.org/html/rfc4155
.Re
.El