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/.