SYNOPSIScldump [options] database.dat
DESCRIPTIONcldump extracts the data contained in a Clarion database; Clarion is a Windows IDE similar to Delphi or others, and has its own (simple) database format.
cldump can extract the data contained in such a database, and export it to CSV, SQL (including the database schema, keys and indexes) or its own format (this format will give you all the meta information, but isn't easily parsable).
A Clarion database consists in a set of files :
- files contain the data,
- files contain the key/index data,
files contain the memo entries associated to the data.
- -x n, --decrypt n
Decrypt an encrypted file. Required argument n indicates
the location where the key will be retrieved. Valid values are in
the range 1 - 4 inclusive. n = 1 usually works.
Decryption happens in-place so KEEP A BACKUP as there is no guarantee the decryption process won't fail. Encrypted files must be decrypted before they can be dumped.
Note that only the data file and the memo file are decrypted in this process; key/index files are left untouched as cldump doesn't use them.
- -d, --dump-active
- Dump active entries only
- -D, --dump-data
- Dump the actual data (active and deleted entries)
- -m, --dump-meta
- Dump meta information (no SQL or CSV output format exist for this option)
- -f c, --field-separator c
- Set the field separator to character c. Only valid for CSV output (see below).
- -c, --csv
- Dump data or schema in CSV format
- -S, --sql
- Dump data or schema in SQL format
- -s, --schema
- Dump database schema
- -M, --mysql
- Use MySQL specific construct (backticks, ...)
- -n, --no-memo
- Do not dump memo entries
- -U[charset], --utf8[=charset]
Transcode strings and memos from charset to UTF-8 (charset defaults
to ISO8859-1; for the list of supported charsets, see iconv --list)
OUTPUTcldump outputs the data to stdout or stderr depending on the output format selected, the data to extract and the type of the data (data, meta data).
BUGSThe SQL output could be improved. Not all the types supported by the Clarion database format are implemented yet (due to lack of test databases using these types of data); see the source code for details.
Please report bugs to [email protected]; if possible, please send patches as the set of test databases I have is very limited.
AUTHORcldump was written by Julien BLACHE <[email protected]>.