Mapping Attributes and Values to PPD Options

A PPD file associated to a CUPS destination describes all the device features that a certain printer model can use. It also contains the coded commands that must be used to invoke certain features of the device. Such features include different page sizes, different methods of paper handling, memory size, font availability, and finishing features, such as duplex printing or stapling.

When a CUPS destination is created within the InfoPrint Manager system, specific information is extracted from the PPD printer. This information is then saved under the /var/pd/linux.models directory as a printer model configuration file that has the name of the printer model and the .cfg extension, for example: RICOH_MP_601.ppd.cfg. The OTHER_PRINTER_OPTIONS section of the printer model configuration file maps InfoPrint Manager attributes and values to PPD options by using the following basic syntax: <ipm_attribute_name>:<ipm_attribute_value>:<ppd_options>. The support consists in passing the <ppd_options> to the underlying CUPS print system when the job, document, or destination <ipm_attribute_name> has the value set to <ipm_attribute_value>.

For example, this statement configures the PPD option to be passed for printing monochrome: color-bits-per-plane:0-bits:ColorModel=GrayScale. InfoPrint Manager passes the ColorModel=GrayScale option for every CUPS job processing with a value of 0-bits for the document or destination color-bits-per-plane attribute.

The challenge is in identifying the PPD options which call the needed functions. The lpoptions CUPS command can be used for listing the options defined in the printer PPD file. The CUPS error_log in /var/log/cups can help as CUPS lists all the options passed for a specific job. To determine the correct mapping, use the Linux print interface to select features and then to identify the PPD options passed in the CUPS logs.

These attributes can be mapped in the OTHER_PRINTER_OPTIONS section:

  • color-toner-saver
  • color-bits-per-plane
  • default-medium
  • default-printer-resolution
  • output bin
  • output-format
  • job-finishing

Examples: 

color-bits-per-plane:0-bits:ColorModel=Gray
color-bits-per-plane:8-bits:ColorModel=CMYK
color-toner-saver:yes:RIPRintMode=4rhit
output-bin:standard:OutputBin=FinisherStandard
output-bin:middle:OutputBin=FinisherMiddle
output-bin:stapler:OutputBin=FinEUPHBBKShift StapleLocation=UpperLeft
output-bin:bookletmaker:OutPutBin=FinEUPHBBKLower StapleLocation=CenterW
job-finishing:punch-2:RIPunch=Left2
job-finishing:staple-2-left:StapleLocation=LeftW

    Note:
  • The InfoPrint Manager administrator maps the PPD options in the printer model configuration.
  • Unless instructed by the support personnel, the administrator must not edit any other section of the printer model configuration file.
  • Restart the server after a change in the printer model configuration file.
  • Devices do not have the same set of features, and even devices with the same features do not necessarily invoke those features in the same way.
  • PPD print options can be passed to the underlying print system also by using the printer-pass-through attribute.
  • The underlying print system ignores the PPD options when using passthrough printing, via the -o raw option.
  • The printer model configuration file supports only the en_US locale. You must use en_US attributes and values when you map PPD options.
  • Use true or false values for the attributes that accept yes or no, such as: color-toner-saver:true:RIPRintMode=4rhit.

For more information about these attributes, see RICOH InfoPrint Manager: Reference.

Parent topic: CUPS DSS