a bit field indicating which type of jobs to return PAPI_LIST_JOBS_OTHERS include jobs submitted by others. The default is to report only on your own jobs

PAPI_LIST_JOBS_COMPLETED

include completed jobs

PAPI_LIST_JOBS_NOT_COMPLETED

include jobs not complete

PAPI_LIST_JOBS_ALL

report on all jobs

Description

The papiPrintersList() function retrieves the requested attributes from the print service(s) for
all available printers. Because the Solaris implementation is name service-enabled, applications
should retrieve only the printer-name and printer-uri-supported attributes using this function, thereby
reducing the overhead involved in generating a printer list. Further integration
of printer state and capabilities can be performed with papiPrinterQuery().

The papiPrinterAdd(), papiPrinterModify(), and papiPrinterRemove() functions allow for creation, modification, and removal
of print queues. Print queues are added or modified according to
the attribute list passed into the call. A printer object is returned that
reflects the configuration of the printer after the addition or modification has
been applied. At this time, they provide only minimal functionality and
only for the LP print service.

The papiPrinterDisable() and papiPrinterEnable() functions allow applications to turn off and on
queueing (accepting print requests) for a print queue. The papiPrinterEnable() and papiPrinterDisable()
functions allow applications to turn on and off print job processing for a
print queue.

The papiPrinterPause() function stops queueing of print jobs on the named print
queue.

The papiPrinterResume() function resumes queueing of print jobs on the named print
queue.

The papiPrinterPurgeJobs() function allows applications to delete all print jobs that it
has privilege to remove. A list of cancelled jobs is returned
in the jobs argument.

The papiPrinterListJobs() function enumerates print jobs on a particular queue. papiPrinterGetAttributeList() retrieves
an attribute list from a printer object.

The papiPrinterGetAttributeList() function retrieves an attribute list from a printer object returned
from papiPrinterQuery(), papiPrintersList(), papiPrinterModify(), and papiPrinterAdd(). This attribute list can be searched
for various information about the printer object.

The papiPrinterFree() and papiPrinterListFree() functions deallocate memory allocated for the return of
printer object(s) from functions that return printer objects.

Return Values

Upon successful completion, all functions that return a value return PAPI_OK. Otherwise,
they return an appropriate papi_status_t() indicating the type of failure.

Upon successful completion, papiPrinterGetAttributeList() returns a pointer to the requested data. Otherwise,
it returns NULL.