mu-add(1)

1MU ADD(1)                   General Commands Manual                  MU ADD(1)
2
3
4

NAME

6       mu add - add one or more messages to the database
7
8

SYNOPSIS

10       mu [common-options] add [options] <file> [<files>]
11
12

DESCRIPTION

14       mu  add  is  the command to add specific message files to the database.
15       Each file must be specified with an absolute path.
16
17

ADD OPTIONS

19   --muhome
20       use a non-default directory to store and read the database,  write  the
21       logs,  etc.   By  default, mu uses the XDG Base Directory Specification
22       (e.g. on GNU/Linux this defaults to ~/.cache/mu and ~/.config/mu). Ear‐
23       lier   versions   of   mu   defaulted  to  ~/.mu,  which  now  requires
24       --muhome=~/.mu.
25
26
27       The environment variable MUHOME  can  be  used  as  an  alternative  to
28       --muhome. The latter has precedence.
29
30

COMMON OPTIONS

32   -d, --debug
33       makes  mu  generate  extra  debug information, useful for debugging the
34       program itself. By default, debug information goes  to  the  log  file,
35       ~/.cache/mu/mu.log.   It  can safely be deleted when mu is not running.
36       When running with --debug option, the log file can grow rather quickly.
37       See the note on logging below.
38
39
40   -q, --quiet
41       causes mu not to output informational messages and progress information
42       to standard output, but only to the log file. Error messages will still
43       be  sent  to  standard  error.  Note  that mu index is much faster with
44       --quiet, so it is recommended you use this option when  using  mu  from
45       scripts etc.
46
47
48   --log-stderr
49       causes  mu to not output log messages to standard error, in addition to
50       sending them to the log file.
51
52
53   --nocolor
54       do not use ANSI colors. The environment variable NO_COLOR can  be  used
55       as an alternative to --nocolor.
56
57
58   -V, --version
59       prints mu version and copyright information.
60
61
62   -h, --help
63       lists the various command line options.
64
65

EXIT CODE

67       This  command  returns 0 upon successful completion, or a non-zero exit
68       code otherwise. Typical values are 2 (no matches found),  11  (database
69       schema mismatch) and 12 (failed to acquire database lock).
70
71
72   no matches found (2)
73       Nothing matching found; try a different query
74
75
76   database schema mismatch (11)
77       You need to re-initialize mu, see mu-init(1)
78
79
80   failed to acquire lock (19)
81       Some other program has exclusive access to the mu (Xapian) database
82
83

REPORTING BUGS

85       Please report bugs at https://github.com/djcb/mu/issues.
86
87

AUTHOR

89       Dirk-Jan C. Binnema <djcb@djcbsoftware.nl>
90
91

COPYRIGHT

93       This manpage is part of mu 1.10.5.
94
95
96       Copyright © 2022-2023 Dirk-Jan C. Binnema. License GPLv3+: GNU GPL ver‐
97       sion 3 or later https://gnu.org/licenses/gpl.html. This is  free  soft‐
98       ware: you are free to change and redistribute it. There is NO WARRANTY,
99       to the extent permitted by law.
100
101