about summary refs log tree commit diff
path: root/man/mblaze.7
blob: 20cbadf0625f379c2cd23a006e4bf437f78743f1 (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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
.Dd January 18, 2020
.Dt MBLAZE 7
.Os
.Sh NAME
.Nm mblaze
.Nd introduction to the mblaze message system
.Sh DESCRIPTION
The
.Nm
message system is a set of Unix utilities for processing and
interacting with mail messages which are stored in maildir folders.
.Pp
Its design is roughly inspired by MH, the RAND Message Handling
System, but it is a complete implementation from scratch.
.Pp
.Nm
consists of these Unix utilities that each do one job:
.Pp
.Bl -tag -width 11n -compact
.It Xr maddr 1
extract mail addresses from messages
.It Xr magrep 1
search messages matching a pattern
.It Xr mbnc 1
bounce messages
.It Xr mcom 1
compose and send messages
.It Xr mdeliver 1
deliver messages or import mbox file
.It Xr mdirs 1
list maildir folders, recursively
.It Xr mexport 1
export messages as mbox file
.It Xr mflag 1
manipulate maildir message flags
.It Xr mflow 1
reflow format=flowed plain text messages
.It Xr mfwd 1
forward messages
.It Xr mgenmid 1
generate a Message-ID
.It Xr mhdr 1
print message headers
.It Xr minc 1
incorporate new messages
.It Xr mless 1
conveniently read messages in
.Xr less 1
.It Xr mlist 1
list and filter messages
.It Xr mmime 1
create MIME messages
.It Xr mmkdir 1
create new maildir folders
.It Xr mpick 1
advanced message filter
.It Xr mrefile 1
move or copy messages between maildir folders
.It Xr mrep 1
reply to messages
.It Xr mscan 1
generate one-line message summaries
.It Xr msed 1
manipulate message headers
.It Xr mseq 1
manipulate message sequences
.It Xr mshow 1
render messages and extract MIME parts
.It Xr msort 1
sort messages
.It Xr mthread 1
arrange messages into discussions
.El
.Pp
.Nm
is a classic command line MUA and has no features
for receiving or transferring messages;
you can operate on messages in a local maildir spool,
or fetch your messages using
.Xr fdm 1 ,
.Xr getmail 1 ,
.Xr offlineimap 1 ,
or similar utilities,
and send it using
.Xr dma 8 ,
.Xr msmtp 1 ,
.Xr sendmail 8 ,
as provided by
OpenSMTPD,
Postfix,
or similar.
.Pp
.Nm
operates directly on maildir folders and doesn't
use its own caches or databases.
There is no setup needed for many uses.
All utilities have been written with performance in mind.
Enumeration of all messages in a maildir is avoided unless necessary,
and then optimized to limit syscalls.
Parsing message metadata is optimized to limit I/O requests.
Initial operations on a large maildir may feel slow, but as soon as they
are in the file system cache, everything is blazingly fast.
The utilities are written to be memory efficient
.Pq i.e. not wasteful ,
but whole messages are assumed to fit into RAM easily
.Pq one at a time .
.Pp
.Nm
has been written from scratch and is now well tested,
but it is not 100% RFC-conforming
.Pq which is neither worth it, nor desirable .
There may be issues with very old, nonconforming, messages.
.Pp
.Nm
is written in portable C, using only POSIX functions
.Pq apart from a tiny Linux-only optimization ,
and has no external dependencies.
It supports MIME and more than 7-bit messages
.Po
everything the host
.Xr iconv 3
can decode
.Pc .
It assumes you work in a UTF-8 environment.
.Nm
works well with other Unix utilities such as
.Xr mairix 1 ,
.Xr mu 1 ,
or
.Xr offlineimap 1 .
.Sh EXAMPLES
.Nm
utilities are designed to be composed together in a pipe.
They are suitable for interactive use and for scripting,
and integrate well into a Unix workflow.
.Pp
For example, you could decide you want to look at all unseen messages in your
INBOX, oldest first.
.Dl mlist -s ~/Maildir/INBOX | msort -d | mscan
.Pp
To operate on a set of messages in multiple steps,
you can save it as a sequence,
e.g. add a call to
.Ql mseq -S
to the above command:
.Dl mlist -s ~/Maildir/INBOX | msort -d | mseq -S | mscan
.Pp
Now mscan will show message numbers and you could look at the first
five messages at once, for example:
.Dl mshow 1:5
.Pp
Likewise, you could decide to incorporate
.Po
by moving from
.Pa new
to
.Pa cur
.Pc
all new messages in all folders,
thread it and look at it interactively:
.Dl mdirs ~/Maildir | xargs minc | mthread | mless
.Pp
Or you could list the attachments of the 20 largest messages in your INBOX:
.Dl mlist ~/Maildir/INBOX | msort -S | tail -20 | mshow -t
.Pp
Or apply the patches from the current message:
.Dl mshow -O . '*.diff' | patch
.Pp
As usual with pipes, the sky is the limit.
.Sh CONCEPTS
.Nm
deals with messages
.Pq which are files ,
folders
.Pq which are maildir folders ,
sequences
.Po
which are newline-separated lists of messages, possibly saved on disk in
.Pa ${MBLAZE:-$HOME/.mblaze}/seq
.Pc ,
and the current message
.Po
kept as a symlink in
.Pa ${MBLAZE:-$HOME/.mblaze}/cur
.Pc .
.Pp
Messages in the saved sequence can be referred to using special
syntax as explained in
.Xr mmsg 7 .
.Pp
Many utilities have a default behavior when used interactively from a terminal
.Pq e.g. operate on the current message or the current sequence .
For scripting, you must make these arguments explicit.
.Pp
For configuration, see
.Xr mblaze-profile 5 .
.Sh SEE ALSO
.Xr mailx 1 ,
.Xr mblaze-profile 5 ,
.Xr nmh 7
.Sh AUTHORS
.An Leah Neukirchen Aq Mt leah@vuxu.org
.Pp
There is a mailing list available at
.Mt mblaze@googlegroups.com
.Po
to subscribe, send a message to
.Mt mblaze+subscribe@googlegroups.com
.Pc ;
archives are available at
.Lk https://inbox.vuxu.org/mblaze/ .
There also is an IRC channel
.Li #vuxu
on irc.freenode.net.
Please report security-related bugs directly to the author.
.Sh LICENSE
.Nm
is in the public domain.
.Pp
To the extent possible under law,
the creator of this work
has waived all copyright and related or
neighboring rights to this work.
.Pp
.Lk http://creativecommons.org/publicdomain/zero/1.0/