From 1bb8faa31c28bb495e9f60e42a104ab9bb64c951 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B6rn=20Baumbach?= Date: Mon, 15 Oct 2012 17:17:29 +0200 Subject: [PATCH 1/7] docs-xml: add dbwrap_tool.1 manual page (fix bug #9568 [1/2]) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Björn Baumbach Reviewed-by: Michael Adam Reviewed-by: Volker Lendecke (cherry picked from commit 8d6104f02d9ab879efe7867fec53cbe5cc408ded) --- docs-xml/manpages/dbwrap_tool.1.xml | 160 ++++++++++++++++++++++++++++++++++++ 1 file changed, 160 insertions(+) create mode 100644 docs-xml/manpages/dbwrap_tool.1.xml diff --git a/docs-xml/manpages/dbwrap_tool.1.xml b/docs-xml/manpages/dbwrap_tool.1.xml new file mode 100644 index 0000000..5a682b8 --- /dev/null +++ b/docs-xml/manpages/dbwrap_tool.1.xml @@ -0,0 +1,160 @@ + + + + + + dbwrap_tool + 1 + Samba + System Administration tools + 4.0 + + + + + dbwrap_tool + low level TDB/CTDB manipulation tool using the dbwrap interface + + + + + dbwrap_tool + <database> + <operation> + <key> + <type> + <value> + + + + + + + DESCRIPTION + + This tool is part of the samba + 7 suite. + + The dbwrap_tool program is used to read and manipulate + TDB/CTDB databases using the dbwrap interface. + + The following database operations are available: + + fetch: fetch a record + store: create or modify a record + delete: remove a record + erase: remove all records + listkeys: list all available records + listwatchers: list processes, which are waiting for changes in a record + + + The following types are available: + + int32: signed 32bit integer + uint32: unsigned 32bit integer + string: "hello world" + hex: hex strings like "68656C6C6F20776F726C6400" ("hello world") + + + + + + OPTIONS + + None. + + + + + COMMANDS + + fetch + + dbwrap_tool <database> fetch <key> <type> + + + + store + + dbwrap_tool <database> store <key> <type> <value> + + + + delete + + dbwrap_tool <database> delete <key> + + + + erase + + dbwrap_tool <database> erase + + + listkeys + + dbwrap_tool <database> listkeys + + + + listwatchers + + dbwrap_tool <database> listwatchers + + + + + + EXAMPLES + + List all keys from winbindd_idmap.tdb + dbwrap_tool winbindd_idmap.tdb listkeys + + Fetch record with key "USER HWM" as uint32 + dbwrap_tool winbindd_idmap.tdb fetch "USER HWM" uint32 + + Remove record with key "USER HWM" + dbwrap_tool winbindd_idmap.tdb remove "USER HWM" + + Store and overwrite record "USER HWM" with value 214 + uint32: dbwrap_tool winbindd_idmap.tdb store "USER HWM" uint32 214 + hex: dbwrap_tool winbindd_idmap.tdb store "USER HWM" hex D6000000 + + + + + + NOTES + + Use with caution! + + + + + VERSION + + This man page is correct for version 3 of the Samba suite. + + + + SEE ALSO + smbd + 8, samba + 7 + + + + AUTHOR + + 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. + + The dbwrap_tool manpage was written by Bjoern Baumbach. + + + -- 1.7.12.4 From 254d2aa6ad242611eeef90223d6f93769778049f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B6rn=20Baumbach?= Date: Mon, 15 Oct 2012 17:20:07 +0200 Subject: [PATCH 2/7] build(waf): docs-xml: build new dbwrap_tool.8 manual page (fix bug #9568 [2/2]) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Björn Baumbach Reviewed-by: Michael Adam Reviewed-by: Volker Lendecke (cherry picked from commit b7a091ecf48963e2a0d1757d0faf131ad8d940fa) --- docs-xml/wscript_build | 1 + 1 file changed, 1 insertion(+) diff --git a/docs-xml/wscript_build b/docs-xml/wscript_build index 8a5f3a4..25e381e 100644 --- a/docs-xml/wscript_build +++ b/docs-xml/wscript_build @@ -1,6 +1,7 @@ #!/usr/bin/env python from samba_utils import save_file manpages=''' + manpages/dbwrap_tool.1 manpages/eventlogadm.8 manpages/findsmb.1 manpages/libsmbclient.7 -- 1.7.12.4 From 044181dc218b29a83d1b4448503126ee077e0d5f Mon Sep 17 00:00:00 2001 From: Michael Adam Date: Mon, 14 Jan 2013 17:05:05 +0100 Subject: [PATCH 3/7] docs: add an entity stdarg.option for the "--option" command line parameter Related to bug #9568. Signed-off-by: Michael Adam Reviewed-by: Volker Lendecke (cherry picked from commit c9b95eb205abbdb77960eb0419937512358f7e64) --- docs-xml/build/DTD/samba.entities | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs-xml/build/DTD/samba.entities b/docs-xml/build/DTD/samba.entities index c7e46c2..628dfa7 100644 --- a/docs-xml/build/DTD/samba.entities +++ b/docs-xml/build/DTD/samba.entities @@ -241,6 +241,18 @@ log.smbd, etc...). The log file is never removed by the client. '> + +--option=<name>=<value> +Set the +smb.conf +5 +option "<name>" to value "<value>" from the command line. +This overrides compiled-in defaults and options read from the configuration +file. + +'> + Date: Mon, 14 Jan 2013 17:06:03 +0100 Subject: [PATCH 4/7] docs: use the stdarg.option entity in the popt.common.samba entity Related to bug #9568. Signed-off-by: Michael Adam Reviewed-by: Volker Lendecke (cherry picked from commit e3db3db784085bb2fedbf3063154b7cd77630e59) --- docs-xml/build/DTD/samba.entities | 1 + 1 file changed, 1 insertion(+) diff --git a/docs-xml/build/DTD/samba.entities b/docs-xml/build/DTD/samba.entities index 628dfa7..2653f41 100644 --- a/docs-xml/build/DTD/samba.entities +++ b/docs-xml/build/DTD/samba.entities @@ -257,6 +257,7 @@ file. &stdarg.version; &stdarg.configfile; &stdarg.log-basename; +&stdarg.option; '> Date: Mon, 14 Jan 2013 17:12:51 +0100 Subject: [PATCH 5/7] docs: fix the stdarg.configfile entity to print a "=" sign after the long option This makes the appearance equal to the other options like --debuglevel or --log-basename. Related to bug #9568. Signed-off-by: Michael Adam Reviewed-by: Volker Lendecke (cherry picked from commit 2ab3a96d262f60d26a8cd16dded3296889ab7f3f) --- docs-xml/build/DTD/samba.entities | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-xml/build/DTD/samba.entities b/docs-xml/build/DTD/samba.entities index 2653f41..32bd097 100644 --- a/docs-xml/build/DTD/samba.entities +++ b/docs-xml/build/DTD/samba.entities @@ -214,7 +214,7 @@ in the &smb.conf; file. --s|--configfile <configuration file> +-s|--configfile=<configuration file> The file specified contains the configuration details required by the server. The information in this file includes server-specific -- 1.7.12.4 From fbeec0d5fdf17f4f689a1f3194cff2d901b94aea Mon Sep 17 00:00:00 2001 From: Michael Adam Date: Mon, 14 Jan 2013 17:08:30 +0100 Subject: [PATCH 6/7] docs: add popt.common.samba.server and popt.common.samba.client entities These are comprised by the popt.common.samba entity and the stdarg.server.debug or the stdarg.client.debut entity, respectively. The difference is only in the default value of the debug level setting. Related to bug #9568. Signed-off-by: Michael Adam Reviewed-by: Volker Lendecke (cherry picked from commit 2d30e5deaf731839402b47751683d2c0e32d2bc7) --- docs-xml/build/DTD/samba.entities | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs-xml/build/DTD/samba.entities b/docs-xml/build/DTD/samba.entities index 32bd097..c9c6744 100644 --- a/docs-xml/build/DTD/samba.entities +++ b/docs-xml/build/DTD/samba.entities @@ -260,6 +260,17 @@ file. &stdarg.option; '> + + + + + -R|--name-resolve <name resolve order> -- 1.7.12.4 From 97f82d5fd7947ce1a3b675c88ec49869923d373d Mon Sep 17 00:00:00 2001 From: Michael Adam Date: Mon, 14 Jan 2013 17:15:08 +0100 Subject: [PATCH 7/7] docs: document the command line options in dbwrap_tool(1) Related to bug #9568. Signed-off-by: Michael Adam Reviewed-by: Volker Lendecke (cherry picked from commit d67911bafc0d098e67c8ad8d9b4bc49f184ff832) --- docs-xml/manpages/dbwrap_tool.1.xml | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs-xml/manpages/dbwrap_tool.1.xml b/docs-xml/manpages/dbwrap_tool.1.xml index 5a682b8..f4a6388 100644 --- a/docs-xml/manpages/dbwrap_tool.1.xml +++ b/docs-xml/manpages/dbwrap_tool.1.xml @@ -19,6 +19,11 @@ dbwrap_tool + -d <debug level> + -s <config file> + -l <log file base> + -V + --option=<name>=<value> <database> <operation> <key> @@ -61,11 +66,10 @@ OPTIONS - None. - -- 1.7.12.4