<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <refentry id="ltdbtool.1"> <refmeta> <refentrytitle>ltdbtool</refentrytitle> <manvolnum>1</manvolnum> <refmiscinfo class="source">ctdb</refmiscinfo> <refmiscinfo class="manual">CTDB - clustered TDB database</refmiscinfo> </refmeta> <refnamediv> <refname>ltdbtool</refname> <refpurpose>manipulate CTDB's local TDB files</refpurpose> </refnamediv> <refsynopsisdiv> <cmdsynopsis> <command>ltdbtool</command> <arg rep="repeat"><replaceable>OPTION</replaceable></arg> <arg choice="req"><replaceable>COMMAND</replaceable></arg> <arg><replaceable>COMMAND-ARGS</replaceable></arg> </cmdsynopsis> </refsynopsisdiv> <refsect1> <title>DESCRIPTION</title> <para> ltdbtool is a utility to manipulate CTDB's local TDB databases (LTDBs) without connecting to a CTDB daemon. </para> <para> It can be used to: </para> <itemizedlist> <listitem> <para> dump the contents of a LTDB, optionally printing the CTDB record header information, </para> </listitem> <listitem> <para> convert between an LTDB and a non-clustered tdb by adding or removing CTDB headers and </para> </listitem> <listitem> <para>convert between 64 and 32 bit LTDBs where the CTDB record headers differ by 4 bytes of padding. </para> </listitem> </itemizedlist> </refsect1> <refsect1> <title>OPTIONS</title> <variablelist> <varlistentry><term>-e</term> <listitem> <para> Dump empty records. These are normally excluded. </para> </listitem> </varlistentry> <varlistentry><term>-p</term> <listitem> <para> Dump with header information, similar to "ctdb catdb". </para> </listitem> </varlistentry> <varlistentry> <term> -s <group choice="req"> <arg choice="plain">0</arg> <arg choice="plain">32</arg> <arg choice="plain">64</arg> </group> </term> <listitem> <para> Specify how to determine the CTDB record header size for the input database: <variablelist spacing="normal"> <varlistentry><term>0</term> <listitem> <para>no CTDB header</para> </listitem> </varlistentry> <varlistentry><term>32</term> <listitem> <para>CTDB header size of a 32 bit system (20 bytes)</para> </listitem> </varlistentry> <varlistentry><term>64</term> <listitem> <para>CTDB header size of a 64 bit system (24 bytes)</para> </listitem> </varlistentry> </variablelist> The default is 32 or 64 depending on the system architecture. </para> </listitem> </varlistentry> <varlistentry> <term> -o <group choice="req"> <arg choice="plain">0</arg> <arg choice="plain">32</arg> <arg choice="plain">64</arg> </group> </term> <listitem> <para> Specify how to determine the CTDB record header size for the output database, see -s. </para> </listitem> </varlistentry> <varlistentry><term>-S <parameter>SIZE</parameter></term> <listitem> <para> Explicitly specify the CTDB record header SIZE of the input database in bytes. </para> </listitem> </varlistentry> <varlistentry><term>-O <parameter>SIZE</parameter></term> <listitem> <para> Explicitly specify the CTDB record header SIZE for the output database in bytes. </para> </listitem> </varlistentry> <varlistentry><term>-h</term> <listitem> <para> Print help text. </para> </listitem> </varlistentry> </variablelist> </refsect1> <refsect1> <title>COMMANDS</title> <variablelist> <varlistentry><term>help</term> <listitem> <para> Print help text. </para> </listitem> </varlistentry> <varlistentry><term>dump <parameter>IDB</parameter></term> <listitem> <para> Dump the contents of an LTDB input file IDB to standard output in a human-readable format. </para> </listitem> </varlistentry> <varlistentry> <term> convert <parameter>IDB</parameter> <parameter>ODB</parameter> </term> <listitem> <para> Copy an LTDB input file IDB to output file ODB, optionally adding or removing CTDB headers. </para> </listitem> </varlistentry> </variablelist> </refsect1> <refsect1> <title>EXAMPLES</title> <para> Print a local tdb in "tdbdump" style: </para> <screen format="linespecific"> ltdbtool dump idmap2.tdb.0 </screen> <para> Print a local tdb with header information similar to "ctdb catdb": </para> <screen format="linespecific"> ltdbtool dump -p idmap2.tdb.0 </screen> <para> Strip the CTDB headers from records: </para> <screen format="linespecific"> ltdbtool convert -o0 idmap2.tdb.0 idmap.tdb </screen> <para> Strip 64 bit CTDB headers from records, running on i386: </para> <screen format="linespecific"> ltdbtool convert -s64 -o0 idmap2.tdb.0 idmap.tdb </screen> <para> Strip the CTDB headers from records by piping through tdbrestore: </para> <screen format="linespecific"> ltdbtool dump idmap2.tdb.0 | tdbrestore idmap.tdb </screen> <para> Convert a local tdb from a 64 bit system for usage on a 32 bit system: </para> <screen format="linespecific"> ltdbtool convert -s64 -o32 idmap2.tdb.0 idmap2.tdb.1 </screen> <para> Add a default header: </para> <screen format="linespecific"> ltdbtool convert -s0 idmap.tdb idmap2.tdb.0 </screen> </refsect1> <refsect1><title>SEE ALSO</title> <para> <citerefentry><refentrytitle>ctdb</refentrytitle> <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>tdbdump</refentrytitle> <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>tdbrestore</refentrytitle> <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>ctdb</refentrytitle> <manvolnum>7</manvolnum></citerefentry>, <ulink url="http://ctdb.samba.org/"/> </para> </refsect1> <refentryinfo> <author> <contrib> This documentation was written by Gregor Beck </contrib> </author> <copyright> <year>2011</year> <holder>Gregor Beck</holder> <holder>Michael Adam</holder> </copyright> <legalnotice> <para> 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. </para> <para> 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. </para> <para> You should have received a copy of the GNU General Public License along with this program; if not, see <ulink url="http://www.gnu.org/licenses"/>. </para> </legalnotice> </refentryinfo> </refentry>