Attachment 8446 Details for Bug 9568 – proposed patch for 3.6, partially cherry-picked from master

[patch] proposed patch for 3.6, partially cherry-picked from master

add-dbwrap_tool.1-fix-bug-9568_in_3.6.patch (text/plain), 5.43 KB, created by Björn Baumbach on 2013-01-18 11:03:35 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Björn Baumbach

Created: 2013-01-18 11:03:35 UTC

Size: 5.43 KB

patch

obsolete

>From 8deed3069d1b33bbed285fd7fdb83c90a38b4d1a Mon Sep 17 00:00:00 2001
>From: =?UTF-8?q?Bj=C3=B6rn=20Baumbach?= <bb@sernet.de>
>Date: Mon, 15 Oct 2012 17:17:29 +0200
>Subject: [PATCH] docs-xml: add dbwrap_tool.1 manual page (fix bug #9568)
>MIME-Version: 1.0
>Content-Type: text/plain; charset=UTF-8
>Content-Transfer-Encoding: 8bit
>
>Based on commit 8d6104f02d9ab879efe7867fec53cbe5cc408ded.
>
>Signed-off-by: BjÃ¶rn Baumbach <bb@sernet.de>
>Reviewed-by: Michael Adam <obnox@samba.org>
>Reviewed-by: Volker Lendecke <vl@samba.org>
>---
> docs-xml/manpages-3/dbwrap_tool.1.xml | 148 ++++++++++++++++++++++++++++++++++
> 1 file changed, 148 insertions(+)
> create mode 100644 docs-xml/manpages-3/dbwrap_tool.1.xml
>
>diff --git a/docs-xml/manpages-3/dbwrap_tool.1.xml b/docs-xml/manpages-3/dbwrap_tool.1.xml
>new file mode 100644
>index 0000000..2a20701
>--- /dev/null
>+++ b/docs-xml/manpages-3/dbwrap_tool.1.xml
>@@ -0,0 +1,148 @@
>+<?xml version="1.0" encoding="iso-8859-1"?>
>+<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
>+<refentry id="dbwrap_tool.1">
>+
>+<refmeta>
>+	<refentrytitle>dbwrap_tool</refentrytitle>
>+	<manvolnum>1</manvolnum>
>+	<refmiscinfo class="source">Samba</refmiscinfo>
>+	<refmiscinfo class="manual">System Administration tools</refmiscinfo>
>+	<refmiscinfo class="version">3.6</refmiscinfo>
>+</refmeta>
>+
>+
>+<refnamediv>
>+	<refname>dbwrap_tool</refname>
>+	<refpurpose>low level TDB/CTDB manipulation tool using the dbwrap interface</refpurpose>
>+</refnamediv>
>+
>+<refsynopsisdiv>
>+	<cmdsynopsis>
>+		<command>dbwrap_tool</command>
>+		<arg choice="req">&lt;database&gt;</arg>
>+		<arg choice="req">&lt;operation&gt;</arg>
>+		<arg choice="opt">&lt;key&gt;
>+			<arg choice="opt">&lt;type&gt;
>+				<arg choice="opt">&lt;value&gt;</arg>
>+			</arg>
>+		</arg>
>+	</cmdsynopsis>
>+</refsynopsisdiv>
>+
>+<refsect1>
>+	<title>DESCRIPTION</title>
>+
>+	<para>This tool is part of the <citerefentry><refentrytitle>samba</refentrytitle>
>+	<manvolnum>7</manvolnum></citerefentry> suite.</para>
>+
>+	<para>The dbwrap_tool program is used to read and manipulate
>+	TDB/CTDB databases using the dbwrap interface.</para>
>+
>+	<para>The following database operations are available:
>+	<itemizedlist>
>+		<listitem><para>fetch: fetch a record</para></listitem>
>+		<listitem><para>store: create or modify a record</para></listitem>
>+		<listitem><para>delete: remove a record</para></listitem>
>+		<listitem><para>erase: remove all records</para></listitem>
>+		<listitem><para>listkeys: list all available records</para></listitem>
>+	</itemizedlist>
>+	</para>
>+	<para>The following types are available:
>+	<itemizedlist>
>+		<listitem><para>int32: signed 32bit integer</para></listitem>
>+		<listitem><para>uint32: unsigned 32bit integer</para></listitem>
>+		<listitem><para>string: "hello world"</para></listitem>
>+	</itemizedlist>
>+	</para>
>+</refsect1>
>+
>+<refsect1>
>+	<title>OPTIONS</title>
>+
>+	<para>None.</para>
>+</refsect1>
>+
>+<refsect1>
>+	<title>COMMANDS</title>
>+	<refsect2>
>+		<title>fetch</title>
>+		<cmdsynopsis>
>+			<command>dbwrap_tool</command> &lt;database&gt; fetch &lt;key&gt; &lt;type&gt;
>+		</cmdsynopsis>
>+	</refsect2>
>+	<refsect2>
>+		<title>store</title>
>+		<cmdsynopsis>
>+			<command>dbwrap_tool</command> &lt;database&gt; store &lt;key&gt; &lt;type&gt; &lt;value&gt;
>+		</cmdsynopsis>
>+	</refsect2>
>+	<refsect2>
>+		<title>delete</title>
>+		<cmdsynopsis>
>+			<command>dbwrap_tool</command> &lt;database&gt; delete &lt;key&gt;
>+		</cmdsynopsis>
>+	</refsect2>
>+	<refsect2>
>+		<title>erase</title>
>+		<cmdsynopsis>
>+			<command>dbwrap_tool</command> &lt;database&gt; erase
>+		</cmdsynopsis>
>+	</refsect2>
>+	<refsect2>
>+		<title>listkeys</title>
>+		<cmdsynopsis>
>+			<command>dbwrap_tool</command> &lt;database&gt; listkeys
>+		</cmdsynopsis>
>+	</refsect2>
>+</refsect1>
>+
>+<refsect1>
>+	<title>EXAMPLES</title>
>+	<variablelist>
>+		<varlistentry><term>List all keys from winbindd_idmap.tdb</term>
>+			<listitem><para><command>dbwrap_tool</command> winbindd_idmap.tdb listkeys</para></listitem>
>+		</varlistentry>
>+		<varlistentry><term>Fetch record with key "USER HWM" as uint32</term>
>+			<listitem><para><command>dbwrap_tool</command> winbindd_idmap.tdb fetch "USER HWM" uint32</para></listitem>
>+		</varlistentry>
>+		<varlistentry><term>Remove record with key "USER HWM"</term>
>+			<listitem><para><command>dbwrap_tool</command> winbindd_idmap.tdb remove "USER HWM"</para></listitem>
>+		</varlistentry>
>+		<varlistentry><term>Store and overwrite record "USER HWM" with value 214</term>
>+			<listitem><para><command>dbwrap_tool</command> winbindd_idmap.tdb store "USER HWM" uint32 214</para></listitem>
>+		</varlistentry>
>+	</variablelist>
>+</refsect1>
>+
>+<refsect1>
>+	<title>NOTES</title>
>+
>+	<para>Use with caution!</para>
>+</refsect1>
>+
>+
>+<refsect1>
>+	<title>VERSION</title>
>+
>+	<para>This man page is correct for version 3 of the Samba suite.</para>
>+</refsect1>
>+
>+<refsect1>
>+	<title>SEE ALSO</title>
>+	<para><citerefentry><refentrytitle>smbd</refentrytitle>
>+	<manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>samba</refentrytitle>
>+	<manvolnum>7</manvolnum></citerefentry></para>
>+</refsect1>
>+
>+<refsect1>
>+	<title>AUTHOR</title>
>+
>+	<para>The original Samba software and related utilities
>+	were created by Andrew Tridgell. Samba is now developed
>+	by the Samba Team as an Open Source project similar
>+	to the way the Linux kernel is developed.</para>
>+
>+	<para>The dbwrap_tool manpage was written by Bjoern Baumbach.</para>
>+</refsect1>
>+
>+</refentry>
>-- 
>1.7.12.4
>

Flags:

vl: review+
metze: review+

Actions: View

Attachments on bug 9568: 8441 | 8446