summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/printing/defaultdevmode.xml
blob: 9609038dcd9ff84ec26ae56879bb599131342f69 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
<samba:parameter xmlns:samba="http://samba.org/common">
		<term><anchor id="DEFAULTDEVMODE"/>default devmode (S)</term>
		<listitem><para>This parameter is only applicable to <link linkend="PRINTOK">printable</link> services.  When smbd is serving
		Printer Drivers to Windows NT/2k/XP clients, each printer on the Samba
		server has a Device Mode which defines things such as paper size and
		orientation and duplex settings.  The device mode can only correctly be
		generated by the printer driver itself (which can only be executed on a
		Win32 platform).  Because smbd is unable to execute the driver code
		to generate the device mode, the default behavior is to set this field
		to NULL.
		</para>

		<para>Most problems with serving printer drivers to Windows NT/2k/XP clients
		can be traced to a problem with the generated device mode.  Certain drivers
		will do things such as crashing the client's Explorer.exe with a NULL devmode.
		However, other printer drivers can cause the client's spooler service
		(spoolsv.exe) to die if the devmode was not created by the driver itself
		(i.e. smbd generates a default devmode).
		</para>

		<para>This parameter should be used with care and tested with the printer
		driver in question.  It is better to leave the device mode to NULL
		and let the Windows client set the correct values.  Because drivers do not
		do this all the time, setting <command moreinfo="none">default devmode = yes</command>
		will instruct smbd to generate a default one.
		</para>

		<para>For more information on Windows NT/2k printing and Device Modes,
		see the <ulink url="http://msdn.microsoft.com/">MSDN documentation</ulink>.
		</para>

		<para>Default: <command moreinfo="none">default devmode = no</command></para>
		</listitem>
		</samba:parameter>