aboutsummaryrefslogtreecommitdiff
path: root/doc/gdbm.texinfo
diff options
context:
space:
mode:
Diffstat (limited to 'doc/gdbm.texinfo')
-rw-r--r--doc/gdbm.texinfo29
1 files changed, 21 insertions, 8 deletions
diff --git a/doc/gdbm.texinfo b/doc/gdbm.texinfo
index 5c962d5..201f01c 100644
--- a/doc/gdbm.texinfo
+++ b/doc/gdbm.texinfo
@@ -1886,33 +1886,33 @@ The default value is inherited from the environment variable
@end deftypevr
@anchor{quiet}
@deftypevr {gdbmtool variable} bool quiet
Whether to display a welcome banner at startup. This variable should
be set in a startup script file (@pxref{startup files}).
@xref{-q option}.
@end deftypevr
@anchor{open parameters}
The following variables control how the database is opened:
+@deftypevr {gdbmtool variable} numeric blocksize
+Sets the block size. @xref{Open, block_size}. Unset by default.
+@end deftypevr
+
@deftypevr {gdbmtool variable} numeric cachesize
Sets the cache size. @xref{Options, GDBM_SETCACHESIZE}.
By default this variable is not set.
@end deftypevr
-@deftypevr {gdbmtool variable} numeric blocksize
-Sets the block size. @xref{Open, block_size}. Unset by default.
-@end deftypevr
-
@anchor{openvar}
@deftypevr {gdbmtool variable} string open
Open mode. The following values are allowed:
@table @asis
@item newdb
Truncate the database if it exists or create a new one. Open it in
read-write mode.
Technically, this sets the @samp{GDBM_NEWDB} flag in call to @samp{gdbm_open}.
@xref{Open, GDBM_NEWDB}.
@item wrcreat
@@ -2361,25 +2361,25 @@ specifies the name of the output file. If not given,
For example, the following invocation creates a dump of the database
@file{file.db} in the file @file{file.dump}:
@example
$ gdbm_dump file.db file.dump
@end example
By default the utility creates dumps in ASCII format (@pxref{Flat
files,ASCII}). Another format can be requested using the
@option{--format} (@option{-H}) option.
-The @command{gdbm_load} utility understands the following command line
+The @command{gdbm_dump} utility understands the following command line
options:
@table @option
@item -H @var{fmt}
@itemx --format=@var{fmt}
Select output format. Valid values for @var{fmt} are: @samp{binary}
or @samp{0} to select binary dump format, and @samp{ascii} or @samp{1}
to select ASCII format.
@item -h
@itemx --help
Print a concise help summary.
@@ -2396,36 +2396,49 @@ command line options.
@node gdbm_load
@chapter The @command{gdbm_load} utility
@prindex gdbm_load
The @command{gdbm_load} utility restores a GDBM database from a flat
file. The utility requires at least one argument: the name of the
input flat file. If it is @samp{-}, the standard input will be read.
The format of the input file is detected automatically.
By default the utility attempts to restore the database under its
original name, as stored in the input file. It will fail to do so if
the input is in binary format. In that case, the name of the database
-to create can be given as the second argument.
+must be given as the second argument.
-In general, if two arguments are given, the second one is treated as
+In general, if two arguments are given the second one is treated as
the name of the database to create, overriding the file name specified
in the flat file.
The utility understands the following command line arguments:
@table @option
+
+@item -b @var{num}
+@itemx --block-size=@var{num}
+Sets block size. @xref{Open, block_size}.
+
+@item -c @var{num}
+@itemx --cache-size=@var{num}
+Sets cache size. @xref{Options, GDBM_SETCACHESIZE}.
+
+@item -M
+@itemx --mmap
+Use memory mapping.
+
@item -m @var{mode}
@item --mode=@var{mode}
-Set file mode. The argument is the desired file mode in octal.
+Sets the file mode. The argument is the desired file mode in octal.
@item -n
@itemx --no-meta
Do not restore file meta-data (ownership and mode) from the flat file.
@item -r
@itemx --replace
Replace existing keys.
@item -u @var{user}[:@var{group}]
@itemx --user=@var{user}[:@var{group}]
Set file owner. The @var{user} can be either a valid user name or

Return to:

Send suggestions and report system problems to the System administrator.