2 .\" Copyright (C) 2004, 2005, 2007, 2008 Richard Kettlewell
4 .\" This program is free software; you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 2 of the License, or
7 .\" (at your option) any later version.
9 .\" This program is distributed in the hope that it will be useful, but
10 .\" WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 .\" General Public License for more details.
14 .\" You should have received a copy of the GNU General Public License
15 .\" along with this program; if not, write to the Free Software
16 .\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
21 disorder\-dump \- DisOrder dump/undump tool
25 .BR \-\-dump | \-\-undump
30 .BR \-\-recompute\-aliases
33 is used to dump and restore preferences data.
37 Write preferences data to \fIPATH\fR.
38 This can safely be used whether or not the server is running.
41 Read preferences data from \fIPATH\fR, replacing (unrecoverably) the
43 This should normally only be done while the server is not running.
45 If the server is running then it may hang while the undump completes.
48 Perform database recovery at startup.
49 The server should not be running if this option is used.
51 .B \-\-recompute\-aliases
52 Recompute aliases without dumping or undumping the databases.
53 Under normal circumstances this is never necessary.
55 .B \-\-remove\-pathless
56 Remove tracks with no associated path when undumping or when
58 In normal use such tracks are all aliases.
60 .B \-\-config \fIPATH\fR, \fB\-c \fIPATH
61 Set the configuration file.
63 .IR /etc/disorder/config .
68 .B \-\-help\fR, \fB\-h
69 Display a usage message.
71 .B \-\-version\fR, \fB\-V
72 Display version number.
74 This program might be used for a number of purposes:
77 Taking a backup of the non-regeneratable parts of DisOrder's databases.
80 Indoctrinating one DisOrder server with the preference values of
83 The output file is versioned, so versions produced from a future
84 version of DisOrder may be rejected by \fB\-\-undump\fR.
85 It has an end marker so truncated inputs will also be rejected.
87 The input or output file must be a regular file, as it may be rewound
88 and re-read or re-written multiple times.
90 The dump or undump operation is carried out inside a single
91 transaction, so it should seem atomic from the point of view of
92 anything else accessing the databases.
94 The server performs normal database recovery on startup.
95 However if the database needs normal recovery before an undump can succeed and
96 you don't want to start the server for some reason then the
98 operation is available for this purpose.
99 No other process should be accessing the database at the time.
101 DisOrder does not currently support catastrophic recovery.
103 This program requires write access to DisOrder's databases.
104 Ideally therefore it should be run as the same user as the server or as root.
108 Global configuration file.
109 See \fBdisorder_config\fR(5).
111 \fBdisorder\fR(1), \fBdisorder_config\fR(5), \fBdisorderd\fR(8)