summaryrefslogtreecommitdiffstats
path: root/docs-xml/smbdotconf/printing/cupsoptions.xml
blob: 833ba30a0d31c396572d97906610c89ee43ec373 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
<samba:parameter name="cups options"
                 context="S"
                 type="string"
                 substitution="1"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
    <para>
    This parameter is only applicable if <smbconfoption name="printing"/> is 
    set to <constant>cups</constant>.  Its value is a free form string of options
    passed directly to the cups library.  
    </para>

   <para>
   You can pass any generic print option known to CUPS (as listed
   in the CUPS "Software Users' Manual").  You can also pass any printer
   specific option (as listed in "lpoptions -d printername -l")
   valid for the target queue.
   Multiple parameters should be space-delimited name/value pairs according to
   the PAPI text option ABNF specification. Collection values
   ("name={a=... b=... c=...}") are stored with the curley brackets intact.
   </para>

   <para>
   You should set this parameter to <constant>raw</constant> if your CUPS server 
   <filename>error_log</filename> file contains messages such as
   "Unsupported format 'application/octet-stream'" when printing from a Windows client 
   through Samba.  It is no longer necessary to enable
   system wide raw printing in <filename>/etc/cups/mime.{convs,types}</filename>.
   </para>

</description>

<value type="default">""</value>
<value type="example">"raw media=a4"</value>
</samba:parameter>