← Back to branch summary

~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/printing/deleteprintercommand.xml

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

Lines of Context:
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>