1pappl-printer(3) pappl printer functions pappl-printer(3)
2
6 pappl-printer - pappl printer functions
7
9 Printer Application Framework (libpappl, "pkg-config --cflags --libs
10 pappl")
11
13 #include <pappl/pappl.h>
14 typedef struct _pappl_printer_s pappl_printer_t;
16 void
18 papplPrinterCancelAllJobs(pappl_printer_t *printer);
19 void
22 papplPrinterCloseDevice(pappl_printer_t *printer);
23 pappl_printer_t *
26 papplPrinterCreate(pappl_system_t *system, int printer_id, const char
27 *printer_name, const char *driver_name, const char *device_id, const
28 char *device_uri);
29 void
31 papplPrinterDelete(pappl_printer_t *printer);
32 pappl_job_t *
34 papplPrinterFindJob(pappl_printer_t *printer, int job_id);
35 pappl_contact_t *
37 papplPrinterGetContact(pappl_printer_t *printer, pappl_contact_t *con‐
38 tact);
39 const char *
41 papplPrinterGetDeviceID(pappl_printer_t *printer);
42 const char *
44 papplPrinterGetDeviceURI(pappl_printer_t *printer);
45 char *
47 papplPrinterGetDNSSDName(pappl_printer_t *printer, char *buffer, size_t
48 bufsize);
49 ipp_t *
51 papplPrinterGetDriverAttributes(pappl_printer_t *printer);
52 pappl_driver_data_t *
54 papplPrinterGetDriverData(pappl_printer_t *printer, pappl_driver_data_t
55 *data);
56 const char *
58 papplPrinterGetDriverName(pappl_printer_t *printer);
59 char *
61 papplPrinterGetGeoLocation(pappl_printer_t *printer, char *buffer,
62 size_t bufsize);
63 int
65 papplPrinterGetID(pappl_printer_t *printer);
66 int
68 papplPrinterGetImpressionsCompleted(pappl_printer_t *printer);
69 char *
71 papplPrinterGetLocation(pappl_printer_t *printer, char *buffer, size_t
72 bufsize);
73 int
75 papplPrinterGetMaxActiveJobs(pappl_printer_t *printer);
76 int
78 papplPrinterGetMaxCompletedJobs(pappl_printer_t *printer);
79 const char *
81 papplPrinterGetName(pappl_printer_t *printer);
82 int
84 papplPrinterGetNextJobID(pappl_printer_t *printer);
85 int
87 papplPrinterGetNumberOfActiveJobs(pappl_printer_t *printer);
88 int
90 papplPrinterGetNumberOfCompletedJobs(pappl_printer_t *printer);
91 int
93 papplPrinterGetNumberOfJobs(pappl_printer_t *printer);
94 char *
96 papplPrinterGetOrganization(pappl_printer_t *printer, char *buffer,
97 size_t bufsize);
98 char *
100 papplPrinterGetOrganizationalUnit(pappl_printer_t *printer, char *buf‐
101 fer, size_t bufsize);
102 char *
104 papplPrinterGetPrintGroup(pappl_printer_t *printer, char *buffer,
105 size_t bufsize);
106 pappl_preason_t
108 papplPrinterGetReasons(pappl_printer_t *printer);
109 ipp_pstate_t
111 papplPrinterGetState(pappl_printer_t *printer);
112 int
114 papplPrinterGetSupplies(pappl_printer_t *printer, int max_supplies,
115 pappl_supply_t *supplies);
116 pappl_system_t *
118 papplPrinterGetSystem(pappl_printer_t *printer);
119 void
122 papplPrinterIterateActiveJobs(pappl_printer_t *printer, pappl_job_cb_t
123 cb, void *data, int first_index, int limit);
124 void
126 papplPrinterIterateAllJobs(pappl_printer_t *printer, pappl_job_cb_t cb,
127 void *data, int first_index, int limit);
128 void
130 papplPrinterIterateCompletedJobs(pappl_printer_t *printer,
131 pappl_job_cb_t cb, void *data, int first_index, int limit);
132 pappl_device_t *
135 papplPrinterOpenDevice(pappl_printer_t *printer);
136 void
139 papplPrinterPause(pappl_printer_t *printer);
140 void
142 papplPrinterResume(pappl_printer_t *printer);
143 void
146 papplPrinterSetContact(pappl_printer_t *printer, pappl_contact_t *con‐
147 tact);
148 void
150 papplPrinterSetDNSSDName(pappl_printer_t *printer, const char *value);
151 void
153 papplPrinterSetDriverData(pappl_printer_t *printer, pappl_driver_data_t
154 *data, ipp_t *attrs);
155 void
157 papplPrinterSetDriverDefaults(pappl_printer_t *printer,
158 pappl_driver_data_t *data);
159 void
161 papplPrinterSetGeoLocation(pappl_printer_t *printer, const char
162 *value);
163 void
165 papplPrinterSetImpressionsCompleted(pappl_printer_t *printer, int add);
166 void
168 papplPrinterSetLocation(pappl_printer_t *printer, const char *value);
169 void
171 papplPrinterSetMaxActiveJobs(pappl_printer_t *printer, int max_ac‐
172 tive_jobs);
173 void
175 papplPrinterSetMaxCompletedJobs(pappl_printer_t *printer, int max_com‐
176 pleted_jobs);
177 void
179 papplPrinterSetNextJobID(pappl_printer_t *printer, int next_job_id);
180 void
182 papplPrinterSetOrganization(pappl_printer_t *printer, const char
183 *value);
184 void
186 papplPrinterSetOrganizationalUnit(pappl_printer_t *printer, const char
187 *value);
188 void
190 papplPrinterSetPrintGroup(pappl_printer_t *printer, const char *value);
191 void
193 papplPrinterSetReadyMedia(pappl_printer_t *printer, int num_ready,
194 pappl_media_col_t *ready);
195 void
197 papplPrinterSetReasons(pappl_printer_t *printer, pappl_preason_t add,
198 pappl_preason_t remove);
199 void
201 papplPrinterSetSupplies(pappl_printer_t *printer, int num_supplies,
202 pappl_supply_t *supplies);
203 void
205 papplPrinterSetUSB(pappl_printer_t *printer, unsigned vendor_id, un‐
206 signed product_id, pappl_uoptions_t options);
207
210 The PAPPL printer functions provide access to the printer object.
211 Printers are created and deleted by the printer application while the
212 life cycle of the pappl_printer_t objects are managed automatically by
213 the system object for the printer application.
214 The papplPrinterCreate function creates a new printer while the pappl‐
216 PrinterDelete function deletes a printer.
217 The papplPrinterPause function stops a printer while the papplPrinter‐
219 Resume function starts a printer.
220 The papplPrinterGet functions get the current values associated with a
222 printer while the papplPrinterSet functions set the current values as‐
223 sociated with a printer.
224 The papplPrinterCancelAddJobs, papplPrinterFindJob, papplPrinterGetNum‐
226 berOfActiveJobs, papplPrinterGetNumberOfCompletedJobs, papplPrinterGet‐
227 NumberOfJobs, papplPrinterIterateActiveJobs, papplPrinterIter‐
228 ateAllJobs, and papplPrinterIterateCompletedJobs functions provide ac‐
229 cess to the jobs queued on a printer.
230 The papplPrinterOpenDevice function provides access to the device asso‐
232 ciated with a printer when it is not processing a job. The device must
233 be later closed using the papplPrinterCloseDevice function so that the
234 printer can resume job processing.
235
237 pappl_color_mode_e
238 IPP "print-color-mode" bit values
239 PAPPL_COLOR_MODE_AUTO
241 ´auto' - Automatic color/monochrome print mode
242 PAPPL_COLOR_MODE_AUTO_MONOCHROME
244 ´auto-monochrome' - Automatic monochrome/process monochrome print
245 mode
246 PAPPL_COLOR_MODE_BI_LEVEL
248 ´bi-level' - B&W (threshold) print mode
249 PAPPL_COLOR_MODE_COLOR
251 ´color' - Full color print mode
252 PAPPL_COLOR_MODE_MONOCHROME
254 ´monochrome' - Grayscale print mode using 1 color
255 PAPPL_COLOR_MODE_PROCESS_MONOCHROME
257 ´process-monochrome' - Grayscale print mode using multiple colors
258 pappl_content_e
260 IPP "print-content-optimize" bit values
261 PAPPL_CONTENT_AUTO
263 ´auto': Automatically determine content
264 PAPPL_CONTENT_GRAPHIC
266 ´graphic': Optimize for vector graphics
267 PAPPL_CONTENT_PHOTO
269 ´photo': Optimize for photos/continuous tone images
270 PAPPL_CONTENT_TEXT
272 ´text': Optimize for text
273 PAPPL_CONTENT_TEXT_AND_GRAPHIC
275 ´text-and-graphic': Optimize for text and vector graphics
276 pappl_duplex_e
278 Duplex printing support
279 PAPPL_DUPLEX_FLIPPED
281 Duplex with flipped back sides
282 PAPPL_DUPLEX_MANUAL_TUMBLE
284 Duplex with back side rotated 180 degrees for short-edge duplex
285 PAPPL_DUPLEX_NONE
287 No duplex printing support
288 PAPPL_DUPLEX_NORMAL
290 Duplex with normal back sides
291 PAPPL_DUPLEX_ROTATED
293 Duplex with back side rotated 180 degrees for long-edge duplex
294 pappl_finishings_e
296 IPP "finishings" bit values
297 PAPPL_FINISHINGS_NONE
299 ´none'
300 PAPPL_FINISHINGS_PUNCH
302 ´punch'
303 PAPPL_FINISHINGS_STAPLE
305 ´staple'
306 PAPPL_FINISHINGS_TRIM
308 ´trim'
309 pappl_identify_actions_e
311 IPP "identify-actions" bit values
312 PAPPL_IDENTIFY_ACTIONS_DISPLAY
314 ´display': Display a message
315 PAPPL_IDENTIFY_ACTIONS_FLASH
317 ´flash': Flash the display or a light
318 PAPPL_IDENTIFY_ACTIONS_NONE
320 No actions
321 PAPPL_IDENTIFY_ACTIONS_SOUND
323 ´sound': Make a sound
324 PAPPL_IDENTIFY_ACTIONS_SPEAK
326 ´speak': Speak a message
327 pappl_kind_e
329 IPP "printer-kind" bit values
330 PAPPL_KIND_DISC
332 ´disc'
333 PAPPL_KIND_DOCUMENT
335 ´document'
336 PAPPL_KIND_ENVELOPE
338 ´envelope'
339 PAPPL_KIND_LABEL
341 ´label'
342 PAPPL_KIND_LARGE_FORMAT
344 ´large-format'
345 PAPPL_KIND_PHOTO
347 ´photo'
348 PAPPL_KIND_POSTCARD
350 ´postcard'
351 PAPPL_KIND_RECEIPT
353 ´receipt'
354 PAPPL_KIND_ROLL
356 ´roll'
357 pappl_label_mode_e
359 IPP "label-mode-xxx" bit values
360 PAPPL_LABEL_MODE_APPLICATOR
362 ´applicator'
363 PAPPL_LABEL_MODE_CUTTER
365 ´cutter'
366 PAPPL_LABEL_MODE_CUTTER_DELAYED
368 ´cutter-delayed'
369 PAPPL_LABEL_MODE_KIOSK
371 ´kiosk'
372 PAPPL_LABEL_MODE_PEEL_OFF
374 ´peel-off'
375 PAPPL_LABEL_MODE_PEEL_OFF_PREPEEL
377 ´peel-off-prepeel'
378 PAPPL_LABEL_MODE_REWIND
380 ´rewind'
381 PAPPL_LABEL_MODE_RFID
383 ´rfid'
384 PAPPL_LABEL_MODE_TEAR_OFF
386 ´tear-off'
387 pappl_media_tracking_e
389 IPP "media-tracking" bit values
390 PAPPL_MEDIA_TRACKING_CONTINUOUS
392 ´continuous'
393 PAPPL_MEDIA_TRACKING_GAP
395 ´gap'
396 PAPPL_MEDIA_TRACKING_MARK
398 ´mark'
399 PAPPL_MEDIA_TRACKING_WEB
401 ´web'
402 pappl_preason_e
404 IPP "printer-state-reasons" bit values
405 PAPPL_PREASON_COVER_OPEN
407 ´cover-open'
408 PAPPL_PREASON_DEVICE_STATUS
410 Supported papplDeviceGetStatus bits
411 PAPPL_PREASON_INPUT_TRAY_MISSING
413 ´input-tray-missing'
414 PAPPL_PREASON_MARKER_SUPPLY_EMPTY
416 ´marker-supply-empty'
417 PAPPL_PREASON_MARKER_SUPPLY_LOW
419 ´marker-supply-low'
420 PAPPL_PREASON_MARKER_WASTE_ALMOST_FULL
422 ´marker-waste-almost-full'
423 PAPPL_PREASON_MARKER_WASTE_FULL
425 ´marker-waste-full'
426 PAPPL_PREASON_MEDIA_EMPTY
428 ´media-empty'
429 PAPPL_PREASON_MEDIA_JAM
431 ´media-jam'
432 PAPPL_PREASON_MEDIA_LOW
434 ´media-low'
435 PAPPL_PREASON_MEDIA_NEEDED
437 ´media-needed'
438 PAPPL_PREASON_NONE
440 ´none'
441 PAPPL_PREASON_OFFLINE
443 ´offline'
444 PAPPL_PREASON_OTHER
446 ´other'
447 PAPPL_PREASON_SPOOL_AREA_FULL
449 ´spool-area-full'
450 PAPPL_PREASON_TONER_EMPTY
452 ´toner-empty'
453 PAPPL_PREASON_TONER_LOW
455 ´toner-low'
456 pappl_raster_type_e
458 IPP "pwg-raster-document-type-supported" bit values
459 PAPPL_PWG_RASTER_TYPE_ADOBE_RGB_16
461 16-bit per component AdobeRGB
462 PAPPL_PWG_RASTER_TYPE_ADOBE_RGB_8
464 8-bit per component AdobeRGB
465 PAPPL_PWG_RASTER_TYPE_BLACK_1
467 1-bit (device) black
468 PAPPL_PWG_RASTER_TYPE_BLACK_16
470 16-bit (device) black
471 PAPPL_PWG_RASTER_TYPE_BLACK_8
473 8-bit (device) black
474 PAPPL_PWG_RASTER_TYPE_CMYK_16
476 16-bit per component (device) CMYK
477 PAPPL_PWG_RASTER_TYPE_CMYK_8
479 8-bit per component (device) CMYK
480 PAPPL_PWG_RASTER_TYPE_NONE
482 Do not force a particular raster type
483 PAPPL_PWG_RASTER_TYPE_RGB_16
485 16-bit per component (device) RGB)
486 PAPPL_PWG_RASTER_TYPE_RGB_8
488 8-bit per component (device) RGB
489 PAPPL_PWG_RASTER_TYPE_SGRAY_16
491 16-bit grayscale with 2.2 gamma
492 PAPPL_PWG_RASTER_TYPE_SGRAY_8
494 8-bit grayscale with 2.2 gamma
495 PAPPL_PWG_RASTER_TYPE_SRGB_16
497 16-bit per component sRGB
498 PAPPL_PWG_RASTER_TYPE_SRGB_8
500 8-bit per component sRGB
501 pappl_scaling_e
503 IPP "print-scaling" bit values
504 PAPPL_SCALING_AUTO
506 ´auto': Scale to fit (non-borderless) or fill (borderless) if
507 larger, otherwise center
508 PAPPL_SCALING_AUTO_FIT
510 ´auto-fit': Scale to fit if larger, otherwise center
511 PAPPL_SCALING_FILL
513 ´fill': Scale to fill the media
514 PAPPL_SCALING_FIT
516 ´fit': Scale to fit within margins
517 PAPPL_SCALING_NONE
519 ´none': No scaling (center/crop)
520 pappl_sides_e
522 IPP "sides" bit values
523 PAPPL_SIDES_ONE_SIDED
525 ´one-sided'
526 PAPPL_SIDES_TWO_SIDED_LONG_EDGE
528 ´two-sided-long-edge'
529 PAPPL_SIDES_TWO_SIDED_SHORT_EDGE
531 ´two-sided-short-edge'
532 pappl_supply_color_e
534 "printer-supply" color values
535 PAPPL_SUPPLY_COLOR_BLACK
537 Black ink/toner (photo or matte)
538 PAPPL_SUPPLY_COLOR_CYAN
540 Cyan ink/toner
541 PAPPL_SUPPLY_COLOR_GRAY
543 Gray ink (sometimes marketed as light gray)
544 PAPPL_SUPPLY_COLOR_GREEN
546 Green ink
547 PAPPL_SUPPLY_COLOR_LIGHT_CYAN
549 Light cyan ink
550 PAPPL_SUPPLY_COLOR_LIGHT_GRAY
552 Light gray ink (sometimes marketed as light light gray)
553 PAPPL_SUPPLY_COLOR_LIGHT_MAGENTA
555 Light magenta ink
556 PAPPL_SUPPLY_COLOR_MAGENTA
558 Magenta ink/toner
559 PAPPL_SUPPLY_COLOR_NO_COLOR
561 No color (waste tank, etc.)
562 PAPPL_SUPPLY_COLOR_ORANGE
564 Orange ink
565 PAPPL_SUPPLY_COLOR_VIOLET
567 Violet ink
568 PAPPL_SUPPLY_COLOR_YELLOW
570 Yellow ink/toner
571 pappl_supply_type_e
573 IPP "printer-supply" type values
574 PAPPL_SUPPLY_TYPE_BANDING_SUPPLY
576 Banding finisher supplies
577 PAPPL_SUPPLY_TYPE_BINDING_SUPPLY
579 Binding finisher supplies
580 PAPPL_SUPPLY_TYPE_CLEANER_UNIT
582 Cleaning unit
583 PAPPL_SUPPLY_TYPE_CORONA_WIRE
585 Corona wire (laser printers)
586 PAPPL_SUPPLY_TYPE_COVERS
588 Cover finisher supplies
589 PAPPL_SUPPLY_TYPE_DEVELOPER
591 Developer supply
592 PAPPL_SUPPLY_TYPE_FUSER
594 Fuser (laser printers)
595 PAPPL_SUPPLY_TYPE_FUSER_CLEANING_PAD
597 Fuser cleaning pad (laser printers)
598 PAPPL_SUPPLY_TYPE_FUSER_OIL
600 Fuser oil supply (laser printers)
601 PAPPL_SUPPLY_TYPE_FUSER_OILER
603 Fuser oiler (laser printers)
604 PAPPL_SUPPLY_TYPE_FUSER_OIL_WICK
606 Fuser oil wick (laser printers)
607 PAPPL_SUPPLY_TYPE_INK
609 Ink supply
610 PAPPL_SUPPLY_TYPE_INK_CARTRIDGE
612 Ink cartridge
613 PAPPL_SUPPLY_TYPE_INK_RIBBON
615 Ink ribbon supply
616 PAPPL_SUPPLY_TYPE_INSERTS
618 Insert finisher supplies
619 PAPPL_SUPPLY_TYPE_OPC
621 Optical photoconductor (laser printers)
622 PAPPL_SUPPLY_TYPE_PAPER_WRAP
624 Wrap finisher supplies
625 PAPPL_SUPPLY_TYPE_RIBBON_WAX
627 Wax ribbon supply
628 PAPPL_SUPPLY_TYPE_SOLID_WAX
630 Solid wax supply
631 PAPPL_SUPPLY_TYPE_STAPLES
633 Staple finisher supplies
634 PAPPL_SUPPLY_TYPE_STITCHING_WIRE
636 Staple/stitch finisher supplies
637 PAPPL_SUPPLY_TYPE_TONER
639 Toner supply
640 PAPPL_SUPPLY_TYPE_TONER_CARTRIDGE
642 Toner cartridge
643 PAPPL_SUPPLY_TYPE_TRANSFER_UNIT
645 Transfer unit (laser printers)
646 PAPPL_SUPPLY_TYPE_WASTE_INK
648 Waste ink
649 PAPPL_SUPPLY_TYPE_WASTE_TONER
651 Waste toner
652 PAPPL_SUPPLY_TYPE_WASTE_WATER
654 Waste water
655 PAPPL_SUPPLY_TYPE_WASTE_WAX
657 Waste wax
658 PAPPL_SUPPLY_TYPE_WATER
660 Water supply
661 pappl_uoptions_e
663 USB gadget options
664 PAPPL_UOPTIONS_ETHERNET
666 Include USB ethernet gadget
667 PAPPL_UOPTIONS_NONE
669 No options (just USB printer)
670 PAPPL_UOPTIONS_SERIAL
672 Include USB serial gadget
673 PAPPL_UOPTIONS_STORAGE
675 Include USB mass storage gadget
676 PAPPL_UOPTIONS_STORAGE_READONLY
678 USB mass storage gadget is read-only
679 PAPPL_UOPTIONS_STORAGE_REMOVABLE
681 USB mass storage gadget is removable
682
684 papplPrinterCancelAllJobs
685 Cancel all jobs on the printer.
686 void papplPrinterCancelAllJobs (
688 pappl_printer_t *printer
689 );
690 This function cancels all jobs on the printer. If any job is currently
692 being printed, it will be stopped at a convenient time (usually the end
693 of a page) so that the printer will be left in a known state.
694 papplPrinterCloseDevice
696 Close the device associated with the printer.
697 void papplPrinterCloseDevice (
699 pappl_printer_t *printer
700 );
701 This function closes the device for a printer. The device must have
703 been previously opened using the papplPrinterOpenDevice function.
704 papplPrinterCreate
706 Create a new printer.
707 pappl_printer_t * papplPrinterCreate (
709 pappl_system_t *system,
710 int printer_id,
711 const char *printer_name,
712 const char *driver_name,
713 const char *device_id,
714 const char *device_uri
715 );
716 This function creates a new printer (service) on the specified system.
718 The "type" argument specifies the type of service to create and must
719 currently be the value PAPPL_SERVICE_TYPE_PRINT.
720 The "printer_id" argument specifies a positive integer identifier that
722 is unique to the system. If you specify a value of 0 a new identifier
723 will be assigned.
724 The "driver_name" argument specifies a named driver for the printer,
726 from the list of drivers registered with the papplSystemSetPrinter‐
727 Drivers function.
728 The "device_id" and "device_uri" arguments specify the IEEE-1284 device
730 ID and device URI strings for the printer.
731 On error, this function sets the errno variable to one of the following
733 values:
734 • EEXIST: A printer with the specified name already exists.
736 • EINVAL: Bad values for the arguments were specified.
738 • EIO: The driver callback failed.
740 • ENOENT: No driver callback has been set.
742 • ENOMEM: Ran out of memory.</li> </ul>
744 papplPrinterDelete
746 Delete a printer.
747 void papplPrinterDelete (
749 pappl_printer_t *printer
750 );
751 This function deletes a printer from a system, freeing all memory and
753 canceling all jobs as needed.
754 papplPrinterGetContact
756 Get the "printer-contact" value.
757 pappl_contact_t * papplPrinterGetContact (
759 pappl_printer_t *printer,
760 pappl_contact_t *contact
761 );
762 This function copies the current printer contact information to the
764 buffer pointed to by the "contact" argument.
765 papplPrinterGetDNSSDName
767 Get the current DNS-SD service name.
768 char * papplPrinterGetDNSSDName (
770 pappl_printer_t *printer,
771 char *buffer,
772 size_t bufsize
773 );
774 This function copies the current DNS-SD service name to the buffer
776 pointed to by the "buffer" argument.
777 papplPrinterGetDeviceID
779 Get the IEEE-1284 device ID of the printer.
780 const char * papplPrinterGetDeviceID (
782 pappl_printer_t *printer
783 );
784 This function returns the IEEE-1284 device ID of the printer.
786 papplPrinterGetDeviceURI
788 Get the URI of the device associated with the printer.
789 const char * papplPrinterGetDeviceURI (
791 pappl_printer_t *printer
792 );
793 This function returns the device URI for the printer.
795 papplPrinterGetDriverAttributes
797 Get a copy of the current driver attributes.
798 ipp_t * papplPrinterGetDriverAttributes (
800 pappl_printer_t *printer
801 );
802 This function returns a copy the current driver attributes. Use the ip‐
804 pDelete function to free the memory used for the attributes when you
805 are done.
806 papplPrinterGetDriverData
808 Get the current print driver data.
809 pappl_pr_driver_data_t * papplPrinterGetDriverData (
811 pappl_printer_t *printer,
812 pappl_pr_driver_data_t *data
813 );
814 This function copies the current print driver data, defaults, and ready
816 (loaded) media information into the specified buffer.
817 papplPrinterGetDriverName
819 Get the driver name for a printer.
820 const char * papplPrinterGetDriverName (
822 pappl_printer_t *printer
823 );
824 This function returns the driver name for the printer.
826 papplPrinterGetGeoLocation
828 Get the current geo-location as a "geo:" URI.
829 char * papplPrinterGetGeoLocation (
831 pappl_printer_t *printer,
832 char *buffer,
833 size_t bufsize
834 );
835 This function copies the currently configured geographic location as a
837 "geo:" URI to the buffer pointed to by the "buffer" argument.
838 papplPrinterGetID
840 Get the printer ID.
841 int papplPrinterGetID (
843 pappl_printer_t *printer
844 );
845 This function returns the printer's unique positive integer identifier.
847 papplPrinterGetImpressionsCompleted
849 Get the number of impressions (sides) that have been printed.
850 int papplPrinterGetImpressionsCompleted (
852 pappl_printer_t *printer
853 );
854 This function returns the number of impressions that have been printed.
856 An impression is one side of an output page.
857 papplPrinterGetLocation
859 Get the location string.
860 char * papplPrinterGetLocation (
862 pappl_printer_t *printer,
863 char *buffer,
864 size_t bufsize
865 );
866 This function copies the printer's human-readable location to the buf‐
868 fer pointed to by the "buffer" argument.
869 papplPrinterGetMaxActiveJobs
871 Get the maximum number of active (queued) jobs allowed by the printer.
872 int papplPrinterGetMaxActiveJobs (
874 pappl_printer_t *printer
875 );
876 This function returns the maximum number of active jobs that the
878 printer supports, as configured by the papplPrinterSetMaxActiveJobs
879 function.
880 papplPrinterGetMaxCompletedJobs
882 Get the maximum number of jobs retained for history by the printer.
883 int papplPrinterGetMaxCompletedJobs (
885 pappl_printer_t *printer
886 );
887 This function returns the maximum number of jobs that are retained in
889 the job history as configured by the papplPrinterSetMaxCompletedJobs
890 function.
891 papplPrinterGetName
893 Get the printer name.
894 const char * papplPrinterGetName (
896 pappl_printer_t *printer
897 );
898 This function returns the printer's human-readable name.
900 papplPrinterGetNextJobID
902 Get the next job ID.
903 int papplPrinterGetNextJobID (
905 pappl_printer_t *printer
906 );
907 This function returns the positive integer identifier that will be used
909 for the next job that is created.
910 papplPrinterGetNumberOfActiveJobs
912 Get the number of active print jobs.
913 int papplPrinterGetNumberOfActiveJobs (
915 pappl_printer_t *printer
916 );
917 This function returns the number of print jobs that are either printing
919 or waiting to be printed.
920 papplPrinterGetNumberOfCompletedJobs
922 Get the number of completed print jobs.
923 int papplPrinterGetNumberOfCompletedJobs (
925 pappl_printer_t *printer
926 );
927 This function returns the number of print jobs that have been aborted,
929 canceled, or completed.
930 papplPrinterGetNumberOfJobs
932 Get the total number of print jobs.
933 int papplPrinterGetNumberOfJobs (
935 pappl_printer_t *printer
936 );
937 This function returns the number of print jobs that are printing, wait‐
939 ing to be printed, have been aborted, have been canceled, or have com‐
940 pleted.
941 papplPrinterGetOrganization
943 Get the organization name.
944 char * papplPrinterGetOrganization (
946 pappl_printer_t *printer,
947 char *buffer,
948 size_t bufsize
949 );
950 This function copies the printer's organization name to the buffer
952 pointed to by the "buffer" argument.
953 papplPrinterGetOrganizationalUnit
955 Get the organizational unit name.
956 char * papplPrinterGetOrganizationalUnit (
958 pappl_printer_t *printer,
959 char *buffer,
960 size_t bufsize
961 );
962 This function copies the printer's organizational unit name to the buf‐
964 fer pointed to by the "buffer" argument.
965 papplPrinterGetPath
967 Get the URL path for a printer web page.
968 char * papplPrinterGetPath (
970 pappl_printer_t *printer,
971 const char *subpath,
972 char *buffer,
973 size_t bufsize
974 );
975 This function generates and returns the URL path for the printer's web
977 page. The "subpath" argument specifies an optional sub-path for a spe‐
978 cific printer web page.
979 papplPrinterGetPrintGroup
981 Get the print authorization group, if any.
982 char * papplPrinterGetPrintGroup (
984 pappl_printer_t *printer,
985 char *buffer,
986 size_t bufsize
987 );
988 This function copies the printer's authorization group name to the buf‐
990 fer pointed to by the "buffer" argument.
991 papplPrinterGetReasons
993 Get the current "printer-state-reasons" bit values.
994 pappl_preason_t papplPrinterGetReasons (
996 pappl_printer_t *printer
997 );
998 This function returns the current printer state reasons bitfield, which
1000 can be updated by the printer driver and/or by the papplPrinterSetRea‐
1001 sons function.
1002 papplPrinterGetState
1004 Get the current "printer-state" value.
1005 ipp_pstate_t papplPrinterGetState (
1007 pappl_printer_t *printer
1008 );
1009 This function returns the current printer state as an enumeration:
1011 • IPP_PSTATE_IDLE: The printer is idle and has no jobs to process.
1013 • IPP_PSTATE_PROCESSING: The printer is processing a job and/or pro‐
1015 ducing output.
1016 • IPP_PSTATE_STOPPED: The printer is stopped for maintenance.</li>
1018 </ul>
1019 papplPrinterGetSupplies
1021 Get the current "printer-supplies" values.
1022 int papplPrinterGetSupplies (
1024 pappl_printer_t *printer,
1025 int max_supplies,
1026 pappl_supply_t *supplies
1027 );
1028 This function copies the current printer supply values to the specified
1030 array. The "max_supplies" and "supplies" arguments can be 0 and NULL
1031 to query the number of supplies used.
1032 The return value is the actual number of supplies used by the printer,
1034 regardless of the size of the array.
1035 papplPrinterGetSystem
1037 Get the system associated with the printer.
1038 pappl_system_t * papplPrinterGetSystem (
1040 pappl_printer_t *printer
1041 );
1042 This function returns a pointer to the system object that contains the
1044 printer.
1045 papplPrinterIterateActiveJobs
1047 Iterate over the active jobs.
1048 void papplPrinterIterateActiveJobs (
1050 pappl_printer_t *printer,
1051 pappl_job_cb_t cb,
1052 void *data,
1053 int job_index,
1054 int limit
1055 );
1056 This function iterates over jobs that are either printing or waiting to
1058 be printed. The specified callback "cb" will be called once per job
1059 with the data pointer "data".
1060 The "job_index" argument specifies the first job in the list to iter‐
1062 ate, where 1 is the first job, etc. The "limit" argument specifies the
1063 maximum number of jobs to iterate - use 0 to iterate an unlimited num‐
1064 ber of jobs.
1065 papplPrinterIterateAllJobs
1067 Iterate over all the jobs.
1068 void papplPrinterIterateAllJobs (
1070 pappl_printer_t *printer,
1071 pappl_job_cb_t cb,
1072 void *data,
1073 int job_index,
1074 int limit
1075 );
1076 This function iterates over all jobs. The specified callback "cb" will
1078 be called once per job with the data pointer "data".
1079 The "job_index" argument specifies the first job in the list to iter‐
1081 ate, where 1 is the first job, etc. The "limit" argument specifies the
1082 maximum number of jobs to iterate - use 0 to iterate an unlimited num‐
1083 ber of jobs.
1084 papplPrinterIterateCompletedJobs
1086 Iterate over the completed jobs.
1087 void papplPrinterIterateCompletedJobs (
1089 pappl_printer_t *printer,
1090 pappl_job_cb_t cb,
1091 void *data,
1092 int job_index,
1093 int limit
1094 );
1095 This function iterates over jobs that are aborted, canceled, or com‐
1097 pleted. The specified callback "cb" will be called once per job with
1098 the data pointer "data".
1099 The "job_index" argument specifies the first job in the list to iter‐
1101 ate, where 1 is the first job, etc. The "limit" argument specifies the
1102 maximum number of jobs to iterate - use 0 to iterate an unlimited num‐
1103 ber of jobs.
1104 papplPrinterOpenDevice
1106 Open the device associated with a printer.
1107 pappl_device_t * papplPrinterOpenDevice (
1109 pappl_printer_t *printer
1110 );
1111 This function opens the printer's device. NULL is returned if the de‐
1113 vice is already in use, for example while a job is being printed.
1114 The returned device must be closed using the papplPrinterCloseDevice
1116 function.
1117 papplPrinterPause
1119 Pause (stop) a printer.
1120 void papplPrinterPause (
1122 pappl_printer_t *printer
1123 );
1124 This function pauses a printer. If the printer is currently processing
1126 (printing) a job, it will be completed before the printer is stopped.
1127 papplPrinterResume
1129 Resume (start) a printer.
1130 void papplPrinterResume (
1132 pappl_printer_t *printer
1133 );
1134 This function resumes a printer and starts processing any pending jobs.
1136 papplPrinterSetContact
1138 Set the "printer-contact" value.
1139 void papplPrinterSetContact (
1141 pappl_printer_t *printer,
1142 pappl_contact_t *contact
1143 );
1144 This function sets the printer's contact information.
1146 papplPrinterSetDNSSDName
1148 Set the DNS-SD service name.
1149 void papplPrinterSetDNSSDName (
1151 pappl_printer_t *printer,
1152 const char *value
1153 );
1154 This function sets the printer's DNS-SD service name. If NULL, the
1156 printer will stop advertising the printer.
1157 papplPrinterSetDriverData
1159 Set the driver data.
1160 bool papplPrinterSetDriverData (
1162 pappl_printer_t *printer,
1163 pappl_pr_driver_data_t *data,
1164 ipp_t *attrs
1165 );
1166 This function validates and sets the driver data, including all de‐
1168 faults and ready (loaded) media.
1169 5 Note: This function regenerates all of the driver-specific capa‐
1171 bility
1172 5 attributes like "media-col-database", "sides-supported", and so
1174 forth.
1175 5 Use the papplPrinterSetDriverDefaults or
1177 5 papplPrinterSetReadyMedia functions to efficiently change the
1179 5 "xxx-default" or "xxx-ready" values, respectively.
1181 papplPrinterSetDriverDefaults
1183 Set the default print option values.
1184 bool papplPrinterSetDriverDefaults (
1186 pappl_printer_t *printer,
1187 pappl_pr_driver_data_t *data,
1188 int num_vendor,
1189 cups_option_t *vendor
1190 );
1191 This function validates and sets the printer's default print options.
1193 5 Note: Unlike papplPrinterSetPrintDriverData, this function only
1195 5 changes the "xxx_default" members of the driver data and is con‐
1197 sidered
1198 5 lightweight.
1200 papplPrinterSetGeoLocation
1202 Set the geo-location value as a "geo:" URI.
1203 void papplPrinterSetGeoLocation (
1205 pappl_printer_t *printer,
1206 const char *value
1207 );
1208 This function sets the printer's geographic location as a "geo:" URI.
1210 If NULL, the location is cleared to the 'unknown' value.
1211 papplPrinterSetImpressionsCompleted
1213 Add impressions (sides) to the total count of printed impressions.
1214 void papplPrinterSetImpressionsCompleted (
1216 pappl_printer_t *printer,
1217 int add
1218 );
1219 This function adds to the printer's impressions counter. An impression
1221 is one side of an output page.
1222 papplPrinterSetLocation
1224 Set the location string.
1225 void papplPrinterSetLocation (
1227 pappl_printer_t *printer,
1228 const char *value
1229 );
1230 This function sets the printer's human-readable location string. If
1232 NULL, the location is cleared.
1233 papplPrinterSetMaxActiveJobs
1235 Set the maximum number of active jobs for the printer.
1236 void papplPrinterSetMaxActiveJobs (
1238 pappl_printer_t *printer,
1239 int max_active_jobs
1240 );
1241 This function sets the maximum number of jobs that can be spooled on
1243 the printer at one time.
1244 5 Note: This limit does not apply to streaming raster formats such
1246 as PWG
1247 5 Raster since they are not spooled.
1249 papplPrinterSetMaxCompletedJobs
1251 Set the maximum number of completed jobs for the printer.
1252 void papplPrinterSetMaxCompletedJobs (
1254 pappl_printer_t *printer,
1255 int max_completed_jobs
1256 );
1257 This function sets the maximum number of aborted, canceled, or com‐
1259 pleted jobs that are retained in the job history.
1260 papplPrinterSetNextJobID
1262 Set the next "job-id" value.
1263 void papplPrinterSetNextJobID (
1265 pappl_printer_t *printer,
1266 int next_job_id
1267 );
1268 This function sets the next unique positive integer identifier that
1270 will be used for a job.
1271 5 Note: This function is normally only called once to restore the
1273 previous
1274 5 state of the printer.
1276 papplPrinterSetOrganization
1278 Set the organization name.
1279 void papplPrinterSetOrganization (
1281 pappl_printer_t *printer,
1282 const char *value
1283 );
1284 This function sets the printer's organization name. If NULL the value
1286 is cleared.
1287 papplPrinterSetOrganizationalUnit
1289 Set the organizational unit name.
1290 void papplPrinterSetOrganizationalUnit (
1292 pappl_printer_t *printer,
1293 const char *value
1294 );
1295 This function sets the printer's organizational unit name. If NULL the
1297 value is cleared.
1298 papplPrinterSetPrintGroup
1300 Set the print authorization group, if any.
1301 void papplPrinterSetPrintGroup (
1303 pappl_printer_t *printer,
1304 const char *value
1305 );
1306 This function sets the printer's authorization group. If NULL, the
1308 group is cleared.
1309 5 Note: The authorization group is only used if the system is cre‐
1311 ated with a
1312 5 named authorization service.
1314 papplPrinterSetReadyMedia
1316 Set the ready (loaded) media.
1317 bool papplPrinterSetReadyMedia (
1319 pappl_printer_t *printer,
1320 int num_ready,
1321 pappl_media_col_t *ready
1322 );
1323 This function validates and sets the printer's ready (loaded) media.
1325 papplPrinterSetReasons
1327 Add or remove values from "printer-state-reasons".
1328 void papplPrinterSetReasons (
1330 pappl_printer_t *printer,
1331 pappl_preason_t add,
1332 pappl_preason_t remove
1333 );
1334 This function updates the printer state reasons bitfield by clearing
1336 any bit values in the "remove" argument and setting any bit values in
1337 the "add" argument.
1338 papplPrinterSetSupplies
1340 Set/update the supplies for a printer.
1341 void papplPrinterSetSupplies (
1343 pappl_printer_t *printer,
1344 int num_supplies,
1345 pappl_supply_t *supplies
1346 );
1347 This function updates the supply information for the printer.
1349 papplPrinterSetUSB
1351 Set the USB vendor and product IDs for a printer.
1352 void papplPrinterSetUSB (
1354 pappl_printer_t *printer,
1355 unsigned vendor_id,
1356 unsigned product_id,
1357 pappl_uoptions_t options,
1358 const char *storagefile
1359 );
1360 This function sets the USB vendor and product IDs for a printer as well
1362 as specifying USB gadget options when the printer is registered with
1363 the USB device controller.
1364 5 Note: USB gadget functionality is currently only available when
1366 running
1367 5 on Linux with compatible hardware such as the Raspberry Pi.
1369
1371 pappl_icon_s
1372 Printer PNG icon structure
1373 struct pappl_icon_s
1375 {
1376 const void *data;
1377 size_t datalen;
1378 char filename[256];
1379 };
1380 pappl_media_col_s
1382 Media details structure
1383 struct pappl_media_col_s
1385 {
1386 int bottom_margin;
1387 int left_margin;
1388 int left_offset;
1389 int right_margin;
1390 int size_length;
1391 char size_name[64];
1392 int size_width;
1393 char source[64];
1394 int top_margin;
1395 int top_offset;
1396 pappl_media_tracking_t tracking;
1397 char type[64];
1398 };
1399 pappl_pr_driver_data_s
1401 Printer driver data
1402 struct pappl_pr_driver_data_s
1404 {
1405 const char *bin[PAPPL_MAX_BIN];
1406 int bin_default;
1407 bool borderless;
1408 int bottom_top;
1409 pappl_color_mode_t color_default;
1410 pappl_color_mode_t color_supported;
1411 pappl_content_t content_default;
1412 int darkness_configured;
1413 int darkness_default;
1414 int darkness_supported;
1415 pappl_pr_delete_cb_t delete_cb;
1416 pappl_duplex_t duplex;
1417 void *extension;
1418 const char *features[PAPPL_MAX_VENDOR];
1419 pappl_finishings_t finishings;
1420 pappl_raster_type_t force_raster_type;
1421 const char *format;
1422 pappl_dither_t gdither;
1423 bool has_supplies;
1424 pappl_icon_t icons[3];
1425 pappl_pr_identify_cb_t identify_cb;
1426 pappl_identify_actions_t identify_default;
1427 pappl_identify_actions_t identify_supported;
1428 bool input_face_up;
1429 pappl_kind_t kind;
1430 int left_offset_supported[2];
1431 int left_right;
1432 char make_and_model[128];
1433 const char *media[PAPPL_MAX_MEDIA];
1434 pappl_media_col_t media_default;
1435 pappl_media_col_t media_ready[PAPPL_MAX_SOURCE];
1436 pappl_label_mode_t mode_configured;
1437 pappl_label_mode_t mode_supported;
1438 int num_bin;
1439 int num_features;
1440 int num_media;
1441 int num_resolution;
1442 int num_source;
1443 int num_type;
1444 int num_vendor;
1445 ipp_orient_t orient_default;
1446 bool output_face_up;
1447 pappl_dither_t pdither;
1448 int ppm;
1449 int ppm_color;
1450 pappl_pr_printfile_cb_t printfile_cb;
1451 ipp_quality_t quality_default;
1452 pappl_raster_type_t raster_types;
1453 pappl_pr_rendjob_cb_t rendjob_cb;
1454 pappl_pr_rendpage_cb_t rendpage_cb;
1455 pappl_pr_rstartjob_cb_t rstartjob_cb;
1456 pappl_pr_rstartpage_cb_t rstartpage_cb;
1457 pappl_pr_rwriteline_cb_t rwriteline_cb;
1458 pappl_scaling_t scaling_default;
1459 pappl_sides_t sides_default;
1460 pappl_sides_t sides_supported;
1461 const char *source[PAPPL_MAX_SOURCE];
1462 int speed_default;
1463 int speed_supported[2];
1464 pappl_pr_status_cb_t status_cb;
1465 int tear_offset_configured;
1466 int tear_offset_supported[2];
1467 pappl_pr_testpage_cb_t testpage_cb;
1468 int top_offset_supported[2];
1469 pappl_media_tracking_t tracking_supported;
1470 const char *type[PAPPL_MAX_TYPE];
1471 const char *vendor[PAPPL_MAX_VENDOR];
1472 int x_default;
1473 int x_resolution[PAPPL_MAX_RESOLUTION];
1474 int y_default;
1475 int y_resolution[PAPPL_MAX_RESOLUTION];
1476 };
1477 pappl_pr_options_s
1479 Combined print job options
1480 struct pappl_pr_options_s
1482 {
1483 int copies;
1484 int darkness_configured;
1485 pappl_dither_t dither;
1486 pappl_finishings_t finishings;
1487 unsigned first_page;
1488 cups_page_header2_t header;
1489 unsigned last_page;
1490 pappl_media_col_t media;
1491 unsigned num_pages;
1492 int num_vendor;
1493 ipp_orient_t orientation_requested;
1494 char output_bin[64];
1495 pappl_color_mode_t print_color_mode;
1496 pappl_content_t print_content_optimize;
1497 int print_darkness;
1498 ipp_quality_t print_quality;
1499 pappl_scaling_t print_scaling;
1500 int print_speed;
1501 int printer_resolution[2];
1502 pappl_sides_t sides;
1503 cups_option_t *vendor;
1504 };
1505 pappl_supply_s
1507 Supply data
1508 struct pappl_supply_s
1510 {
1511 pappl_supply_color_t color;
1512 char description[256];
1513 bool is_consumed;
1514 int level;
1515 pappl_supply_type_t type;
1516 };
1517
1519 pappl_color_mode_t
1520 Bitfield for IPP "print-color-mode" values
1521 typedef unsigned pappl_color_mode_t;
1523 pappl_content_t
1525 Bitfield for IPP "print-content-optimize" values
1526 typedef unsigned pappl_content_t;
1528 pappl_default_cb_t
1530 papplIterateDefaults callback
1531 typedef void (*pappl_default_cb_t)(ipp_attribute_t *attr, void *data);
1533 pappl_duplex_t
1535 Duplex printing support
1536 typedef enum pappl_duplex_e pappl_duplex_t;
1538 pappl_finishings_t
1540 Bitfield for IPP "finishings" values
1541 typedef unsigned pappl_finishings_t;
1543 pappl_icon_t
1545 Printer PNG icon structure
1546 typedef struct pappl_icon_s pappl_icon_t;
1548 pappl_identify_actions_t
1550 Bitfield for IPP "identify-actions" values
1551 typedef unsigned pappl_identify_actions_t;
1553 pappl_job_cb_t
1555 papplIterateXxxJobs callback function
1556 typedef void (*pappl_job_cb_t)(pappl_job_t *job, void *data);
1558 pappl_kind_t
1560 Bitfield for IPP "printer-kind" values
1561 typedef unsigned pappl_kind_t;
1563 pappl_label_mode_t
1565 Bitfield for IPP "label-mode-xxx" values
1566 typedef unsigned short pappl_label_mode_t;
1568 pappl_media_col_t
1570 Media details structure
1571 typedef struct pappl_media_col_s pappl_media_col_t;
1573 pappl_media_tracking_t
1575 Bitfield for IPP "media-tracking" values
1576 typedef unsigned short pappl_media_tracking_t;
1578 pappl_pr_delete_cb_t
1580 Printer deletion callback
1581 typedef void (*pappl_pr_delete_cb_t)(pappl_printer_t *printer, pappl_pr_driver_data_t *data);
1583 pappl_pr_identify_cb_t
1585 Identify-Printer callback
1586 typedef void (*pappl_pr_identify_cb_t)(pappl_printer_t *printer, pappl_identify_actions_t actions, const char *message);
1588 pappl_pr_printfile_cb_t
1590 Print a "raw" job callback
1591 typedef bool (*pappl_pr_printfile_cb_t)(pappl_job_t *job, pappl_pr_options_t *options, pappl_device_t *device);
1593 pappl_pr_rendjob_cb_t
1595 End a raster job callback
1596 typedef bool (*pappl_pr_rendjob_cb_t)(pappl_job_t *job, pappl_pr_options_t *options, pappl_device_t *device);
1598 pappl_pr_rendpage_cb_t
1600 End a raster page callback
1601 typedef bool (*pappl_pr_rendpage_cb_t)(pappl_job_t *job, pappl_pr_options_t *options, pappl_device_t *device, unsigned page);
1603 pappl_pr_rstartjob_cb_t
1605 Start a raster job callback
1606 typedef bool (*pappl_pr_rstartjob_cb_t)(pappl_job_t *job, pappl_pr_options_t *options, pappl_device_t *device);
1608 pappl_pr_rstartpage_cb_t
1610 Start a raster page callback
1611 typedef bool (*pappl_pr_rstartpage_cb_t)(pappl_job_t *job, pappl_pr_options_t *options, pappl_device_t *device, unsigned page);
1613 pappl_pr_rwriteline_cb_t
1615 Write a line of raster graphics callback
1616 typedef bool (*pappl_pr_rwriteline_cb_t)(pappl_job_t *job, pappl_pr_options_t *options, pappl_device_t *device, unsigned y, const unsigned char *line);
1618 pappl_pr_status_cb_t
1620 Update printer status callback
1621 typedef bool (*pappl_pr_status_cb_t)(pappl_printer_t *printer);
1623 pappl_pr_testpage_cb_t
1625 Print a test page callback
1626 typedef const char * (*pappl_pr_testpage_cb_t)(pappl_printer_t *printer, char *buffer, size_t bufsize);
1628 pappl_raster_type_t
1630 Bitfield for IPP "pwg-raster-document-type-supported" values
1631 typedef unsigned pappl_raster_type_t;
1633 pappl_scaling_t
1635 Bitfield for IPP "print-scaling" values
1636 typedef unsigned pappl_scaling_t;
1638 pappl_sides_t
1640 Bitfield for IPP "sides" values
1641 typedef unsigned pappl_sides_t;
1643 pappl_supply_color_t
1645 "printer-supply" color values
1646 typedef enum pappl_supply_color_e pappl_supply_color_t;
1648 pappl_supply_t
1650 Supply data
1651 typedef struct pappl_supply_s pappl_supply_t;
1653 pappl_supply_type_t
1655 IPP "printer-supply" type values
1656 typedef enum pappl_supply_type_e pappl_supply_type_t;
1658 pappl_uoptions_t
1660 USB gadget options bitfield
1661 typedef unsigned pappl_uoptions_t;
1663
1665 pappl(1), pappl-client(3), pappl-device(3), pappl-job(3), pappl-log(3),
1666 pappl-mainline(3), pappl-makeresheader(1), pappl-printer(3), pappl-re‐
1667 source(3), pappl-system(3), https://www.msweet.org/pappl
1668
1670 Copyright © 2019-2020 by Michael R Sweet.
1671 PAPPL is licensed under the Apache License Version 2.0 with an (op‐
1673 tional) exception to allow linking against GPL2/LGPL2 software (like
1674 older versions of CUPS), so it can be used freely in any project you'd
1675 like. See the files "LICENSE" and "NOTICE" in the source distribution
1676 for more information.
16772021-02-15 pappl printer functions pappl-printer(3)