projects/pwm: pwm.1.xml annotate

annotate pwm.1.xml @ 27:722a45b4028b

Add define command for defining macros Macros are parsed when they are defined with the D command and can subsequently be used as arguments for other commands. Handle out of memory errors directly in tok.c.

author	Guido Berhoerster <guido+pwm@berhoerster.name>
date	Mon, 25 Sep 2017 21:21:25 +0200
parents	5bdea77d0c1d
children	e3db02d7f1f4

rev	line source
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	1 <?xml version="1.0"?>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	2 <!--
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	3
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	4 Copyright (C) 2017 Guido Berhoerster <guido+pwm@berhoerster.name>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	5
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	6 Permission is hereby granted, free of charge, to any person obtaining
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	7 a copy of this software and associated documentation files (the
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	8 "Software"), to deal in the Software without restriction, including
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	9 without limitation the rights to use, copy, modify, merge, publish,
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	10 distribute, sublicense, and/or sell copies of the Software, and to
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	11 permit persons to whom the Software is furnished to do so, subject to
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	12 the following conditions:
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	13
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	14 The above copyright notice and this permission notice shall be included
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	15 in all copies or substantial portions of the Software.
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	16
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	17 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	18 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	19 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	20 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	21 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	22 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	23 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	24
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	25 -->
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	26 <refentry xmlns="http://docbook.org/ns/docbook"
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	27 xmlns:xlink="http://www.w3.org/1999/xlink" xml:lang="en">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	28 <info>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	29 <author>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	30 <personname>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	31 <firstname>Guido</firstname>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	32 <surname>Berhoerster</surname>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	33 </personname>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	34 <email>guido+pwm@berhoerster.name</email>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	35 <personblurb/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	36 </author>
27 722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	37 <date>25 September, 2017</date>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	38 </info>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	39 <refmeta>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	40 <refentrytitle>pwm</refentrytitle>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	41 <manvolnum>1</manvolnum>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	42 <refmiscinfo class="source"/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	43 <refmiscinfo class="version"/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	44 <refmiscinfo class="manual">User Commands</refmiscinfo>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	45 </refmeta>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	46 <refnamediv>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	47 <refname>pwm</refname>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	48 <refpurpose>password manager</refpurpose>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	49 </refnamediv>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	50 <refsynopsisdiv>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	51 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	52 <command>pwm</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	53 <arg choice="opt">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	54 <option>-P</option>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	55 <replaceable>password_file</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	56 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	57 <arg choice="opt">
23 1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	58 <option>-R</option>
1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	59 </arg>
1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	60 <arg choice="opt">
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	61 <replaceable>database_file</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	62 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	63 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	64 </refsynopsisdiv>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	65 <refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	66 <title>Description</title>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	67 <para>The <command>pwm</command> utility is a password manager which
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	68 stores passwords and associated metadata in an encrypted database protected
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	69 by a master password. It offers both a text-based user interface for
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	70 interactive use as well as a non-interactive mode. The database uses the
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	71 PasswordSafe database version 3 file format and thus provides
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	72 interoperabity with other password managers using the same format.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	73 <para>After opening an existing database or creating a new one,
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	74 <command>pwm</command> provides commands to create, modify, delete, and
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	75 display password database entries which may be organized in groups. The
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	76 contents of a field of a given entry can also be piped to an external
26 5bdea77d0c1d Add pwm-clip utility for setting the X11 CLIPBOARD selection Guido Berhoerster <guido+pwm@berhoerster.name> parents: 23 diff changeset	77 command such as the <citerefentry><refentrytitle>pwm-clip</refentrytitle>
5bdea77d0c1d Add pwm-clip utility for setting the X11 CLIPBOARD selection Guido Berhoerster <guido+pwm@berhoerster.name> parents: 23 diff changeset	78 <manvolnum>1</manvolnum></citerefentry> utility in order to copy the
5bdea77d0c1d Add pwm-clip utility for setting the X11 CLIPBOARD selection Guido Berhoerster <guido+pwm@berhoerster.name> parents: 23 diff changeset	79 content of the username or password field of an entry to the
5bdea77d0c1d Add pwm-clip utility for setting the X11 CLIPBOARD selection Guido Berhoerster <guido+pwm@berhoerster.name> parents: 23 diff changeset	80 clipboard.</para>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	81 <para>If specified, <command>pwm</command> will open or create
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	82 <replaceable>database_file</replaceable> instead of the user's default
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	83 database.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	84 <para><command>pwm</command> must be run with a locale which uses the UTF-8
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	85 character encoding.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	86 <refsect2>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	87 <title>Output format</title>
10 17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	88 <para>The <command>show</command> and <command>info</command> commands
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	89 display fields by printing the field name followed by a colon, one or
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	90 more space characters and the field's verbatim content to the standard
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	91 output stream. Field content may contain newlines, non-printable and/or
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	92 control characters.</para>
17 a08ef0674d8e Page long output in interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 16 diff changeset	93 <para>If running in interactive mode, the <command>list</command>,
a08ef0674d8e Page long output in interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 16 diff changeset	94 <command>show</command> and <command>info</command> will display
a08ef0674d8e Page long output in interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 16 diff changeset	95 the results on a page-by-page basis using an internal pager.</para>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	96 <para>The <command>pipe</command> prints the verbatim field content to the
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	97 standard input stream of the given command.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	98 <para>Error messages are printed to the standard error stream.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	99 </refsect2>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	100 </refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	101 <refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	102 <title>Options</title>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	103 <para>The following options are supported:</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	104 <variablelist>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	105 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	106 <term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	107 <option>-P</option>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	108 <replaceable>password_file</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	109 </term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	110 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	111 <para>Read the master password from the first line of
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	112 <replaceable>password_file</replaceable>.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	113 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	114 </varlistentry>
23 1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	115 <varlistentry>
1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	116 <term>
1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	117 <option>-R</option>
1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	118 </term>
1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	119 <listitem>
1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	120 <para>Treat the database as read-only and disallow any modifications
1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	121 and write operations.</para>
1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	122 </listitem>
1b89066d992c Add read-only mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 22 diff changeset	123 </varlistentry>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	124 </variablelist>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	125 </refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	126 <refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	127 <title>Usage</title>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	128 <para>If stdin is connected to a terminal pwm will run in interactive mode
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	129 and prompt the user for the master password unless
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	130 <replaceable>password_file</replaceable> is specified via the
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	131 <option>-P</option> option. After successfully opening the password
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	132 database the user will be prompted for a command.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	133 <para>When running in non-interactive mode a file containing the master
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	134 pasword must be specified via the <option>-P</option> option and after
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	135 successfully opening the password database, pwm will execute commands read
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	136 from stdin until either an error occurrs or end-of-file is reached.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	137 <para><command>pwm</command> operates on a copy of the password database
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	138 in memory, any changes must be explicitly written back to the database
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	139 using the write command.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	140 <refsect2>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	141 <title>IDs</title>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	142 <para>Database entries are referred to by an ID value which is a
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	143 positive integer value that is guaranteed to be unqiue during the run
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	144 time of the pwm utility.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	145 </refsect2>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	146 <refsect2>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	147 <title>Fields</title>
10 17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	148 <para>The following entry fields are supported:</para>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	149 <table xml:id="field-table">
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	150 <title>Fields and their identifiers</title>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	151 <tgroup cols="2" align="left" colsep="1" rowsep="1">
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	152 <thead>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	153 <row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	154 <entry>Field</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	155 <entry>Field Identifier</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	156 </row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	157 </thead>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	158 <tbody>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	159 <row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	160 <entry>Group</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	161 <entry>group</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	162 </row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	163 <row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	164 <entry>Title</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	165 <entry>title</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	166 </row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	167 <row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	168 <entry>Username</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	169 <entry>username</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	170 </row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	171 <row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	172 <entry>Password</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	173 <entry>password</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	174 </row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	175 <row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	176 <entry>Notes</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	177 <entry>notes</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	178 </row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	179 <row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	180 <entry>URL</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	181 <entry>url</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	182 </row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	183 <row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	184 <entry>Creation Time</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	185 <entry>ctime</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	186 </row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	187 <row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	188 <entry>Modification Time</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	189 <entry>mtime</entry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	190 </row>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	191 </tbody>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	192 </tgroup>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	193 </table>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	194 <para>Other, existing fields specified by the PasswordSafe file format
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	195 will be preserved but cannot be displayed or modified.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	196 </refsect2>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	197 <refsect2>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	198 <title>Commands</title>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	199 <para>Each command must appear on a seperate line terminated by a newline
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	200 character. The command and its arguments are seperated by whitespace,
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	201 i.e. one or more space or tab characters. If an argument contains
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	202 whitespace characters it must either be quoted by encosing it in single
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	203 or double quote characters or each whitespace character must be preceded
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	204 by a backslash character. Arguments quoted with a single or double quote
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	205 character preserve the literal values of all characters with the
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	206 exception of the backslash character which can be used to escape the
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	207 respective quoting character. Two consecutive backslash characters yield
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	208 a literal backslash within both quoted and unquoted arguments. A line
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	209 must not end in a single backslash character, any other backslash
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	210 characters are ignored.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	211 <para>If an error occurrs while parsing or executing a command,
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	212 <command>pwm</command> will terminate when running in non-interactive
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	213 mode. In interactive mode it will print an error message and prompt the
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	214 user for the next command. The following commands are supported:</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	215 <variablelist>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	216 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	217 <term>List entries</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	218 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	219 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	220 <command>list</command>
11 85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	221 <arg choice="opt" rep="repeat">
85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	222 <replaceable>field</replaceable>~<replaceable>regex</replaceable>
85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	223 </arg>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	224 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	225 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	226 <command>ls</command>
11 85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	227 <arg choice="opt" rep="repeat">
85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	228 <replaceable>field</replaceable>~<replaceable>regex</replaceable>
85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	229 </arg>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	230 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	231 </cmdsynopsis>
11 85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	232 <para>List password database entries. If one or more filter
85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	233 expressions are specified, limit the displayed entries to those
85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	234 whose <replaceable>field</replaceable> content matches the extended
85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	235 regular expression <replaceable>regex</replaceable>.</para>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	236 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	237 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	238 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	239 <term>Create entry</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	240 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	241 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	242 <command>create</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	243 <arg choice="opt" rep="repeat">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	244 <replaceable>field</replaceable>=<replaceable>value</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	245 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	246 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	247 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	248 <command>c</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	249 <arg choice="opt" rep="repeat">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	250 <replaceable>field</replaceable>=<replaceable>value</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	251 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	252 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	253 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	254 <para>Create a new entry assigning each given
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	255 <replaceable>field</replaceable> to the corresponsing
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	256 <replaceable>value</replaceable>.</para>
22 ec01c579024a Add fully interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 21 diff changeset	257 <para>If no fields are specified in interactive mode,
ec01c579024a Add fully interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 21 diff changeset	258 <command>pwm</command> will prompt the user for the content of
ec01c579024a Add fully interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 21 diff changeset	259 each field.</para>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	260 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	261 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	262 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	263 <term>Modify entry</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	264 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	265 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	266 <command>modify</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	267 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	268 <replaceable>id</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	269 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	270 <arg choice="opt" rep="repeat">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	271 <replaceable>field</replaceable>=<replaceable>value</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	272 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	273 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	274 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	275 <command>m</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	276 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	277 <replaceable>id</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	278 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	279 <arg choice="opt" rep="repeat">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	280 <replaceable>field</replaceable>=<replaceable>value</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	281 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	282 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	283 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	284 <para>Modify an existing entry identified by
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	285 <replaceable>id</replaceable> assigning each given
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	286 <replaceable>field</replaceable> to the corresponsing
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	287 <replaceable>value</replaceable>.</para>
22 ec01c579024a Add fully interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 21 diff changeset	288 <para>If no fields are specified and <command>pwm</command> is
ec01c579024a Add fully interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 21 diff changeset	289 running in interactive mode, it will prompt the user for the
ec01c579024a Add fully interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 21 diff changeset	290 content of each field, allowing him to edit any previous
ec01c579024a Add fully interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 21 diff changeset	291 content.</para>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	292 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	293 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	294 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	295 <term>Remove entry</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	296 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	297 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	298 <command>remove</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	299 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	300 <replaceable>id</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	301 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	302 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	303 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	304 <command>rm</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	305 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	306 <replaceable>id</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	307 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	308 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	309 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	310 <para>Remove an existing entry identified by
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	311 <replaceable>id</replaceable>.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	312 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	313 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	314 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	315 <term>Display entry fields</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	316 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	317 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	318 <command>show</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	319 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	320 <replaceable>id</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	321 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	322 <arg choice="opt" rep="repeat">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	323 <replaceable>field</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	324 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	325 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	326 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	327 <command>s</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	328 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	329 <replaceable>id</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	330 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	331 <arg choice="opt" rep="repeat">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	332 <replaceable>field</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	333 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	334 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	335 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	336 <para>Display each <replaceable>field</replaceable> of the entry
15 3380c8fd9776 Show all record fields except the password by default Guido Berhoerster <guido+pwm@berhoerster.name> parents: 14 diff changeset	337 identified by <replaceable>id</replaceable>. If no field is
3380c8fd9776 Show all record fields except the password by default Guido Berhoerster <guido+pwm@berhoerster.name> parents: 14 diff changeset	338 specified, display all fields except the password field.</para>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	339 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	340 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	341 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	342 <term>Pipe entry fields to an external command</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	343 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	344 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	345 <command>pipe</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	346 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	347 <replaceable>id</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	348 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	349 <arg choice="plain" rep="repeat">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	350 <replaceable>field</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	351 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	352 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	353 <replaceable>command</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	354 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	355 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	356 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	357 <command>p</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	358 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	359 <replaceable>id</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	360 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	361 <arg choice="plain" rep="repeat">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	362 <replaceable>field</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	363 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	364 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	365 <replaceable>command</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	366 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	367 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	368 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	369 <para>Pipe the content of each given
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	370 <replaceable>field</replaceable> of the entry identified by id to
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	371 command which must be a single argument. The command is executed by
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	372 invoking the <command>sh</command> utility with the <arg>-c</arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	373 option and <replaceable>command</replaceable> as its option
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	374 argument, thus special care should be applied to quoting command.
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	375 See the <citerefentry><refentrytitle>sh</refentrytitle>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	376 <manvolnum>1</manvolnum></citerefentry> manual page for
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	377 details.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	378 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	379 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	380 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	381 <term>Create empty group</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	382 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	383 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	384 <command>creategroup</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	385 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	386 <replaceable>name</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	387 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	388 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	389 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	390 <command>cg</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	391 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	392 <replaceable>name</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	393 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	394 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	395 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	396 <para>Create a new empty group named
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	397 <replaceable>name</replaceable>.</para>
22 ec01c579024a Add fully interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 21 diff changeset	398 <para>In interactive-mode the <replaceable>name</replaceable>
ec01c579024a Add fully interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 21 diff changeset	399 argument is optional, if it is not specified <command>pwm</command>
ec01c579024a Add fully interactive mode Guido Berhoerster <guido+pwm@berhoerster.name> parents: 21 diff changeset	400 will prompt the user for it.</para>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	401 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	402 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	403 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	404 <term>Remove empty group</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	405 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	406 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	407 <command>removegroup</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	408 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	409 <replaceable>name</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	410 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	411 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	412 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	413 <command>rg</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	414 <arg choice="plain">
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	415 <replaceable>name</replaceable>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	416 </arg>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	417 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	418 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	419 <para>Remove the empty group named
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	420 <replaceable>name</replaceable>.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	421 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	422 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	423 <varlistentry>
12 8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	424 <term>Generate a random password</term>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	425 <listitem>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	426 <cmdsynopsis>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	427 <command>generatepassword</command>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	428 <arg choice="opt">
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	429 <replaceable>id</replaceable>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	430 </arg>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	431 <arg choice="opt">
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	432 len=<replaceable>n</replaceable>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	433 </arg>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	434 <arg choice="opt" rep="repeat">
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	435 chars=<replaceable>n</replaceable>:<replaceable>chars</replaceable>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	436 </arg>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	437 <arg choice="opt" rep="repeat">
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	438 charclass=<replaceable>n</replaceable>:<replaceable>class</replaceable>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	439 </arg>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	440 </cmdsynopsis>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	441 <cmdsynopsis>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	442 <command>gp</command>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	443 <arg choice="opt">
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	444 <replaceable>id</replaceable>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	445 </arg>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	446 <arg choice="opt">
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	447 len=<replaceable>n</replaceable>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	448 </arg>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	449 <arg choice="opt" rep="repeat">
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	450 chars=<replaceable>n</replaceable>:<replaceable>chars</replaceable>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	451 </arg>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	452 <arg choice="opt" rep="repeat">
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	453 charclass=<replaceable>n</replaceable>:<replaceable>class</replaceable>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	454 </arg>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	455 <sbr/>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	456 </cmdsynopsis>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	457 <para>Randomly generate a new password according to the specified
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	458 constraints. The <literal>len</literal> argument sets the length of
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	459 the generated password to <replaceable>n</replaceable> characters.
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	460 The <literal>chars</literal> argument constrains the password to
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	461 <replaceable>n</replaceable> from the set of characters
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	462 <replaceable>chars</replaceable>. Similarly, the
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	463 <literal>charclass</literal> argument to
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	464 <replaceable>n</replaceable> characters from the extended regular
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	465 expression character class <replaceable>class</replaceable>.
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	466 Multiple <literal>char</literal> and <literal>charclass</literal>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	467 arguments may be specified, in which case the generated passwords
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	468 match all of them.</para>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	469 </listitem>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	470 </varlistentry>
8768fbd09bc5 Add generatepassword command to generate random passwords Guido Berhoerster <guido+pwm@berhoerster.name> parents: 11 diff changeset	471 <varlistentry>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	472 <term>Change the master password</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	473 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	474 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	475 <command>changepassword</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	476 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	477 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	478 <command>ch</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	479 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	480 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	481 <para>Change the master password.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	482 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	483 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	484 <varlistentry>
27 722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	485 <term>Define macro</term>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	486 <listitem>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	487 <cmdsynopsis>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	488 <command>define</command>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	489 <arg choice="plain">
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	490 <replaceable>name</replaceable>=<replaceable>value</replaceable>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	491 </arg>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	492 </cmdsynopsis>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	493 <cmdsynopsis>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	494 <command>D</command>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	495 <arg choice="plain">
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	496 <replaceable>name</replaceable>=<replaceable>value</replaceable>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	497 </arg>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	498 <sbr/>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	499 </cmdsynopsis>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	500 <para>Define the macro <replaceable>name</replaceable> to expand to
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	501 <replaceable>value</replaceable>. A Macro is a shorthand term for
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	502 a command and/or command arguments. Macros are tokenized when they
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	503 are defined, thus if a macro contains other macros, these other
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	504 macros are expanded once at the time the macro is defined and not
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	505 each time a macro is expanded later. A macro can be used as like a
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	506 command or as part of the command's argument by prefixing the macro
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	507 name by a "$". It is expanded by substituting the
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	508 previously tokenized contents before the command is
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	509 evaluated.</para>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	510 </listitem>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	511 </varlistentry>
722a45b4028b Add define command for defining macros Guido Berhoerster <guido+pwm@berhoerster.name> parents: 26 diff changeset	512 <varlistentry>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	513 <term>Display help text</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	514 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	515 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	516 <command>help</command>
14 a01899a6e4bb Extend help command to show usage information for commands Guido Berhoerster <guido+pwm@berhoerster.name> parents: 13 diff changeset	517 <arg choice="opt">
a01899a6e4bb Extend help command to show usage information for commands Guido Berhoerster <guido+pwm@berhoerster.name> parents: 13 diff changeset	518 <replaceable>command</replaceable>
a01899a6e4bb Extend help command to show usage information for commands Guido Berhoerster <guido+pwm@berhoerster.name> parents: 13 diff changeset	519 </arg>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	520 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	521 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	522 <command>h</command>
14 a01899a6e4bb Extend help command to show usage information for commands Guido Berhoerster <guido+pwm@berhoerster.name> parents: 13 diff changeset	523 <arg choice="opt">
a01899a6e4bb Extend help command to show usage information for commands Guido Berhoerster <guido+pwm@berhoerster.name> parents: 13 diff changeset	524 <replaceable>command</replaceable>
a01899a6e4bb Extend help command to show usage information for commands Guido Berhoerster <guido+pwm@berhoerster.name> parents: 13 diff changeset	525 </arg>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	526 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	527 </cmdsynopsis>
14 a01899a6e4bb Extend help command to show usage information for commands Guido Berhoerster <guido+pwm@berhoerster.name> parents: 13 diff changeset	528 <para>Display a summary of all commands or usage information for
a01899a6e4bb Extend help command to show usage information for commands Guido Berhoerster <guido+pwm@berhoerster.name> parents: 13 diff changeset	529 the specified <replaceable>command</replaceable>.</para>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	530 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	531 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	532 <varlistentry>
10 17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	533 <term>Show metadata information</term>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	534 <listitem>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	535 <cmdsynopsis>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	536 <command>info</command>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	537 </cmdsynopsis>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	538 <cmdsynopsis>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	539 <command>i</command>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	540 <sbr/>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	541 </cmdsynopsis>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	542 <para>Display metadata information such as the user who last wrote
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	543 to the database, the time when the database was last written to,
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	544 and the host on which the password database was last written
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	545 to.</para>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	546 </listitem>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	547 </varlistentry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	548 <varlistentry>
16 a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	549 <term>Display status messages</term>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	550 <listitem>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	551 <cmdsynopsis>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	552 <command>status</command>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	553 </cmdsynopsis>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	554 <cmdsynopsis>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	555 <command>t</command>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	556 <sbr/>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	557 </cmdsynopsis>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	558 <para>Redisplay any error message from the previous command and
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	559 whether there are unsaved changes.</para>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	560 </listitem>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	561 </varlistentry>
a07665727c19 Add status command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 15 diff changeset	562 <varlistentry>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	563 <term>Write database</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	564 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	565 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	566 <command>write</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	567 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	568 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	569 <command>w</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	570 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	571 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	572 <para>Write all changes back to the password database.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	573 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	574 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	575 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	576 <term>Quit</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	577 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	578 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	579 <command>quit</command>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	580 </cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	581 <cmdsynopsis>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	582 <command>q</command>
21 ee4d36c85287 Make EOF in interactive mode equivalent to the q command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 20 diff changeset	583 </cmdsynopsis>
ee4d36c85287 Make EOF in interactive mode equivalent to the q command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 20 diff changeset	584 <cmdsynopsis>
ee4d36c85287 Make EOF in interactive mode equivalent to the q command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 20 diff changeset	585 <keysym>end-of-file</keysym>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	586 <sbr/>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	587 </cmdsynopsis>
13 cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	588 <para>Quit <command>pwm</command>. If running in interactive mode
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	589 and there are unsaved changes, <command>pwm</command> will not
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	590 terminate but display a warning message. If the quit command is
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	591 invoked twice consecutively, <command>pwm</command> will discard
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	592 unsaved changes and terminate.</para>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	593 </listitem>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	594 </varlistentry>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	595 <varlistentry>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	596 <term>Quit and discard unsaved changes</term>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	597 <listitem>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	598 <cmdsynopsis>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	599 <command>Quit</command>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	600 </cmdsynopsis>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	601 <cmdsynopsis>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	602 <command>Q</command>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	603 <sbr/>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	604 </cmdsynopsis>
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	605 <para>Quit <command>pwm</command> and discard any unsaved changes
cf81eb0c2d5a Warn before quitting if there are unsaved changes Guido Berhoerster <guido+pwm@berhoerster.name> parents: 12 diff changeset	606 without a warning.</para>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	607 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	608 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	609 </variablelist>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	610 </refsect2>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	611 </refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	612 <refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	613 <title>File Format</title>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	614 <para>The canonical description of the file format is included with the
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	615 distribution of the <citerefentry><refentrytitle>pwsafe</refentrytitle>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	616 <manvolnum>1</manvolnum></citerefentry> utility.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	617 </refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	618 <refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	619 <title>Environment Variables</title>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	620 <variablelist>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	621 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	622 <term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	623 <literal>LANG</literal>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	624 </term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	625 <term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	626 <literal>LC_ALL</literal>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	627 </term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	628 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	629 <para>See <citerefentry><refentrytitle>locale</refentrytitle>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	630 <manvolnum>5</manvolnum></citerefentry></para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	631 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	632 </varlistentry>
10 17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	633 <varlistentry>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	634 <term>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	635 <literal>LOGNAME</literal>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	636 </term>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	637 <listitem>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	638 <para>The name of the logged in user which is recorded when writing
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	639 the password database</para>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	640 </listitem>
17fb30016e64 Enable access to record and file metadata Guido Berhoerster <guido+pwm@berhoerster.name> parents: 1 diff changeset	641 </varlistentry>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	642 </variablelist>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	643 </refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	644 <refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	645 <title>Exit Status</title>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	646 <para>The following exit values are returned:</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	647 <variablelist>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	648 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	649 <term>0</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	650 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	651 <para>Command successfully executed.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	652 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	653 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	654 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	655 <term>1</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	656 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	657 <para>An unspecified error has occured.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	658 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	659 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	660 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	661 <term>2</term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	662 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	663 <para>Invalid command line options were specified.</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	664 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	665 </varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	666 </variablelist>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	667 </refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	668 <refsect1>
20 efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	669 <title>Asynchronous Events</title>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	670 <variablelist>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	671 <varlistentry>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	672 <term><literal>SIGINT</literal></term>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	673 <term><literal>SIGHUP</literal></term>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	674 <term><literal>SIGTERM</literal></term>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	675 <listitem>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	676 <para>If there are changes since the database was last written and
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	677 <command>pwm</command> is running in interactive mode, it
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	678 automatically writes a copy of the current database to the file
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	679 <filename>~/.pwm/autosave.psafe3</filename> which may be used for
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	680 recovery later.</para>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	681 </listitem>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	682 </varlistentry>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	683 </variablelist>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	684 </refsect1>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	685 <refsect1>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	686 <title>Files</title>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	687 <variablelist>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	688 <varlistentry>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	689 <term><filename>~/.pwm/pwm.psafe3</filename></term>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	690 <listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	691 <para>default password database</para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	692 </listitem>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	693 </varlistentry>
20 efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	694 <varlistentry>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	695 <term><filename>~/.pwm/autosave.psafe3</filename></term>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	696 <listitem>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	697 <para>automatic copy of the password database after receiving a fatal
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	698 signal in interactive mode</para>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	699 </listitem>
efef93e54c5f Automatically save the database when receiving a fatal signal Guido Berhoerster <guido+pwm@berhoerster.name> parents: 17 diff changeset	700 </varlistentry>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	701 </variablelist>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	702 </refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	703 <refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	704 <title>See Also</title>
26 5bdea77d0c1d Add pwm-clip utility for setting the X11 CLIPBOARD selection Guido Berhoerster <guido+pwm@berhoerster.name> parents: 23 diff changeset	705 <para><citerefentry><refentrytitle>pwm-clip</refentrytitle>
5bdea77d0c1d Add pwm-clip utility for setting the X11 CLIPBOARD selection Guido Berhoerster <guido+pwm@berhoerster.name> parents: 23 diff changeset	706 <manvolnum>1</manvolnum></citerefentry>,
5bdea77d0c1d Add pwm-clip utility for setting the X11 CLIPBOARD selection Guido Berhoerster <guido+pwm@berhoerster.name> parents: 23 diff changeset	707 <citerefentry><refentrytitle>pwsafe</refentrytitle>
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	708 <manvolnum>1</manvolnum></citerefentry>,
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	709 <citerefentry><refentrytitle>sh</refentrytitle>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	710 <manvolnum>1</manvolnum></citerefentry>,
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	711 <citerefentry><refentrytitle>locale</refentrytitle>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	712 <manvolnum>5</manvolnum></citerefentry>,
11 85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	713 <citerefentry><refentrytitle>regex</refentrytitle>
85bce13237cf Add filter expressions to list command Guido Berhoerster <guido+pwm@berhoerster.name> parents: 10 diff changeset	714 <manvolnum>5</manvolnum></citerefentry>,
1 55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	715 <link xlink:href="https://pwsafe.org/"/></para>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	716 </refsect1>
55281f14dc9b Add README file and manpage Guido Berhoerster <guido+pwm@berhoerster.name> parents: diff changeset	717 </refentry>

Mercurial > projects > pwm

annotate pwm.1.xml @ 27:722a45b4028b