| 1 | <samba:parameter name="deleteprinter command"
 | 
|---|
| 2 |                  context="G"
 | 
|---|
| 3 |                                  type="string"
 | 
|---|
| 4 |                  advanced="1" developer="1"
 | 
|---|
| 5 |                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 | 
|---|
| 6 | <description>
 | 
|---|
| 7 |     <para>With the introduction of MS-RPC based printer
 | 
|---|
| 8 |     support for Windows NT/2000 clients in Samba 2.2, it is now 
 | 
|---|
| 9 |     possible to delete a printer at run time by issuing the
 | 
|---|
| 10 |     DeletePrinter() RPC call.</para>
 | 
|---|
| 11 |                 
 | 
|---|
| 12 |     <para>For a Samba host this means that the printer must be 
 | 
|---|
| 13 |     physically deleted from the underlying printing system.  The
 | 
|---|
| 14 |     <smbconfoption name="deleteprinter command"/> defines a script to be run which 
 | 
|---|
| 15 |     will perform the necessary operations for removing the printer
 | 
|---|
| 16 |     from the print system and from <filename moreinfo="none">smb.conf</filename>.
 | 
|---|
| 17 |     </para>
 | 
|---|
| 18 |                 
 | 
|---|
| 19 |     <para>The <smbconfoption name="deleteprinter command"/> is 
 | 
|---|
| 20 |     automatically called with only one parameter: <smbconfoption name="printer name"/>.
 | 
|---|
| 21 |         </para>
 | 
|---|
| 22 |                 
 | 
|---|
| 23 |     <para>Once the <smbconfoption name="deleteprinter command"/> has 
 | 
|---|
| 24 |     been executed, <command moreinfo="none">smbd</command> will reparse the <filename moreinfo="none">
 | 
|---|
| 25 |     smb.conf</filename> to check that the associated printer no longer exists.
 | 
|---|
| 26 |     If the sharename is still valid, then <command moreinfo="none">smbd
 | 
|---|
| 27 |     </command> will return an ACCESS_DENIED error to the client.</para>
 | 
|---|
| 28 | </description>
 | 
|---|
| 29 | 
 | 
|---|
| 30 | <related>addprinter command</related>
 | 
|---|
| 31 | <related>printing</related>
 | 
|---|
| 32 | <related>show add printer wizard</related>
 | 
|---|
| 33 | 
 | 
|---|
| 34 | <value type="default"></value>
 | 
|---|
| 35 | <value type="example">/usr/bin/removeprinter</value>
 | 
|---|
| 36 | </samba:parameter>
 | 
|---|