/usr/share/doc/monotone/html/Global-Options.html is in monotone-doc 1.0-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <html lang="en">
<head>
<title>Global Options - monotone documentation</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="monotone documentation">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Global-and-Common-Options.html#Global-and-Common-Options" title="Global and Common Options">
<link rel="prev" href="Global-and-Common-Options.html#Global-and-Common-Options" title="Global and Common Options">
<link rel="next" href="Common-Options.html#Common-Options" title="Common Options">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
<link rel="stylesheet" type="text/css" href="texinfo.css">
</head>
<body>
<div class="node">
<a name="Global-Options"></a>
<p>
Next: <a rel="next" accesskey="n" href="Common-Options.html#Common-Options">Common Options</a>,
Previous: <a rel="previous" accesskey="p" href="Global-and-Common-Options.html#Global-and-Common-Options">Global and Common Options</a>,
Up: <a rel="up" accesskey="u" href="Global-and-Common-Options.html#Global-and-Common-Options">Global and Common Options</a>
<hr>
</div>
<h4 class="subsection">4.1.1 Global Options</h4>
<p>These options are available on all commands.
<dl>
<a name="g_t_002d_002dconfdir"></a><dt><samp><span class="command">--confdir <arg></span></samp><a name="index-g_t_002d_002dconfdir-_003carg_003e-1"></a><dd>Set the location of the configuration directory (default
<samp><span class="file">$HOME/.monotone</span></samp> on Unix and Cygwin, <samp><span class="file">%APPDATA%\monotone%</span></samp> on
Windows MinGW). In this manual, references to these specific directories are
actually references to the directory specified by
<samp><span class="option">--confdir</span></samp>.
<p>The configuration directory is where monotone finds:
<dl>
<dt><code>keys</code><dd>in <samp><span class="file">confdir/keys</span></samp>; see <a href="Certificates.html#Certificates">Certificates</a>, <a href="Generating-Keys.html#Generating-Keys">Generating Keys</a>. The location of the keys directory can be overridden separately
with the <samp><span class="option">--keydir</span></samp> option.
<br><dt><code>monotonerc</code><dd>which is a per-user configuration file containing Lua code
(see <a href="rcfiles.html#rcfiles">rcfiles</a>) that is run each time monotone starts up.
<br><dt><code>default database</code><dd>In file <samp><span class="file">confdir/databases/default.mtn</span></samp>; see <a href="Managed-Databases.html#Managed-Databases">Managed Databases</a>.
</dl>
<p>In addition, monotone may write a dump file to the configuration
directory when it fails (if it can't write to <samp><span class="file">_MTN</span></samp> in a
workspace).
<br><dt><samp><span class="command">--date-format <arg></span></samp><a name="index-g_t_002d_002ddate_002dformat-_003carg_003e-2"></a><dd><code>strftime(3)</code> format specification for printing dates. The
default format is given by the <code><a href="get_005fdate_005fformat_005fspec.html#get_005fdate_005fformat_005fspec">get_date_format_spec</a></code> hook;
the default hook returns <code>%x</code> for dates, <code>%X</code> for times,
<code>%x %X</code> for both.
<br><dt><samp><span class="command">--db <arg></span></samp><a name="index-g_t_002d_002ddb-_003carg_003e-3"></a><dd>Set the database to use; defaults to the database specified in the
current workspace (stored in <samp><span class="file">_MTN/options</span></samp>; see <a href="Storage-and-workflow.html#Storage-and-workflow">Storage and workflow</a>), or to nothing if not in a workspace. However, some
commands default to a <a href="Managed-Databases.html#Managed-Databases">Managed Databases</a>; that is specified in
those commands.
<p>An argument of <code>:memory:</code> specifies a memory-only database; any
changes are not saved to a file. One use for this is on the client
side of a remote automate connection to the server, if you are
executing commands that don't actually need a local database but the
automate command requires one.
<br><dt><samp><span class="command">--dump <arg></span></samp><a name="index-g_t_002d_002ddump-_003carg_003e-4"></a><dd>File to dump debugging log to, on failure; default
<samp><span class="file">confdir/dump</span></samp> if not in a workspace, <samp><span class="file">_MTN/debug</span></samp> if in a
workspace.
<br><dt><samp><span class="command">--help</span></samp><a name="index-g_t_002d_002dhelp-5"></a><dd>Display help information. This is the same as the <samp><span class="command">mtn help</span></samp>
command, but note that it can be placed at the end of a command line,
while <samp><span class="command">mtn help</span></samp> must be the first non-option on the command line.
<br><dt><samp><span class="command">--ignore-suspend-certs</span></samp><a name="index-g_t_002d_002dignore_002dsuspend_002dcerts-6"></a><dt><samp><span class="command">--no-ignore-suspend-certs</span></samp><a name="index-g_t_002d_002dno_002dignore_002dsuspend_002dcerts-7"></a><dd>Do not ignore revisions marked as suspended; see the <samp><span class="command">mtn
suspend</span></samp> command.
<p><a name="g_t_002d_002dkey"></a><br><dt><samp><span class="command">--key <arg></span></samp><a name="index-g_t_002d_002dkey-_003carg_003e-8"></a><dt><samp><span class="command">--use-default-key</span></samp><a name="index-g_t_002d_002duse_002ddefault_002dkey-9"></a><dd>Set the key for signatures or network authentication, using either the
key name or the key hash (see <a href="Generating-Keys.html#Generating-Keys">Generating Keys</a>).
<p>monotone determines the key to use as follows:
<ol type=1 start=1>
<li>If <samp><span class="option">--key</span></samp> is given, that is the key.
<li>If <var>key</var> is given in <samp><span class="file">_MTN/options</span></samp>, that is the key.
<p>Each time <samp><span class="option">--key</span></samp> is given, it will be stored in
<samp><span class="file">_MTN/options</span></samp> for future use.
<li>For a non-netsync command, the Lua hook <code><a href="get_005fbranch_005fkey.html#get_005fbranch_005fkey">get_branch_key</a></code> is
called.
<p>For a client-side netsync command, the Lua hook
<code><a href="get_005fnetsync_005fclient_005fkey.html#get_005fnetsync_005fclient_005fkey">get_netsync_client_key</a></code> is called.
<p>For a command that starts a monotone server, the Lua hook
<code><a href="get_005fnetsync_005fserver_005fkey.html#get_005fnetsync_005fserver_005fkey">get_netsync_server_key</a></code> is used.
<p>If any of the aforementioned hooks returns non-nil, the return value
is the name of the key.
<li>If there is only one key in the keydir, that is the key.
<li>Otherwise there is no key; an error occurs.
</ol>
<br><dt><samp><span class="command">--keydir <arg></span></samp><a name="index-g_t_002d_002dkeydir-_003carg_003e-10"></a><dd>Set the key directory (where the “key store” is located); default is
<samp><span class="file">confir/keys</span></samp>.
<br><dt><samp><span class="command">--log <arg></span></samp><a name="index-g_t_002d_002dlog-_003carg_003e-11"></a><dd>Specifiy a file to which the log (consisting of all debug,
informational, and warning messages) is written; default is the
<code>stderr</code> process output.
<br><dt><samp><span class="command">--no-builtin-rcfile</span></samp><a name="index-g_t_002d_002dno_002dbuiltin_002drcfile-12"></a><dt><samp><span class="command">--builtin-rcfile</span></samp><a name="index-g_t_002d_002dbuiltin_002drcfile-13"></a><dd>Do not load the built-in rcfile with the default hooks. This means
all hooks will have null definitions (unless overridden by other
<a href="rcfiles.html#rcfiles">rcfiles</a>).
<br><dt><samp><span class="command">--no-default-confdir</span></samp><a name="index-g_t_002d_002dno_002ddefault_002dconfdir-14"></a><dt><samp><span class="command">--allow-default-confdir</span></samp><a name="index-g_t_002d_002dallow_002ddefault_002dconfdir-15"></a><dd>Don't use a default confdir; <samp><span class="option">--confdir</span></samp> must be specified if
a configuration file is needed.
<br><dt><samp><span class="command">--no-format-dates</span></samp><a name="index-g_t_002d_002dno_002dformat_002ddates-16"></a><dd>Don't use the format provided by a previous <samp><span class="option">--date-format</span></samp>,
nor the format returned by <code><a href="get_005fdate_005fformat_005fspec.html#get_005fdate_005fformat_005fspec">get_date_format_spec</a></code>; instead,
print dates in the format “yyyy-mm-ddThh:mm:ss”.
<br><dt><samp><span class="command">--[no-]standard-rcfiles</span></samp><a name="index-g_t_002d_002d_005bno_002d_005dstandard_002drcfiles-17"></a><dd>Do not load the standard rcfiles, which are
<samp><span class="file">$HOME/.monotone/monotonerc</span></samp> on Unix or
<samp><span class="file">%APPDATA%\monotone\monotonerc</span></samp> on Windows, and
<samp><span class="file">_MTN/monotonerc</span></samp> in the current workspace. See <a href="rcfiles.html#rcfiles">rcfiles</a>.
<br><dt><samp><span class="command">--no-workspace</span></samp><a name="index-g_t_002d_002dno_002dworkspace-18"></a><dt><samp><span class="command">--allow-workspace</span></samp><a name="index-g_t_002d_002dallow_002dworkspace-19"></a><dd>Don't look for a workspace; this means options that normally get their
default values from the workspace will not have those default values.
<br><dt><samp><span class="command">--non-interactive</span></samp><a name="index-g_t_002d_002dnon_002dinteractive-20"></a><dt><samp><span class="command">--interactive</span></samp><a name="index-g_t_002d_002dinteractive-21"></a><dd>Do not prompt the user for input; fail instead. For example, don't
prompt for a key passphrase, or when doing a merge, do not start the
external merger to resolve a conflict.
<br><dt><samp><span class="command">--quiet</span></samp><a name="index-g_t_002d_002dquiet-22"></a><dt><samp><span class="command">--verbose</span></samp><a name="index-g_t_002d_002dverbose-23"></a><dd>Decrease or increase verbosity. There are four levels of verbosity;
debug, information, warning, and none. The default is information.
<br><dt><samp><span class="command">--rcfile <arg></span></samp><a name="index-g_t_002d_002drcfile-_003carg_003e-24"></a><dd>Specify an extra rcfile to load. See <a href="rcfiles.html#rcfiles">rcfiles</a>.
<br><dt><samp><span class="command">--clear-rcfiles</span></samp><a name="index-g_t_002d_002dclear_002drcfiles-25"></a><dd>Cancel all previous <samp><span class="option">--rcfile</span></samp> options (standard rcfiles are
still loaded). See <a href="rcfiles.html#rcfiles">rcfiles</a>.
<dt><samp><span class="command">--root <arg></span></samp><a name="index-g_t_002d_002droot-_003carg_003e-26"></a><dd>Limit the search for a workspace to the specified root directory
<br><dt><samp><span class="command">--ssh-sign <arg></span></samp><a name="index-g_t_002d_002dssh_002dsign-_003carg_003e-27"></a><dd>Controls use of ssh-agent. Valid arguments are: 'yes' to use ssh-agent
to make signatures if possible, 'no' to force use of monotone's
internal code, 'only' to force use of ssh-agent, 'check' to sign with
both and compare.
<br><dt><samp><span class="command">--ticker <arg></span></samp><a name="index-g_t_002d_002dticker-_003carg_003e-28"></a><dd>Set ticker style; one of 'count', 'dot', or 'none'
<br><dt><samp><span class="command">--timestamps</span></samp><a name="index-g_t_002d_002dtimestamps-29"></a><dd>Show timestamps in front of error, warning, and progress messages.
<br><dt><samp><span class="command">--version</span></samp><a name="index-g_t_002d_002dversion-30"></a><dd>Print version number, then exit; same as <samp><span class="command">mtn version</span></samp>.
<br><dt><samp><span class="command">--xargs <arg></span></samp><a name="index-g_t_002d_002dxargs-_003carg_003e-31"></a><dt><samp><span class="command">-@ <arg></span></samp><a name="index-g_t_002d_0040_0040-_003carg_003e-32"></a><dd>Insert command line arguments taken from the given file.
</dl>
</body></html>
|