Coronita

Announcement
htld


Selene

Announcement


Malete

DownLoad
Status
OverView
Usage
Structures
Protocol
Query
MultiProcess


formats

FileFormats
character sets
... and converting
CDS/ISIS
IIF/ISO2709


misc

changes from earlier versions
tag numbers


drafts (partly obsolete)

MetaData
object model
Tcl
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.