summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGerald Carter <jerry@samba.org>2004-10-26 18:54:49 +0000
committerGerald W. Carter <jerry@samba.org>2008-04-23 08:46:05 -0500
commita20e7874faa05ef64de0526ce33af75ea338d6b3 (patch)
treedcea8efaecc03ebfd199e5339b72a47ac16e5a6d
parent8e589c2df76806d3adfd4bba41bc0eeadc90b639 (diff)
downloadsamba-a20e7874faa05ef64de0526ce33af75ea338d6b3.tar.gz
samba-a20e7874faa05ef64de0526ce33af75ea338d6b3.tar.bz2
samba-a20e7874faa05ef64de0526ce33af75ea338d6b3.zip
adding docs for force printername
(This used to be commit e6a366606e4cf37798867fe0576108ac9e8098c5)
-rw-r--r--docs/smbdotconf/printing/forceprintername.xml39
1 files changed, 39 insertions, 0 deletions
diff --git a/docs/smbdotconf/printing/forceprintername.xml b/docs/smbdotconf/printing/forceprintername.xml
new file mode 100644
index 0000000000..7f89a89589
--- /dev/null
+++ b/docs/smbdotconf/printing/forceprintername.xml
@@ -0,0 +1,39 @@
+<samba:parameter name="force printername"
+ context="S"
+ type="boolean"
+ print="1"
+ xmlns:samba="http://samba.org/common">
+<description>
+ <para>When printing from Windows NT (or later),
+ each printer in <filename>smb.conf</filename> has two
+ associated names which can be used by the client. The first
+ is the sharename (or shortname) defined in smb.conf. This
+ is the only printername available for use by Windows 9x clients.
+ The second name associated with a printer can be seen when
+ browsing to the "Printers" (or "Printers and Faxes") folder
+ on the Samba server. This is referred to simply as the printername
+ (not to be confused with the <parameter>printer name</parameter> option).
+ </para>
+
+ <para>When assigning a new driver to a printer on a remote
+ Windows compatible print server such as Samba, the Windows client
+ will rename the printer to match the driver name just uploaded.
+ This can result in confusion for users when multiple
+ printers are bound to the same driver. To prevent Samba from
+ allowing the printer's printername to differ from the sharename
+ defined in smb.conf, set <parameter>force printername = yes</parameter>.
+ </para>
+
+ <para>Be aware that enabling this parameter may affect migrating
+ printers from a Windows server to Samba since Windows has no way to
+ force the sharename and printername to match.</para>
+
+ <para>It is recommended that this parameter's value not be changed
+ once the printer is in use by clients as this could cause a user
+ not be able to delete printer connections from their local Printers
+ folder.</para>
+
+</description>
+
+<value type="default">no</value>
+</samba:parameter>