/usr/share/doc/refdb/refdb-manual/ch06s02.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>The interactive mode of refdba and refdbc</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="ch06.html" title="Chapter 6. Overview of the RefDB command-line clients" /><link rel="next" href="ch06s03.html" title="The non-interactive mode of refdba and refdbc" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The interactive mode of refdba and refdbc</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch06.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="ch06s03.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp64007056"></a>The interactive mode of refdba and refdbc</h2></div></div></div><p>For informations how to start these clients from the command line, please see the sections about <a class="link" href="re06.html#refdba-synopsis" title="Synopsis">refdba</a> and <a class="link" href="re11.html#refdbc-synopsis" title="Synopsis">refdbc</a>.</p><p>If you did not specify a password in the corresponding configuration file or with the <code class="option">-w</code> command line switch (see later in this chapter), the clients will at first prompt you for a password. This is the password to access the database which may be different from your login password. To protect your password from prying eyes, it will not be echoed on the screen while you type it, so no one can even see the length of your password. If your database account was set up without password protection, just press enter now.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>If you run a client in batch mode and send data to stdin, the interactive password prompt will not work. Please use the configuration file or the <code class="option">-w</code> option to specify the password in this case.</p></div><p>Then you will be faced with a command prompt similar to the one in your shell. The client waits for you to enter commands. If it just escapes you which commands are available, use the <span class="command"><strong>help</strong></span> command (or <span class="command"><strong>?</strong></span> for the lazy among us) to see a list.</p><p>The general format of a command is:</p><div class="cmdsynopsis"><p><code class="command">command</code> [-x <em class="replaceable"><code>option-argument</code></em>...] [argument...]</p></div><p>Commands may thus have options and arguments. The options have the general style <code class="option">-x [option-argument]</code>. They consist of a dash followed by one character. Options are case-sensitive. The option may be followed by an option-argument. This has to be enclosed in quotation marks if it contains spaces. The order of the options and arguments on the command line is arbitrary. Options without arguments can be combined, e.g. you may write <code class="option">-xy</code> instead of <code class="option">-x -y</code>.</p><p>The command line of the RefDB interactive clients uses the GNU readline library. This offers you a functionality similar to the <span class="application">bash</span> command line or the <span class="application">Emacs</span> minibuffer. By default the <span class="application">Emacs</span> keybindings are active, allowing you to conveniently edit your command. You can scroll through a history of previous commands. You can use the <span class="keycap"><strong>Tab</strong></span> key to try a completion of a partially entered token. If it is the first token on the command line, the clients try to complete a command. If it is any other token, the clients try to complete a filename.</p><p>When a command is sent to the application server, the client waits for the result of the command. This may take some time, depending on the load of the application server and of the database server. Network problems or a server crash may result in a timeout. The client will in this case return to the command prompt after a configurable time.</p><p>If everything runs smooth, you will see the results of your command. Short results of only a few lines will simply be sent to stdout. Results that may cause the terminal to scroll parts of the result off the screen will be piped through a pager of your choice. Depending on the pager, you can jump back and forth in the results and perhaps save the result or part of the result in a file or pipe it to another program. It may be necessary to press some button (like <span class="keycap"><strong>q</strong></span> in <span class="application">less</span>) to get back to the command prompt when you're done. Instead of a pager you can specify any other program that accepts data on stdin, so you can e.g. preprocess the output with <span class="command"><strong>grep</strong></span> before you display it with a pager ("plumbing", i.e. piping through several applications, is of course possible). Some commands have a switch to redirect the output into a file without displaying it on the screen.</p><p>If you output large amounts of data through a pager, the pager may refuse to read on before you scroll through. In this case, a timeout would result and the data would be incomplete. The best way to deal with large amounts of data is to send them to a file and inspect them afterwards. You can use the command <span class="command"><strong>tail -f <em class="replaceable"><code>outfile</code></em></strong></span> to view the data in another console window while they arrive.</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch06.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="ch06s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 6. Overview of the RefDB command-line clients </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> The non-interactive mode of refdba and refdbc</td></tr></table></div></body></html>
|