You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
91 lines
2.7 KiB
91 lines
2.7 KiB
.TH MDB_LOAD 1 "2015/09/30" "LMDB 0.9.17" |
|
.\" Copyright 2014-2021 Howard Chu, Symas Corp. All Rights Reserved. |
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE. |
|
.SH NAME |
|
mdb_load \- LMDB environment import tool |
|
.SH SYNOPSIS |
|
.B mdb_load |
|
[\c |
|
.BR \-V ] |
|
[\c |
|
.BR \-a ] |
|
[\c |
|
.BI \-f \ file\fR] |
|
[\c |
|
.BR \-n ] |
|
[\c |
|
.BI \-s \ subdb\fR] |
|
[\c |
|
.BR \-N ] |
|
[\c |
|
.BR \-Q ] |
|
[\c |
|
.BR \-T ] |
|
.BR \ envpath |
|
.SH DESCRIPTION |
|
The |
|
.B mdb_load |
|
utility reads from the standard input and loads it into the |
|
LMDB environment |
|
.BR envpath . |
|
|
|
The input to |
|
.B mdb_load |
|
must be in the output format specified by the |
|
.BR mdb_dump (1) |
|
utility or as specified by the |
|
.B -T |
|
option below. |
|
.SH OPTIONS |
|
.TP |
|
.BR \-V |
|
Write the library version number to the standard output, and exit. |
|
.TP |
|
.BR \-a |
|
Append all records in the order they appear in the input. The input is assumed to already be |
|
in correctly sorted order and no sorting or checking for redundant values will be performed. |
|
This option must be used to reload data that was produced by running |
|
.B mdb_dump |
|
on a database that uses custom compare functions. |
|
.TP |
|
.BR \-f \ file |
|
Read from the specified file instead of from the standard input. |
|
.TP |
|
.BR \-n |
|
Load an LMDB database which does not use subdirectories. |
|
.TP |
|
.BR \-s \ subdb |
|
Load a specific subdatabase. If no database is specified, data is loaded into the main database. |
|
.TP |
|
.BR \-N |
|
Don't overwrite existing records when loading into an already existing database; just skip them. |
|
.TP |
|
.BR \-Q |
|
Quick mode, uses MDB_NOSYNC for faster loading. Forces sync with mdb_env_sync() before exiting. |
|
.TP |
|
.BR \-T |
|
Load data from simple text files. The input must be paired lines of text, where the first |
|
line of the pair is the key item, and the second line of the pair is its corresponding |
|
data item. |
|
|
|
A simple escape mechanism, where newline and backslash (\\) characters are special, is |
|
applied to the text input. Newline characters are interpreted as record separators. |
|
Backslash characters in the text will be interpreted in one of two ways: If the backslash |
|
character precedes another backslash character, the pair will be interpreted as a literal |
|
backslash. If the backslash character precedes any other character, the two characters |
|
following the backslash will be interpreted as a hexadecimal specification of a single |
|
character; for example, \\0a is a newline character in the ASCII character set. |
|
|
|
For this reason, any backslash or newline characters that naturally occur in the text |
|
input must be escaped to avoid misinterpretation by |
|
.BR mdb_load . |
|
|
|
.SH DIAGNOSTICS |
|
Exit status is zero if no errors occur. |
|
Errors result in a non-zero exit status and |
|
a diagnostic message being written to standard error. |
|
|
|
.SH "SEE ALSO" |
|
.BR mdb_dump (1) |
|
.SH AUTHOR |
|
Howard Chu of Symas Corporation <http://www.symas.com>
|
|
|