← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/printing/forceprintername.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/forceprintername.xml
 
1
<samba:parameter name="force printername"
 
2
                 context="S"
 
3
                 type="boolean"
 
4
                 print="1"
 
5
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 
6
<description>
 
7
    <para>When printing from Windows NT (or later), 
 
8
    each printer in <filename>smb.conf</filename> has two 
 
9
    associated names which can be used by the client.  The first
 
10
    is the sharename (or shortname) defined in smb.conf.  This
 
11
    is the only printername available for use by Windows 9x clients.
 
12
    The second name associated with a printer can be seen when 
 
13
    browsing to the "Printers" (or "Printers and Faxes") folder 
 
14
    on the Samba server.  This is referred to simply as the printername
 
15
    (not to be confused with the <parameter>printer name</parameter> option).
 
16
    </para>
 
17
 
 
18
    <para>When assigning a new driver to a printer on a remote 
 
19
    Windows compatible print server such as Samba, the Windows client
 
20
    will rename the printer to match the driver name just uploaded.
 
21
    This can result in confusion for users when multiple 
 
22
    printers are bound to the same driver.  To prevent Samba from
 
23
    allowing the printer's printername to differ from the sharename
 
24
    defined in smb.conf, set <parameter>force printername = yes</parameter>.
 
25
    </para>
 
26
 
 
27
    <para>Be aware that enabling this parameter may affect migrating
 
28
    printers from a Windows server to Samba since Windows has no way to 
 
29
    force the sharename and printername to match.</para>
 
30
 
 
31
    <para>It is recommended that this parameter's value not be changed
 
32
    once the printer is in use by clients as this could cause a user
 
33
    not be able to delete printer connections from their local Printers 
 
34
    folder.</para>
 
35
 
 
36
</description>
 
37
 
 
38
<value type="default">no</value>
 
39
</samba:parameter>