summaryrefslogtreecommitdiff
path: root/testprogs
diff options
context:
space:
mode:
authorGünther Deschner <gd@samba.org>2010-05-10 11:06:03 +0200
committerGünther Deschner <gd@samba.org>2010-05-10 11:50:28 +0200
commitcda0c75e18f78022b94cb2c13f83342e0db7a8bc (patch)
tree148b45ce21b059976eabab62396e649a1958b028 /testprogs
parente94825d159db49da0bc7e6e68014ce0afbbfb167 (diff)
downloadsamba-cda0c75e18f78022b94cb2c13f83342e0db7a8bc.tar.gz
samba-cda0c75e18f78022b94cb2c13f83342e0db7a8bc.tar.bz2
samba-cda0c75e18f78022b94cb2c13f83342e0db7a8bc.zip
testprogs: add readme for testspoolss.exe.
Patch from Kurt Pfeifle <Kurt.Pfeifle@ricoh.de>. Guenther
Diffstat (limited to 'testprogs')
-rw-r--r--testprogs/win32/spoolss/README1
-rw-r--r--testprogs/win32/spoolss/README.win3265
2 files changed, 65 insertions, 1 deletions
diff --git a/testprogs/win32/spoolss/README b/testprogs/win32/spoolss/README
deleted file mode 100644
index 9d6cf4b7fb..0000000000
--- a/testprogs/win32/spoolss/README
+++ /dev/null
@@ -1 +0,0 @@
-FIXME
diff --git a/testprogs/win32/spoolss/README.win32 b/testprogs/win32/spoolss/README.win32
new file mode 100644
index 0000000000..1388316ddc
--- /dev/null
+++ b/testprogs/win32/spoolss/README.win32
@@ -0,0 +1,65 @@
+
+This directory holds sources for a Win32 test utility to test the "spoolss"
+(print spool subsystem) functions of either a Windows or a Samba server. The
+sources are known to build with (free as in beer) Microsoft Visual C++ 2008
+Express Edition's "nmake.exe" on Windows XP Professional.
+
+
+How to build
+------------
+
+Use the Microsoft "nmake" command to build the *.exe. This command is in your
+%path% if you start the "Visual Studio 2008 Command Prompt" from your Start
+menu.
+
+Currently the real build target is (misleadingly) named "spoolss.exe". Run
+
+ nmake /f Makefile
+
+to build the spoolss.exe. After a successfull build you may want to clean up
+temporary files:
+
+ nmake /f Makefile cleantmp
+
+
+How to use
+----------
+
+Running spoolss.exe with no additional params displays a short usage info.
+
+..............................................................................
+usage: spoolss.exe <name> [print] [samba3] [architecture=ARCHITECTURE]
+
+ <name> can be a server or printer name URI
+ [print] will print all data that has been retrieved
+ from the printserver
+ [samba3] will skip some tests samba servers are known
+ not to have implemented
+ [architecture=X] allows to define a specific
+ architecture to test with. choose between:
+ "Windows NT x86" or "Windows x64"
+..............................................................................
+
+The utility may be most useful if you use the "print" parameter to output all
+data received from the print server. You may re-direct the data into log files
+for later evaluation like this:
+
+ spoolss.exe \\smbserver print samba3 1>smbserver.log 2>smbserver.err
+ spoolss.exe \\smbserver print 1>smbserver.log 2>smbserver.err
+ spoolss.exe \\winserver print 1>winserver.log 2>winserver.err
+
+One interesting source of learning could be to compare the output for (maybe
+"the same") printers/drivers as installed on a Windows and on a Samba print
+server:
+
+ spoolss.exe \\winserver\printername print 1>winprinter.log 2>winprinter.err
+ spoolss.exe \\smbserver\printername print 1>smbprinter.log 2>smbprinter.err
+
+and then compare the respective log files with a diff utility of your choice.
+To install "the same" printer/driver on a Samba server as on a Windows server,
+you can use the Samba "net" utility, which has the following syntax:
+
+ net rpc printer MIGRATE PRINTERS printername \
+ --server=winserver \
+ --destination=smbserver \
+ -UAdministrator%secretpassword