gdbm_primitive(1)

NAME
gdbm_primitive, gdbm-clear, gdbm-create, gdbm-dump, gdbm-exists, gdbm-keys, gdbm-load, gdbm-get, gdbm-put, gdbm-remove, gdbm-revget

SYNOPSIS
gdbm-clear [-hv] [-d database ] gdbm-create [-hv] [-d database ] gdbm-dump [-hv] [-d database ] [-f format ] gdbm-exists [-hv] [-d database ] gdbm-get [-hv] [-d database ] [-f format ] key(s) gdbm-keys [-hv] [-d database ] [-f format ] gdbm-load [-hv] [-d database ] [-f file ] [-s separator ] gdbm-put [-hv] [-d database ] key value gdbm-remove [-hv] [-d database ] key(s) gdbm-revget [-hv] [-d database ] [-f format ] value(s)

DESCRIPTION
These programs provide a primitive interface to gdbm(3) databases. They are intended to be used from the shell and from shell scripts. gdbm-clear clears the specified database, thereby creating an empty database. gdbm-create creates an new, empty database of the given name. gdbm-dump dumps the contents of the specfied database to stdout(3). If format is supplied, the key-value pairs are displayed via the format string passed to printf(3) ("%s %s" is the default). gdbm-exists returns 0 of the given database exists and 1 otherwise. The result is determined via a read-only open call to gdbm_open(3). gdbm-get returns the values associated with the given keys in the given database. If format is supplied, the values are displayed via the format string passed to printf(3) ("%s" is the default). gdbm-keys dumps the keys in the specified database to stdout(3). If format is supplied, the keys are displayed via the format string passed to printf(3) ("%s" is the default). gdbm-load loads from a given flat file into a given database. Field separators is dictated by the separator value and defaults to a tab ('\t'). Within fields in the flat file, tabs, newlines, verticle tabs, and carriage returns may be escaped as usual. gdbm-put puts the given key and value into the given database. Any previous value associated with the given key is overwritten. gdbm-remove removes the given keys from the given database. gdbm-revget performs a reverse lookup on the given values in the given databases. All keys that correspond to the given values are printed via a call to printf(3) (the default is "%s").

OPTIONS

-d  Work with the given database.

-f file
    Use the given file for reading.

-f format
    Pass the given string to calls to printf(3) (newline is implicit).

-h  Get some help.

-s separator
    Use the given string as a field separator.

-v  Get the version of the program.

BUGS
None at this time.

AUTHOR
Jonathan B. Leffert <jonathan@leffert.net>

SEE ALSO
gdbm(3).