docs-xml/smbdotconf/printing/deleteprintercommand.xml

   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>