← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/printing/defaultdevmode.xml

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs-xml/smbdotconf/printing/defaultdevmode.xml
 
1
<samba:parameter name="default devmode"
 
2
                 context="S"
 
3
                                 type="boolean"
 
4
                 print="1"
 
5
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 
6
<description>
 
7
    <para>This parameter is only applicable to <smbconfoption name="printable"/> services.
 
8
    When smbd is serving Printer Drivers to Windows NT/2k/XP clients, each printer on the Samba
 
9
    server has a Device Mode which defines things such as paper size and
 
10
    orientation and duplex settings.  The device mode can only correctly be
 
11
    generated by the printer driver itself (which can only be executed on a
 
12
    Win32 platform).  Because smbd is unable to execute the driver code
 
13
    to generate the device mode, the default behavior is to set this field
 
14
    to NULL.
 
15
    </para>
 
16
 
 
17
    <para>Most problems with serving printer drivers to Windows NT/2k/XP clients
 
18
    can be traced to a problem with the generated device mode.  Certain drivers
 
19
    will do things such as crashing the client's Explorer.exe with a NULL devmode.
 
20
    However, other printer drivers can cause the client's spooler service
 
21
    (spoolsv.exe) to die if the devmode was not created by the driver itself
 
22
    (i.e. smbd generates a default devmode).
 
23
    </para>
 
24
 
 
25
    <para>This parameter should be used with care and tested with the printer
 
26
    driver in question.  It is better to leave the device mode to NULL
 
27
    and let the Windows client set the correct values.  Because drivers do not
 
28
    do this all the time, setting <command moreinfo="none">default devmode = yes</command>
 
29
    will instruct smbd to generate a default one.
 
30
    </para>
 
31
 
 
32
    <para>For more information on Windows NT/2k printing and Device Modes,
 
33
    see the <ulink url="http://msdn.microsoft.com/">MSDN documentation</ulink>.
 
34
</para>
 
35
</description>
 
36
 
 
37
<value type="default">yes</value>
 
38
</samba:parameter>