NAME

dblist − list information about the database

SYNOPSIS

dblist database-name [ −l ] [ −p ] new-database-name

DESCRIPTION

With no arguments, dblist simply lists the keys of every item in the database. 

The −l option causes dblist to print the internal information from the database. 

The −p option causes the key and content of every entry to be listed in a shell command file in the form of a dbadd command.  If new-database-name is provided, it becomes the database argument for the dbadd commands; otherwise database-name is used. 

This form of the dblist command is very handy; it forms a readable ASCII file representation of a database for editing or shipping.  Additionally, databases should be recreated periodically for purposes of garbage collection.  To do this, the file can be executed directly, in which case the dbadd commands are executed to rebuild the database; or it can be used as the argument to the dbbuild command. 

For information on the Emacs database facility, see the following documents:

Emacs Reference Manual

SEE ALSO

Several utilities, in addition to dblist, are provided for manipulating the Emacs databases outside of Emacs. 

dbcreate(1)creates a database. 

dbadd(1)adds an entry to a database. 

dbbuild(1)builds a database from a shell command file. 

dbprint(1)prints the contents of a database entry. 

Version 2.5r1  —  December 06, 1986