/usr/share/doc/refdb/refdb-manual/ch06s05.html is in refdb-doc 1.0.2-3ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Common command-line options for all clients</title><link rel="stylesheet" type="text/css" href="manual.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="RefDB handbook" /><link rel="up" href="ch06.html" title="Chapter 6. Overview of the RefDB command-line clients" /><link rel="prev" href="ch06s04.html" title="The non-interactive mode of refdbib" /><link rel="next" href="ch07.html" title="Chapter 7. Data input" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Common command-line options for all clients</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch06s04.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Overview of the RefDB command-line clients</th><td width="20%" align="right"> <a accesskey="n" href="ch07.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sect1-common-command-line-options"></a>Common command-line options for all clients</h2></div></div></div><p>All clients share a common set of command-line options. The command-line options override the corresponding settings in the <a class="link" href="ch04s03.html#sect1-mystery-init-files" title="The mystery of the configuration files">configuration files</a>. Please see the chapters about the individual applications in the <a class="link" href="pt04.html" title="Part IV. Reference manual">Reference manual</a> for all application-specific options.</p><p>All clients use the GNU getopt library to parse the command line. Switches can be combined (<code class="option">-abc</code> is the same as <code class="option">-a</code> <code class="option">-b</code> <code class="option">-c</code>) and the sequence is arbitrary (<code class="option">-a</code> <code class="option">-b</code> is the same as <code class="option">-b</code> <code class="option">-a</code>). All options are case sensitive (<code class="option">-A</code> is <span class="emphasis"><em>not</em></span> the same as <code class="option">-a</code>).</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">-c <em class="replaceable"><code>command</code></em></span></dt><dd><p>The command line of the pager that is to be used. Instead of a pager you can of course specify any valid command that accepts data on stdin. Use <span class="quote">“<span class="quote">stdout</span>”</span> to request data output to stdout. This is the default, but you may want to specify it on the command line if you need to temporarily override a default pager setting in your configuration file.</p></dd><dt><span class="term">-e <em class="replaceable"><code>logdest</code></em></span></dt><dd><p><em class="replaceable"><code>logdest</code></em> can have the values 0, 1, or 2, or the equivalent strings "stderr", "syslog", or "file", respectively. This value specifies where the log information goes to. "0" (zero) means the messages are sent to stderr. They are immediately available on the screen but they may interfere with command output. "1" will send the output to the syslog facility. Keep in mind that syslog must be configured to accept log messages from user programs, see the syslog(8) man page for further information. Unix-like systems usually save these messages in <code class="filename">/var/log/user.log</code>. "2" will send the messages to a custom log file which can be specified with the <code class="option">-L</code> option.</p></dd><dt><span class="term">-h</span></dt><dd><p>Displays help and usage screen, then exits.</p></dd><dt><span class="term">-i <em class="replaceable"><code>IP-address</code></em></span></dt><dd><p>Set the IP address of the box which is running the application server (refdbd). Instead of the IP address you can also specify the hostname as long as it can be properly resolved by your system.</p></dd><dt><span class="term">-l <em class="replaceable"><code>loglevel</code></em></span></dt><dd><p>Specify the priority up to which events are logged. This is either a number between "0" and "7" or one of the strings "emerg", "alert", "crit", "err", "warning", "notice", "info", "debug", respectively (see also <a class="link" href="ch05s06.html#table-loglevel-definitions" title="Table 5.1. Log level definitions">Log level definitions</a>). "-1" disables logging completely. A low log level like "0" means that only the most critical messages are logged. A higher log level means that less critical events are logged as well. "7" will include debug messages. The latter can be verbose and abundant, so you want to avoid this log level unless you need to track down problems.</p></dd><dt><span class="term">-L <em class="replaceable"><code>logfile</code></em></span></dt><dd><p>Specify the full path to a log file that will receive the log messages. Typically this would be <code class="filename">/var/log/<appname></code>.</p></dd><dt><span class="term">-p <em class="replaceable"><code>port</code></em></span></dt><dd><p>Set the port of the box which is running the application server</p></dd><dt><span class="term">-q</span></dt><dd><p>Start without reading the configuration files. The client will use the compile-time defaults for all values that you do not set with command-line switches.</p></dd><dt><span class="term">-T <em class="replaceable"><code>time</code></em></span></dt><dd><p>Set the timeout for client/application server dialogue in seconds. A connection with unsuccessful read or write attempts will be considered as dead and taken down after this amount of time has elapsed.</p></dd><dt><span class="term">-u <em class="replaceable"><code>name</code></em></span></dt><dd><p>Set the username for the database access.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This username need not be identical to the login name of the user. This is the username required to access the database server.</p></div></dd><dt><span class="term">-v</span></dt><dd><p>Prints version and copyright information, then exits.</p></dd><dt><span class="term">-V</span></dt><dd><p>Switches to verbose mode.</p></dd><dt><span class="term">-w <em class="replaceable"><code>password</code></em></span></dt><dd><p>Set the password for the database access.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This password need not be identical to the login password of the user. This is the password required to access the database server.</p></div><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>If you pass the password as a command-line parameter, it will be visible in the process listing with the <span class="command"><strong>ps</strong></span> command (at least for a brief period of time, until the client overwrites the password string). To avoid sharing your password with the rest of the world, you should either keep your password in your configuration file or use "-w '*'" instead. This will cause the RefDB client to ask you for the password interactively (this is also the default if you don't use the <code class="option">-w</code> switch at all and don't have an entry in the configuration file). You must protect the '*' with single quotation marks to prevent the shell from expanding it into a list of files in the current working directory.</p></div></dd><dt><span class="term">-y</span></dt><dd><p>Specify the directory where the global configuration files are</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>By default, all RefDB applications look for their configuration files in a directory that is specified during the configure step when building the package. That is, you don't need the <code class="option">-y</code> option unless you use precompiled binaries in unusual locations, e.g. by relocating a rpm package.</p></div></dd></dl></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch06s04.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch06.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch07.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">The non-interactive mode of refdbib </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 7. Data input</td></tr></table></div></body></html>
|