diff options
Diffstat (limited to '')
| -rw-r--r-- | imbox.1 | 90 |
1 files changed, 90 insertions, 0 deletions
diff --git a/imbox.1 b/imbox.1 new file mode 100644 index 0000000..791c996 --- /dev/null +++ b/imbox.1 @@ -0,0 +1,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 |