Commit | Line | Data |
463ee0b2 |
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 | |