Function to loop over all pages of a document. More...

Functions
static bool	caps_drv_all_pages_done (struct caps_drv *cdrv)

static int	caps_drv_printer_state_loop (struct caps_drv *cdrv)

int	caps_drv_page_loop (struct caps_drv *cdrv)

Detailed Description

Function Documentation

static bool caps_drv_all_pages_done ( struct caps_drv * cdrv )

static

Check if the whole document is done

Parameters

[in,out] cdrv All required information about the current print job

Return values

true	All pages are printed, job is done
false	Still pages to be printed

When quit signals a SIGTERM event, it returns true as well.

static int caps_drv_printer_state_loop ( struct caps_drv * cdrv )

static

Handle printer states while printing

Parameters

[in,out] cdrv All required information about the current print job

Return values

0	Continue printing
-ENODEV	Printer device is gone, terminate
-EINVAL	FIXME

As long as we need to wait for a busy printer (due to an failure like out of paper), we mark the job as stopped as well.

int caps_drv_page_loop ( struct caps_drv * cdrv )

Loop over all pages to be print of the current document, deal with the printer and possible errors

Parameters

[in,out] cdrv All required information about the current print job

Return values

-ENODEV	Terminate whole driver (from caps_drv_printer_check())
-EINVAL	Cancel current job (from caps_drv_printer_check())
-EBUSY	Be patient, the driver is in an error state (paper jam, out of paper etc. from caps_drv_printer_check())
-EOF	Premature end of document
-ENOTSUP	A setting or some settings in `pg` aren't possible.

Note: job_data can be NULL for the special usecase of an injected job; We set the job's final state here to "aborted" if we receive a termination signal. Other routines do not need to do so.