]> git.pond.sub.org Git - empserver/blob - man/empdump.6
New utility program empdump
[empserver] / man / empdump.6
1 .TH EMPDUMP 6
2 .SH NAME
3 empdump \- Export/import Empire game state
4 .SH SYNOPSIS
5 .B empdump
6 [
7 .B \-mtxhv
8 ]
9 [
10 .BI \-e " configfile"
11 ]
12 [
13 .I dump-file
14 ]
15 .br
16 .SH DESCRIPTION
17 .B empdump
18 exports and imports game state as plain text.
19 .SH OPTIONS
20 .TP
21 .BI \-e " configfile"
22 Use game configuration in \fIconfigfile\fR.
23 .TP
24 .B \-h
25 Help.  Print brief usage information and exit.
26 .TP
27 .TP
28 .B \-m
29 Use machine-readable format for export.  Import always recognizes both
30 machine-readable and human-readable format.
31 .TP
32 .B \-t
33 Test import, don't update game state.
34 .TP
35 .B \-v
36 Print version information and exit.
37 .TP
38 .B \-x
39 Export game state to standard output.
40 .SH OPERANDS
41 .TP
42 .I dump-file
43 The file to import.
44 .SH "LIMITATIONS"
45 .B empdump
46 can't export player bmaps, power report, telegrams, announcements,
47 message of the day, no-login message and log files.  Exported
48 floating-point values may be inexact.  Importing an exported game
49 state may not result in identical data files; besides the loss of
50 floating-point precision just mentioned, coordinates are normalized,
51 and characters beyond a string's terminating zero in a character array
52 are lost.
53 .SH "BUGS"
54 Importing resets timestamps to zero.  It should set them to the
55 current time.
56 .SH "SEE ALSO"
57 \fIemp_server\fR(6).
58 .SH AUTHOR
59 Markus Armbruster <armbru@pond.sub.org>