Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
MU MOVE(1)		    General Commands Manual		    MU MOVE(1)

NAME
       mu-move - move a	message	file or	change its flags

SYNOPSIS
       mu [COMMON-OPTIONS] move	[OPTIONS] SRC [--flags=FLAGS] [TARGET]

DESCRIPTION
       mu  move	 is  the  command for moving messages in a Maildir or changing
       their flags.

       For any change, both the	message	file in	the file system	as well	as its
       representation in the database are updated accordingly.

       The source message file and target-maildir must reside under the	 root-
       maildir for mu's	database (see mu info store).

MOVE OPTIONS
   --flags flags
       Specify the new message flags. See FLAGS	for details.

   --change-name
       Change the basename of the message file when moving; this can be	useful
       when  using  some  external tools such as mbsync(1) which otherwise get
       confused

   --update-dups
       Update the flags	of duplicate messages too, where "duplicate  messages"
       are  defined  as	 all message that share	the same message-id. Note that
       the Draft/Flagged/Trashed flags are deliberately	 not  changed  if  you
       change those on the source message.

   -n, --dry-run
       Print the target	filename(s), but don't change anything.

       Note  that  with	the --change-name, the target name is not constant, so
       you cannot use a	dry-run	to predict the exact name when doing a	`real'
       run.

COMMON OPTIONS
   -d, --debug
       Makes  mu  generate  extra  debug information, useful for debugging the
       program itself. Debug information goes to the  standard	logging	 loca-
       tion; see mu(1).

   -q, --quiet
       Causes mu not to	output informational messages and progress information
       to standard output, but only to the log file. Error messages will still
       be  sent	 to  standard  error.  Note  that mu index is much faster with
       --quiet,	so it is recommended you use this option when  using  mu  from
       scripts etc.

   --log-stderr
       Causes  mu to not output	log messages to	standard error,	in addition to
       sending them to the standard logging location.

   --nocolor
       Do not use ANSI colors. The environment variable	NO_COLOR can  be  used
       as an alternative to --nocolor.

   -V, --version
       Prints mu version and copyright information.

   -h, --help
       Lists the various command line options.

FLAGS
       (Note:  if  you	are  not  familiar  with Maildirs, please refer	to the
       maildir(5) man-page, or see http://cr.yp.to/proto/maildir.html)

       The message flags specify the Maildir-metadata for a  message  and  are
       represented  by	uppercase  letters at the end of the message file name
       for all `non-new' messages, i.e.	messages that live in the cur/ sub-di-
       rectory of a Maildir.

		   +-------------------------------------------+
		   | Flag   Meaning			       |
		   +-------------------------------------------+
		   | D	    Draft message		       |
		   | F	    Flagged message		       |
		   | P	    Passed message (i.e., `forwarded') |
		   | R	    Replied message		       |
		   | S	    Seen message		       |
		   | T	    Trashed; to	be deleted later       |
		   +-------------------------------------------+

       New messages (in	the new/ sub-directory)	do not have flags  encoded  in
       their file-name;	but we mu uses `N' in the --flags to represent that:

				 +----------------+
				 | Flag	  Meaning |
				 +----------------+
				 | N	  New	  |
				 +----------------+

       Thus,  changing flags means changing the	letters	at the end of the mes-
       sage file-name, except when setting or removing	the  `N'  (new)	 flag.
       Setting	or  un-setting	the New	flag causes the	message	is to be moved
       from cur/ to new/ or vice-versa,	respectively. When marking  a  message
       as New, it looses the other flags.

ABSOLUTE AND RELATIVE FLAGS
       You  can	 specify  the  flags with the --flags parameter, and do	either
       with either absolute or relative	flags.

       Absolute	flags just specify the new flags by  their  letters;  e.g.  to
       specify	a  Trashed,  Seen,  Replied  message,  you'd  use --flags STR.
       #+end_example

       Relative	flags are relative to the current flags	for some message,  and
       each  of	 the  flags  is	 prefixed with either +	("add this flag") or -
       ("remove	this flag").

       So to add the Seen flag and remove the Draft  flag  from	 whatever  the
       message already has, --flags +S-D.

       You cannot combine relative and relative	flags.

EXAMPLES
   change some flags
	      $	mu move	/home/user/Maildir/inbox/cur/1695559560.a73985881f4611ac2.hostname!2,S --flags +F
	      /home/user/Maildir/inbox/cur/1695559560.a73985881f4611ac2.hostname!2,FS

   move	to a different maildir
	      $	mu move	/home/user/Maildir/project1/cur/1695559560.a73985881f4611ac2.hostname!2,S /project2
	      /home/user/Maildir/project2/cur/1695559560.a73985881f4611ac2.hostname!2,S

REPORTING BUGS
       Please report bugs at https://github.com/djcb/mu/issues.

AUTHOR
       Dirk-Jan	C. Binnema <djcb@djcbsoftware.nl>

COPYRIGHT
       This manpage is part of mu 1.12.15.

       Copyright   2008-2026 Dirk-Jan C. Binnema. License GPLv3+: GNU GPL ver-
       sion 3 or later https://gnu.org/licenses/gpl.html. This is  free	 soft-
       ware: you are free to change and	redistribute it. There is NO WARRANTY,
       to the extent permitted by law.

SEE ALSO
       maildir(5)

								    MU MOVE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mu-move&sektion=1&manpath=FreeBSD+Ports+15.0.quarterly>

home | help