Scroll to navigation

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
 
•dump the contents of a LTDB, optionally printing the ctdb record header information,
 
•convert between an LTDB and a non-clustered tdb by adding or removing ctdb headers and
 
•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