Updated entry of samba-vscan
[Samba.git] / docs / smbdotconf / printing / cupsoptions.xml
blob970281d98c40bac83fcc7bd51a498fa1571a1e4b
1 <samba:parameter name="cups options"
2                  context="S"
3                  type="string"
4                  print="1"
5                  xmlns:samba="http://samba.org/common">
6 <description>
7     <para>This parameter is only applicable if <link 
8     linkend="PRINTING"><parameter moreinfo="none">printing</parameter></link> is 
9     set to <constant>cups</constant>.  Its value is a free form string of options
10     passed directly to the cups library.  
11     </para>
13    <para>You can pass any generic print option known to CUPS (as listed
14    in the CUPS "Software Users' Manual").  You can also pass any printer
15    specific option (as listed in "lpoptions -d printername -l")
16    valid for the target queue.</para>
18    <para>You should set this parameter to <constant>raw</constant> if your CUPS server 
19    <filename>error_log</filename> file contains messages such as
20    "Unsupported format 'application/octet-stream'" when printing from a Windows client 
21    through Samba.  It is no longer necessary to enable
22    system wide raw printing in <filename>/etc/cups/mime.{convs,types}</filename>.
23    </para>
25 </description>
27 <value type="default">""</value>
28 <value type="example">"raw,media=a4,job-sheets=secret,secret"</value>
29 </samba:parameter>