Mailutils wicket

From Mailutils
Revision as of 11:01, 11 July 2015 by Gray (talk | contribs) (Created page with "The <tt>mailutils wicket</tt> command looks up matching URLs in the Mailutils ticket file (by default, <tt>~/.mu-tick...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

The mailutils wicket command looks up matching URLs in the Mailutils ticket file (by default, ~/.mu-tickets) and prints them. The URLs to look for are supplied in the command line.

Consider the following ticket file as an example:

smtp://foo:bar@* smtp://bar:baz@gnu.org *://baz:qux@* *://quux:bar@gnu.org

Now, running mailutils wicket smtp://bar@gnu.org will show:

smtp://bar@gnu.org: /home/user/.mu-tickets:2

which means that this URL matches the line 2 in your .mu-tickets file. The wicket command does not show the actual matching line to avoid revealing eventual security-sensitive information. You can instruct it to do so using the --verbose (-v) option:

 $ mailutils wicket -v smtp://bar@gnu.org
 smtp://bar@gnu.org: /home/user/.mu-tickets:2: smtp://bar:***@gnu.org

As you see, even in that case the tool hides the actual password part by replacing it with three asteriscs. If you are working in a secure environment, you can tell mailutils wicket to show passwords as well, by giving the -v option twice.

A counterpart of --verbose is the --quite (-q) option, which instructs wicket to suppress any output, excepting error messages. This can be used in scripts, which analyze the mailutils exit code to alter the control flow.

The mailutils wicket tool exits with code 0 if all URLs were matched and with code 1 if some of them were not matched in the ticket file. If an error occurred, the code 2 is returned.

See also