[perl5.git] / ext / SDBM_File / dbe.1

.TH dbe 1 "ndbm(3) EDITOR"
.SH NAME
dbe \- Edit a ndbm(3) database
.SH USAGE
dbe <database> [-m r|w|rw] [-crtvx] -a|-d|-f|-F|-s [<key> [<content>]]
.SH DESCRIPTION
\fIdbme\fP operates on ndbm(3) databases.
It can be used to create them, look at them or change them.
When specifying the value of a key or the content of its associated entry,
\\nnn, \\0, \\n, \\t, \\f and \\r are interpreted as usual.
When displaying key/content pairs, non-printable characters are displayed
using the \\nnn notation.
.SH OPTIONS
.IP -a
List all entries in the database.
.IP -c
Create the database if it does not exist.
.IP -d
Delete the entry associated with the specified key.
.IP -f
Fetch and display the entry associated with the specified key.
.IP -F
Fetch and display all the entries whose key match the specified
regular-expression
.IP "-m r|w|rw"
Open the database in read-only, write-only or read-write mode
.IP -r
Replace the entry associated with the specified key if it already exists.
See option -s.
.IP -s
Store an entry under a specific key.
An error occurs if the key already exists and the option -r was not specified.
.IP -t
Re-initialize the database before executing the command.
.IP -v
Verbose mode.
Confirm stores and deletions.
.IP -x
If option -x is used with option -c, then if the database already exists,
an error occurs.
This can be used to implement a simple exclusive access locking mechanism.
.SH SEE ALSO
ndbm(3)
.SH AUTHOR
janick@bnr.ca
Commit	Line	Data
463ee0b2 LW	1	.TH dbe 1 "ndbm(3) EDITOR"
	2	.SH NAME
	3	dbe \- Edit a ndbm(3) database
	4	.SH USAGE
	5	dbe <database> [-m r\|w\|rw] [-crtvx] -a\|-d\|-f\|-F\|-s [<key> [<content>]]
	6	.SH DESCRIPTION
	7	\fIdbme\fP operates on ndbm(3) databases.
	8	It can be used to create them, look at them or change them.
	9	When specifying the value of a key or the content of its associated entry,
	10	\\nnn, \\0, \\n, \\t, \\f and \\r are interpreted as usual.
	11	When displaying key/content pairs, non-printable characters are displayed
	12	using the \\nnn notation.
	13	.SH OPTIONS
	14	.IP -a
	15	List all entries in the database.
	16	.IP -c
	17	Create the database if it does not exist.
	18	.IP -d
	19	Delete the entry associated with the specified key.
	20	.IP -f
	21	Fetch and display the entry associated with the specified key.
	22	.IP -F
	23	Fetch and display all the entries whose key match the specified
	24	regular-expression
	25	.IP "-m r\|w\|rw"
	26	Open the database in read-only, write-only or read-write mode
	27	.IP -r
	28	Replace the entry associated with the specified key if it already exists.
	29	See option -s.
	30	.IP -s
	31	Store an entry under a specific key.
	32	An error occurs if the key already exists and the option -r was not specified.
	33	.IP -t
	34	Re-initialize the database before executing the command.
	35	.IP -v
	36	Verbose mode.
	37	Confirm stores and deletions.
	38	.IP -x
	39	If option -x is used with option -c, then if the database already exists,
	40	an error occurs.
	41	This can be used to implement a simple exclusive access locking mechanism.
	42	.SH SEE ALSO
	43	ndbm(3)
	44	.SH AUTHOR
	45	janick@bnr.ca
	46