summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/printing/deleteprintercommand.xml
blob: 23f2ff76b0f92796ad40aedb209f0378d4b417b4 (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
35
<samba:parameter xmlns:samba="http://samba.org/common">
		<term><anchor id="DELETEPRINTERCOMMAND"/>deleteprinter command (G)</term>
		<listitem><para>With the introduction of MS-RPC based printer
		support for Windows NT/2000 clients in Samba 2.2, it is now 
		possible to delete printer at run time by issuing the 
		DeletePrinter() RPC call.</para>
		
		<para>For a Samba host this means that the printer must be 
		physically deleted from underlying printing system.  The <parameter moreinfo="none">
		deleteprinter command</parameter> defines a script to be run which 
		will perform the necessary operations for removing the printer
		from the print system and from <filename moreinfo="none">smb.conf</filename>.
		</para>
		
		<para>The <parameter moreinfo="none">deleteprinter command</parameter> is 
		automatically called with only one parameter: <parameter moreinfo="none">
		&quot;printer name&quot;</parameter>.</para>
		
				
		<para>Once the <parameter moreinfo="none">deleteprinter command</parameter> has 
		been executed, <command moreinfo="none">smbd</command> will reparse the <filename moreinfo="none">
		smb.conf</filename> to associated printer no longer exists.  
		If the sharename is still valid, then <command moreinfo="none">smbd
		</command> will return an ACCESS_DENIED error to the client.</para>
		
		<para>See also <link linkend="ADDPRINTERCOMMAND"><parameter moreinfo="none">
		addprinter command</parameter></link>, <link linkend="PRINTING"><parameter moreinfo="none">printing</parameter></link>,
		<link linkend="SHOWADDPRINTERWIZARD"><parameter moreinfo="none">show add
		printer wizard</parameter></link></para>
		
		<para>Default: <emphasis>none</emphasis></para>
		<para>Example: <command moreinfo="none">deleteprinter command = /usr/bin/removeprinter
		</command></para>
		</listitem>
		</samba:parameter>