LTDBTOOL(1)															       LTDBTOOL(1)

NAME

       ltdbtool - handle ctdb's local tdb copies

SYNOPSIS

       ltdbtool [OPTIONS] COMMAND

DESCRIPTION

       ltdbtool is a utility to cope with ctdb's local tdb copies (LTDBs) without connecting to a ctdb daemon.

       It can be used to

       o   dump the contents of a LTDB, optionally printing the ctdb record header information,

       o   convert between an LTDB and a non-clustered tdb by adding or removing ctdb headers and

       o   convert between 64 and 32 bit LTDBs where the ctdb record headers differ by 4 bytes of padding.

COMMANDS

       help
	   Print a help text.

       dump <IDB>
	   Dump the contents of a LTDB file to standard output in a human-readable format.

       convert <IDB> <ODB>
	   Make a copy of a LTDB optionally adding or removing ctdb headers.

OPTIONS

       -p
	   Dump with header information, similar to "ctdb catdb".

       -s {0|32|64}
	   Specify how to determine the ctdb record header size for the input database:

	   0
	       no ctdb header

	   32
	       ctdb header size of a 32 bit system (20 bytes)

	   64
	       ctdb header size of a 64 bit system (24 bytes)

	   The default is 32 or 64 depending on the system architecture.

       -o {0|32|64}
	   Specify how to determine the ctdb record header size for the output database, see -s

       -S <SIZE>
	   Explicitly specify the ctdb record header size of the input database in bytes.

       -O <SIZE>
	   Explicitly specify the ctdb record header size for the output database in bytes.

       -h
	   Print a help text.

EXAMPLES

       Print a local tdb in "tdbdump" style:

		 ltdbtool dump idmap2.tdb.0

       Print a local tdb with header information similar to "ctdb catdb":

		 ltdbtool dump -p idmap2.tdb.0

       Strip the ctdb headers from records:

		 ltdbtool convert -o0 idmap2.tdb.0 idmap.tdb

       Strip 64 bit ctdb headers from records, running on i386:

		 ltdbtool convert -s64 -o0 idmap2.tdb.0 idmap.tdb

       Strip the ctdb headers from records by piping through tdbrestore:

		 ltdbtool dump idmap2.tdb.0 | tdbrestore idmap.tdb

       Convert a local tdb from a 64 bit system for usage on a 32 bit system:

		 ltdbtool convert -s64 -o32 idmap2.tdb.0 idmap2.tdb.1

       Add a default header:

		 ltdbtool convert -s0 idmap.tdb idmap2.tdb.0

SEE ALSO

       ctdbd(1), ctdb(1), tdbdump(1), tdbrestore(1), http://ctdb.samba.org/

COPYRIGHT
/LICENSE
	   Copyright (C) Gregor Beck 2011
	   Copyright (C) Michael Adam 2011

	   This program is free software; you can redistribute it and/or modify
	   it under the terms of the GNU General Public License as published by
	   the Free Software Foundation; either version 3 of the License, or (at
	   your option) any later version.

	   This program is distributed in the hope that it will be useful, but
	   WITHOUT ANY WARRANTY; without even the implied warranty of
	   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
	   General Public License for more details.

	   You should have received a copy of the GNU General Public License
	   along with this program; if not, see http://www.gnu.org/licenses/.

								    05/04/2011							       LTDBTOOL(1)