eb5925f740f2b70ed4061ad1998fcec0165ef986
[metze/samba/wip.git] / docs-xml / smbdotconf / printing / printing.xml
1 <samba:parameter name="printing"
2                  context="S"
3                                  type="enum"
4                  print="1"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7     <para>This parameters controls how printer status  information is
8     interpreted on your system. It also affects the  default values for
9     the <parameter moreinfo="none">print command</parameter>,  <parameter
10     moreinfo="none">lpq command</parameter>, <parameter
11     moreinfo="none">lppause command </parameter>, <parameter
12     moreinfo="none">lpresume command</parameter>, and  <parameter
13     moreinfo="none">lprm command</parameter> if specified in the 
14     [global] section.</para>
15
16     <para>Currently nine printing styles are supported. They are
17     <constant>BSD</constant>, <constant>AIX</constant>, 
18     <constant>LPRNG</constant>, <constant>PLP</constant>,
19     <constant>SYSV</constant>, <constant>HPUX</constant>,
20     <constant>QNX</constant>, <constant>SOFTQ</constant>,
21     <constant>CUPS</constant> and <constant>IPRINT</constant>.</para>
22
23     <para>Be aware that CUPS and IPRINT are only available if the CUPS
24     development library was available at the time Samba was compiled
25     or packaged.</para>
26
27     <para>To see what the defaults are for the other print 
28     commands when using the various options use the <citerefentry><refentrytitle>testparm</refentrytitle>
29     <manvolnum>1</manvolnum></citerefentry> program.</para>
30
31     <para>This option can be set on a per printer basis.  Please be 
32     aware however, that you must place any of the various printing 
33     commands (e.g. print command, lpq command, etc...) after defining
34     the value for the <parameter>printing</parameter> option since it will 
35     reset the printing commands to default values.</para>
36
37     <para>See also the discussion in the <link linkend="PRINTERSSECT">
38     [printers]</link> section.</para>
39 </description>
40 <value type="default">Depends on the operating system, see
41 <command moreinfo="none">testparm -v.</command></value>
42 </samba:parameter>