|
CmdLine
|
Malete tool command line options.
| synopsis |
The general format is
malete command [general and command options] [db0 opts [db1 opts ...]]
Every parameter not starting with a '-' becomes the main value
of a new field in the environment record.
Every option (a parameter starting with a '-') is turned into a subfield
of the field introduced by the last non-option. The first character
is the subfield identifier, the remainder is the subfields value.
Command and the options following it control the overall process behaviour,
other fields specify options for objects (i.e. databases,
in the future also other objects like remote servers).
Example:
malete rdump -vi cds -ftest/
dumps records of a database named cds in files test/cds.m[rq][dx]
to stdout and some informational messages to stderr.
| general options |
General environment options use lowercase subfield identifiers (see sys.c):
- vn sets the logging level.
n is a digit from 0 (off) to 9 (all). You may also use the first letter of
off, fatal, syserr, err, warn, info, verbose, debug, trace or all.
- wn sets the writing/sharing mode.
default is exclusive write mode. n='0' selects shared read-only,
n='s' selects shared writing (not supported on windows).
| database options |
When a database is opened, it scans the environment record for a field
with the database name as main value for options (see db.c):
- b selects blocking.
The process will wait for the shared or exclusive file lock.
Without this option, it will complain immediatly.
- fpath specifies db files.
If path ends with /, it is used as directory, else as file basename (w/o ext).
- qpn specifies the index type.
A single q turns use of the index off (i.e. no index files are created).
Else p is a letter in klpt, setting the keysize, let, pointer type
or tree type, resp., to number n. Use only if you understood the
FileFormats
. For example _-qk30_ will set the keysize to 30.
- rn sets the record xref type
to number n. A single r turns record file use off.
- wm sets the write mode.
m='0' selects read-only, m='a' selects asynchronous write
(recommended only when importing databases).
No effect in a read-only environment.
| simple commands |
A couple of simple commands have no specific options.
Most commands require one database to be specified as target.
- dbinfo
print database parameters
- qdump
dump index to stdout as lines of tab-separated key,rid,tag,occ,pos.
- qload
load index from stdin in the same format
- rdump
dump records
- rload
load records
| command options |
The various commands use uppercase letters for command specific options.
- server runs a server
Without any options, reads from stdin and answers on stdout.
The -S option specifies a TCP port or UNIX (absolute filename) socket.
The TCP port may also be prefixed by "localhost:" to bind locally.
Without any value, -S uses TCP port 2042 (registered by kchapman@isis.com).
- cdsimp or cdsexp
import or export from/to
CDS
/ISIS databases.
- iifimp or iifexp
import or export from/to
IIF
(ISO2709) files.
|
|