r21564: Move ndrdump to librpc/tools.
authorJelmer Vernooij <jelmer@samba.org>
Tue, 27 Feb 2007 18:00:15 +0000 (18:00 +0000)
committerGerald (Jerry) Carter <jerry@samba.org>
Wed, 10 Oct 2007 19:48:57 +0000 (14:48 -0500)
source/librpc/config.mk
source/librpc/tools/ndrdump.1.xml [new file with mode: 0644]
source/librpc/tools/ndrdump.c [moved from source/utils/ndrdump.c with 99% similarity]
source/utils/config.mk

index 6f85d350e7638baf9a44d79d404260b445ca2391..ee20cc3321355ef90eb6db406650d5403a8be309 100644 (file)
@@ -16,6 +16,23 @@ PUBLIC_DEPENDENCIES = LIBSAMBA-ERRORS LIBTALLOC LIBSAMBA-UTIL CHARSET EXT_NSL \
 # End SUBSYSTEM LIBNDR
 ################################################
 
+#################################
+# Start BINARY ndrdump
+[BINARY::ndrdump]
+INSTALLDIR = BINDIR
+OBJ_FILES = \
+               tools/ndrdump.o
+PRIVATE_DEPENDENCIES = \
+               LIBSAMBA-CONFIG \
+               LIBSAMBA-UTIL \
+               LIBPOPT \
+               POPT_SAMBA \
+               NDR_TABLE
+MANPAGE = tools/ndrdump.1
+# FIXME: ndrdump shouldn't have to depend on RPC...
+# End BINARY ndrdump
+#################################
+
 ################################################
 # Start SUBSYSTEM NDR_COMPRESSION
 [LIBRARY::NDR_COMPRESSION]
diff --git a/source/librpc/tools/ndrdump.1.xml b/source/librpc/tools/ndrdump.1.xml
new file mode 100644 (file)
index 0000000..9d66102
--- /dev/null
@@ -0,0 +1,83 @@
+<?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="ndrdump.1">
+
+<refmeta>
+       <refentrytitle>ndrdump</refentrytitle>
+       <manvolnum>1</manvolnum>
+</refmeta>
+
+
+<refnamediv>
+       <refname>ndrdump</refname>
+       <refpurpose>DCE/RPC Packet Parser and Dumper</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+       <cmdsynopsis>
+               <command>ndrdump</command>
+               <arg choice="opt">-c context</arg>
+               <arg choice="req">pipe</arg>
+               <arg choice="req">function</arg>
+               <arg choice="req">in|out</arg>
+               <arg choice="req">filename</arg>
+       </cmdsynopsis>
+       <cmdsynopsis>
+               <command>ndrdump</command>
+               <arg choice="opt">pipe</arg>
+       </cmdsynopsis>
+       <cmdsynopsis>
+               <command>ndrdump</command>
+       </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1>
+       <title>DESCRIPTION</title>
+
+       <para>ndrdump tries to parse the specified <replaceable>filename</replaceable>
+               using Samba's parser for the specified pipe and function. The 
+               third argument should be 
+               either <emphasis>in</emphasis> or <emphasis>out</emphasis>, depending 
+               on whether the data should be parsed as a request or a reply.</para>
+
+       <para>Running ndrdump without arguments will list the pipes for which 
+               parsers are available.</para>
+
+       <para>Running ndrdump with one argument will list the functions that 
+               Samba can parse for the specified pipe.</para>
+
+       <para>The primary function of ndrdump is debugging Samba's internal 
+               DCE/RPC parsing functions. The file being parsed is usually 
+               one exported by wiresharks <quote>Export selected packet bytes</quote> 
+               function.</para>
+
+       <para>The context argument can be used to load context data from the request 
+               packet when parsing reply packets (such as array lengths).</para>
+
+</refsect1>
+
+<refsect1>
+       <title>VERSION</title>
+
+       <para>This man page is correct for version 4.0 of the Samba suite.</para>
+</refsect1>
+
+<refsect1>
+       <title>SEE ALSO</title>
+
+       <para>wireshark, pidl</para>
+
+</refsect1>
+
+<refsect1>
+       <title>AUTHOR</title>
+
+       <para>This utility is part of the <ulink url="http://www.samba.org/">Samba</ulink> suite, which is developed by the global <ulink url="http://www.samba.org/samba/team/">Samba Team</ulink>.</para>
+
+       <para>ndrdump was written by Andrew Tridgell. </para>
+
+       <para>This manpage was written by Jelmer Vernooij. </para>
+       
+</refsect1>
+
+</refentry>
similarity index 99%
rename from source/utils/ndrdump.c
rename to source/librpc/tools/ndrdump.c
index affdc60b4a55c02452db7a2e01d8699626ffed37..205d094fe7678800834ad6ec3262f3c70928a255 100644 (file)
@@ -2,6 +2,7 @@
    Unix SMB/CIFS implementation.
    SMB torture tester
    Copyright (C) Andrew Tridgell 2003
+   Copyright (C) Jelmer Vernooij 2006
    
    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
index 0e5b5e2990669abfb42f5ce7f96c8fe656183ed6..71c7647fd9a64759ab4bdcae05a072bb34b005c6 100644 (file)
@@ -1,22 +1,5 @@
 # utils subsystem
 
-#################################
-# Start BINARY ndrdump
-[BINARY::ndrdump]
-INSTALLDIR = BINDIR
-OBJ_FILES = \
-               ndrdump.o
-PRIVATE_DEPENDENCIES = \
-               LIBSAMBA-CONFIG \
-               LIBSAMBA-UTIL \
-               LIBPOPT \
-               POPT_SAMBA \
-               NDR_TABLE
-MANPAGE = man/ndrdump.1
-# FIXME: ndrdump shouldn't have to depend on RPC...
-# End BINARY ndrdump
-#################################
-
 #################################
 # Start BINARY ntlm_auth
 [BINARY::ntlm_auth]