empserver/man/empdump.6
Markus Armbruster f4f048234c empdump: Omit redundant data from export, new -c includes it
Cuts size of export files in test suite by a factor of four.  Not a
big deal for disk usage, as export files compress very well, and disk
space is cheap anyway.  Export files are simply easier to work with
when they aren't full of redundant crap.

Signed-off-by: Markus Armbruster <armbru@pond.sub.org>
2015-02-01 16:53:00 +01:00

57 lines
1.3 KiB
Groff

.TH EMPDUMP 6
.SH NAME
empdump \- Export/import Empire game state
.SH SYNOPSIS
.B empdump
[
.B \-chmnvx
]
[
.BI \-e " configfile"
]
[
.BI \-i " dump-file"
]
.br
.SH DESCRIPTION
.B empdump
exports and imports game state as plain text.
.SH OPTIONS
.TP
.B \-c
Use complete export format: don't omit data import doesn't need.
.TP
.BI \-e " configfile"
Use game configuration in \fIconfigfile\fR.
.TP
.B \-h
Help. Print brief usage information and exit.
.TP
.BI \-i " dump-file"
Import from \fIdump-file\fR.
.TP
.B \-m
Use machine-readable format for export. Import always recognizes both
machine-readable and human-readable format.
.TP
.B \-n
Dry run, don't actually update game state on import.
.TP
.B \-v
Print version information and exit.
.TP
.B \-x
Export game state to standard output.
.SH "LIMITATIONS"
.B empdump
can't export player bmaps, power report, telegrams, announcements,
message of the day, no-login message and log files. Exported
floating-point values may be inexact. Importing an exported game
state may not result in identical data files; besides the loss of
floating-point precision just mentioned, coordinates are normalized,
and characters beyond a string's terminating zero in a character array
are lost.
.SH "SEE ALSO"
\fIemp_server\fR(6).
.SH AUTHOR
Markus Armbruster <armbru@pond.sub.org>