docs-xml/smbdotconf/printing/cupsoptions.xml

   1 <samba:parameter name="cups options"
   2                  context="S"
   3                  type="string"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6     <para>
   7     This parameter is only applicable if <smbconfoption name="printing"/> is
   8     set to <constant>cups</constant>.  Its value is a free form string of options
   9     passed directly to the cups library.
  10     </para>
  11
  12    <para>
  13    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.
  17    Multiple parameters should be space-delimited name/value pairs according to
  18    the PAPI text option ABNF specification. Collection values
  19    ("name={a=... b=... c=...}") are stored with the curley brackets intact.
  20    </para>
  21
  22    <para>
  23    You should set this parameter to <constant>raw</constant> if your CUPS server
  24    <filename>error_log</filename> file contains messages such as
  25    "Unsupported format 'application/octet-stream'" when printing from a Windows client
  26    through Samba.  It is no longer necessary to enable
  27    system wide raw printing in <filename>/etc/cups/mime.{convs,types}</filename>.
  28    </para>
  29
  30 </description>
  31
  32 <value type="default">""</value>
  33 <value type="example">"raw media=a4"</value>
  34 </samba:parameter>