2020-01-19 20:38:05 +01:00
|
|
|
.TH MU-SERVER 1 "January 2020" "User Manuals"
|
2011-09-03 09:41:24 +02:00
|
|
|
|
|
|
|
.SH NAME
|
|
|
|
|
2012-04-15 13:51:55 +02:00
|
|
|
mu server \- the mu backend for the mu4e e-mail client
|
2011-09-03 09:41:24 +02:00
|
|
|
|
2012-07-19 19:44:49 +02:00
|
|
|
.SH SYNOPSIS
|
|
|
|
|
|
|
|
.B mu server [options]
|
|
|
|
|
2011-12-07 07:51:22 +01:00
|
|
|
.SH DESCRIPTION
|
2011-09-03 09:41:24 +02:00
|
|
|
|
2020-01-19 20:38:05 +01:00
|
|
|
\fBmu server\fR starts a simple shell in which one can query and manipulate the
|
2020-02-12 17:42:56 +01:00
|
|
|
mu database. The output uses s-expressions. \fBmu server\fR is not meant for use
|
2020-01-19 20:38:05 +01:00
|
|
|
by humans, except for debugging purposes. Instead, it is designed specifically
|
|
|
|
for the \fBmu4e\fR e-mail client.
|
2011-12-27 12:16:34 +01:00
|
|
|
|
|
|
|
In this man-page, we document the commands \fBmu server\fR accepts, as well as
|
2020-01-19 20:38:05 +01:00
|
|
|
their responses. In general, the commands sent to the server are s-expressions
|
|
|
|
of the form:
|
2012-04-15 13:51:55 +02:00
|
|
|
|
|
|
|
.nf
|
2020-01-19 20:38:05 +01:00
|
|
|
(<command-name> :param1 value1 :param2 value2)
|
2012-04-15 13:51:55 +02:00
|
|
|
.fi
|
|
|
|
|
2020-01-19 20:38:05 +01:00
|
|
|
For example, to view a certain message, the command would be:
|
2012-04-15 13:51:55 +02:00
|
|
|
|
|
|
|
.nf
|
2020-01-19 20:38:05 +01:00
|
|
|
(view :docid 12345)
|
2012-04-15 13:51:55 +02:00
|
|
|
.fi
|
|
|
|
|
2020-01-19 20:38:05 +01:00
|
|
|
Parameters can be sent in any order; they must be of the correct type though.
|
2020-02-12 17:42:56 +01:00
|
|
|
See \fBlib/utils/mu-sexp-parser.hh\fR and \fBlib/utils/mu-sexp-parser.cc\fR in
|
2020-01-19 20:38:05 +01:00
|
|
|
source-tree for the details.
|
2012-04-15 13:51:55 +02:00
|
|
|
|
2011-09-03 09:41:24 +02:00
|
|
|
|
2011-12-07 07:51:22 +01:00
|
|
|
.SH OUTPUT FORMAT
|
2011-09-03 09:41:24 +02:00
|
|
|
|
2011-12-07 07:51:22 +01:00
|
|
|
\fBmu server\fR accepts a number of commands, and delivers its results in
|
|
|
|
the form:
|
2011-09-03 09:41:24 +02:00
|
|
|
|
2011-12-27 12:16:34 +01:00
|
|
|
.nf
|
2012-04-29 16:37:27 +02:00
|
|
|
\\376<length>\\377<s-expr>
|
2011-12-27 12:16:34 +01:00
|
|
|
.fi
|
2011-09-03 09:41:24 +02:00
|
|
|
|
2012-04-29 16:37:27 +02:00
|
|
|
\\376 (one byte 0xfe), followed by the length of the s-expression expressed as
|
|
|
|
an hexadecimal number, followed by another \\377 (one byte 0xff), followed by
|
|
|
|
the actual s-expression.
|
2011-09-03 09:41:24 +02:00
|
|
|
|
2011-12-27 12:16:34 +01:00
|
|
|
By prefixing the expression with its length, it can be processed more
|
2012-04-29 16:37:27 +02:00
|
|
|
efficiently. The \\376 and \\377 were chosen since they never occur in valid
|
|
|
|
UTF-8 (in which the s-expressions are encoded).
|
2011-09-03 09:41:24 +02:00
|
|
|
|
2020-01-19 20:38:05 +01:00
|
|
|
.sh COMMANDS
|
2011-09-03 09:41:24 +02:00
|
|
|
|
2012-09-23 10:42:35 +02:00
|
|
|
|
2011-12-07 07:51:22 +01:00
|
|
|
.SH AUTHOR
|
2011-09-03 09:41:24 +02:00
|
|
|
Dirk-Jan C. Binnema <djcb@djcbsoftware.nl>
|
|
|
|
|
|
|
|
.SH "SEE ALSO"
|
2018-03-10 21:08:17 +01:00
|
|
|
.BR mu (1)
|