docs/docbook/smbdotconf/printing/deleteprintercommand.xml

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