mirror of
https://github.com/samba-team/samba.git
synced 2024-12-23 17:34:34 +03:00
6315432f87
This includes new manpages for ctdb.7, ctdb.conf.5 and ctdb-tunables.7. Signed-off-by: Martin Schwenke <martin@meltin.net> Pair-programmed-with: Amitay Isaacs <amitay@gmail.com> (This used to be ctdb commit 15b5c6c00c248bc1a8364a6da103296a55d7bfb6)
301 lines
7.5 KiB
XML
301 lines
7.5 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!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>
|