contrib/perl5/ext/SDBM_File/sdbm/dbe.1

   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