From cda0c75e18f78022b94cb2c13f83342e0db7a8bc Mon Sep 17 00:00:00 2001 From: Günther Deschner Date: Mon, 10 May 2010 11:06:03 +0200 Subject: testprogs: add readme for testspoolss.exe. Patch from Kurt Pfeifle . Guenther --- testprogs/win32/spoolss/README | 1 - testprogs/win32/spoolss/README.win32 | 65 ++++++++++++++++++++++++++++++++++++ 2 files changed, 65 insertions(+), 1 deletion(-) delete mode 100644 testprogs/win32/spoolss/README create mode 100644 testprogs/win32/spoolss/README.win32 (limited to 'testprogs/win32') 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 [print] [samba3] [architecture=ARCHITECTURE] + + 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 -- cgit