docs/docbook/smbdotconf/printing/deleteprintercommand.xml

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