/usr/share/doc/monotone/html/Global-Options.html is in monotone-doc 1.1-9.
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 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>monotone documentation: Global Options</title>
<meta name="description" content="monotone documentation: Global Options">
<meta name="keywords" content="monotone documentation: Global Options">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="General-Index.html#General-Index" rel="index" title="General Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Global-and-Common-Options.html#Global-and-Common-Options" rel="up" title="Global and Common Options">
<link href="Common-Options.html#Common-Options" rel="next" title="Common Options">
<link href="Global-and-Common-Options.html#Global-and-Common-Options" rel="prev" title="Global and Common Options">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
<link rel="stylesheet" type="text/css" href="texinfo.css">
</head>
<body lang="en">
<a name="Global-Options"></a>
<div class="header">
<p>
Next: <a href="Common-Options.html#Common-Options" accesskey="n" rel="next">Common Options</a>, Previous: <a href="Global-and-Common-Options.html#Global-and-Common-Options" accesskey="p" rel="prev">Global and Common Options</a>, Up: <a href="Global-and-Common-Options.html#Global-and-Common-Options" accesskey="u" rel="up">Global and Common Options</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="General-Index.html#General-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Global-Options-1"></a>
<h4 class="subsection">4.1.1 Global Options</h4>
<p>These options are available on all commands.
</p>
<dl compact="compact">
<dd><a name="g_t_002d_002dconfdir"></a></dd>
<dt><code>--confdir <arg></code>
<a name="index-_002d_002dconfdir-_003carg_003e"></a>
</dt>
<dd><p>Set the location of the configuration directory (default
<samp>$HOME/.monotone</samp> on Unix and Cygwin, <samp>%APPDATA%\monotone%</samp> on
Windows MinGW). In this manual, references to these specific directories are
actually references to the directory specified by
<samp>--confdir</samp>.
</p>
<p>The configuration directory is where monotone finds:
</p>
<dl compact="compact">
<dt><code>keys</code></dt>
<dd><p>in <samp>confdir/keys</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>--keydir</samp> option.
</p>
</dd>
<dt><code>monotonerc</code></dt>
<dd><p>which is a per-user configuration file containing Lua code
(see <a href="Lua-Reference.html#rcfiles">rcfiles</a>) that is run each time monotone starts up.
</p>
</dd>
<dt><code>default database</code></dt>
<dd><p>In file <samp>confdir/databases/default.mtn</samp>; see <a href="Managed-Databases.html#Managed-Databases">Managed Databases</a>.
</p>
</dd>
</dl>
<p>In addition, monotone may write a dump file to the configuration
directory when it fails (if it can’t write to <samp>_MTN</samp> in a
workspace).
</p>
</dd>
<dt><code>--date-format <arg></code>
<a name="index-_002d_002ddate_002dformat-_003carg_003e"></a>
</dt>
<dd><p><code>strftime(3)</code> format specification for printing dates. The
default format is given by the <code><a href="User-Defaults.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.
</p>
</dd>
<dt><code>--db <arg></code>
<a name="index-_002d_002ddb-_003carg_003e"></a>
</dt>
<dd><p>Set the database to use; defaults to the database specified in the
current workspace (stored in <samp>_MTN/options</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>
<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.
</p>
</dd>
<dt><code>--dump <arg></code>
<a name="index-_002d_002ddump-_003carg_003e"></a>
</dt>
<dd><p>File to dump debugging log to, on failure; default
<samp>confdir/dump</samp> if not in a workspace, <samp>_MTN/debug</samp> if in a
workspace.
</p>
</dd>
<dt><code>--help</code>
<a name="index-_002d_002dhelp"></a>
</dt>
<dd><p>Display help information. This is the same as the <code>mtn help</code>
command, but note that it can be placed at the end of a command line,
while <code>mtn help</code> must be the first non-option on the command line.
</p>
</dd>
<dt><code>--ignore-suspend-certs</code>
<a name="index-_002d_002dignore_002dsuspend_002dcerts"></a>
</dt>
<dt><code>--no-ignore-suspend-certs</code>
<a name="index-_002d_002dno_002dignore_002dsuspend_002dcerts"></a>
</dt>
<dd><p>Do not ignore revisions marked as suspended; see the <code>mtn
suspend</code> command.
</p>
<a name="g_t_002d_002dkey"></a></dd>
<dt><code>--key <arg></code>
<a name="index-_002d_002dkey-_003carg_003e"></a>
</dt>
<dt><code>--use-default-key</code>
<a name="index-_002d_002duse_002ddefault_002dkey"></a>
</dt>
<dd><p>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>
<p>monotone determines the key to use as follows:
</p>
<ol>
<li> If <samp>--key</samp> is given, that is the key.
</li><li> If <var>key</var> is given in <samp>_MTN/options</samp>, that is the key.
<p>Each time <samp>--key</samp> is given, it will be stored in
<samp>_MTN/options</samp> for future use.
</p>
</li><li> For a non-netsync command, the Lua hook <code><a href="User-Defaults.html#get_005fbranch_005fkey">get_branch_key</a></code> is
called.
<p>For a client-side netsync command, the Lua hook
<code><a href="User-Defaults.html#get_005fnetsync_005fclient_005fkey">get_netsync_client_key</a></code> is called.
</p>
<p>For a command that starts a monotone server, the Lua hook
<code><a href="User-Defaults.html#get_005fnetsync_005fserver_005fkey">get_netsync_server_key</a></code> is used.
</p>
<p>If any of the aforementioned hooks returns non-nil, the return value
is the name of the key.
</p>
</li><li> If there is only one key in the keydir, that is the key.
</li><li> Otherwise there is no key; an error occurs.
</li></ol>
</dd>
<dt><code>--keydir <arg></code>
<a name="index-_002d_002dkeydir-_003carg_003e"></a>
</dt>
<dd><p>Set the key directory (where the “key store” is located); default is
<samp>confir/keys</samp>.
</p>
</dd>
<dt><code>--log <arg></code>
<a name="index-_002d_002dlog-_003carg_003e"></a>
</dt>
<dd><p>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.
</p>
</dd>
<dt><code>--no-builtin-rcfile</code>
<a name="index-_002d_002dno_002dbuiltin_002drcfile"></a>
</dt>
<dt><code>--builtin-rcfile</code>
<a name="index-_002d_002dbuiltin_002drcfile"></a>
</dt>
<dd><p>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="Lua-Reference.html#rcfiles">rcfiles</a>).
</p>
</dd>
<dt><code>--no-default-confdir</code>
<a name="index-_002d_002dno_002ddefault_002dconfdir"></a>
</dt>
<dt><code>--allow-default-confdir</code>
<a name="index-_002d_002dallow_002ddefault_002dconfdir"></a>
</dt>
<dd><p>Don’t use a default confdir; <samp>--confdir</samp> must be specified if
a configuration file is needed.
</p>
</dd>
<dt><code>--no-format-dates</code>
<a name="index-_002d_002dno_002dformat_002ddates"></a>
</dt>
<dd><p>Don’t use the format provided by a previous <samp>--date-format</samp>,
nor the format returned by <code><a href="User-Defaults.html#get_005fdate_005fformat_005fspec">get_date_format_spec</a></code>; instead,
print dates in the format “yyyy-mm-ddThh:mm:ss”.
</p>
</dd>
<dt><code>--[no-]standard-rcfiles</code>
<a name="index-_002d_002d_005bno_002d_005dstandard_002drcfiles"></a>
</dt>
<dd><p>Do not load the standard rcfiles, which are
<samp>$HOME/.monotone/monotonerc</samp> on Unix or
<samp>%APPDATA%\monotone\monotonerc</samp> on Windows, and
<samp>_MTN/monotonerc</samp> in the current workspace. See <a href="Lua-Reference.html#rcfiles">rcfiles</a>.
</p>
</dd>
<dt><code>--no-workspace</code>
<a name="index-_002d_002dno_002dworkspace"></a>
</dt>
<dt><code>--allow-workspace</code>
<a name="index-_002d_002dallow_002dworkspace"></a>
</dt>
<dd><p>Don’t look for a workspace; this means options that normally get their
default values from the workspace will not have those default values.
</p>
</dd>
<dt><code>--non-interactive</code>
<a name="index-_002d_002dnon_002dinteractive"></a>
</dt>
<dt><code>--interactive</code>
<a name="index-_002d_002dinteractive"></a>
</dt>
<dd><p>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.
</p>
</dd>
<dt><code>--quiet</code>
<a name="index-_002d_002dquiet"></a>
</dt>
<dt><code>--verbose</code>
<a name="index-_002d_002dverbose"></a>
</dt>
<dd><p>Decrease or increase verbosity. There are four levels of verbosity;
debug, information, warning, and none. The default is information.
</p>
</dd>
<dt><code>--rcfile <arg></code>
<a name="index-_002d_002drcfile-_003carg_003e"></a>
</dt>
<dd><p>Specify an extra rcfile to load. See <a href="Lua-Reference.html#rcfiles">rcfiles</a>.
</p>
</dd>
<dt><code>--clear-rcfiles</code>
<a name="index-_002d_002dclear_002drcfiles"></a>
</dt>
<dd><p>Cancel all previous <samp>--rcfile</samp> options (standard rcfiles are
still loaded). See <a href="Lua-Reference.html#rcfiles">rcfiles</a>.
</p>
</dd>
<dt><code>--root <arg></code>
<a name="index-_002d_002droot-_003carg_003e"></a>
</dt>
<dd><p>Limit the search for a workspace to the specified root directory
</p>
</dd>
<dt><code>--ssh-sign <arg></code>
<a name="index-_002d_002dssh_002dsign-_003carg_003e"></a>
</dt>
<dd><p>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.
</p>
</dd>
<dt><code>--ticker <arg></code>
<a name="index-_002d_002dticker-_003carg_003e"></a>
</dt>
<dd><p>Set ticker style; one of ’count’, ’dot’, or ’none’
</p>
</dd>
<dt><code>--timestamps</code>
<a name="index-_002d_002dtimestamps"></a>
</dt>
<dd><p>Show timestamps in front of error, warning, and progress messages.
</p>
</dd>
<dt><code>--version</code>
<a name="index-_002d_002dversion"></a>
</dt>
<dd><p>Print version number, then exit; same as <code>mtn version</code>.
</p>
</dd>
<dt><code>--xargs <arg></code>
<a name="index-_002d_002dxargs-_003carg_003e"></a>
</dt>
<dt><code>-@ <arg></code>
<a name="index-_002d_0040-_003carg_003e"></a>
</dt>
<dd><p>Insert command line arguments taken from the given file. A ’-’
can be used to read the arguments from standard input.
e.g. <code>--xargs=-</code>
</p></dd>
</dl>
<hr>
<div class="header">
<p>
Next: <a href="Common-Options.html#Common-Options" accesskey="n" rel="next">Common Options</a>, Previous: <a href="Global-and-Common-Options.html#Global-and-Common-Options" accesskey="p" rel="prev">Global and Common Options</a>, Up: <a href="Global-and-Common-Options.html#Global-and-Common-Options" accesskey="u" rel="up">Global and Common Options</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="General-Index.html#General-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|