1pappl-mainloop(3) pappl main loop functions pappl-mainloop(3)
2
6 pappl-mainloop - pappl main loop functions
7
9 Printer Application Framework (libpappl, "pkg-config --cflags --libs
10 pappl")
11
13 #include <pappl/pappl.h>
14 int
16 papplMainloop(int argc, char *argv[], const char *version, const char
17 *footer_html, int num_drivers, pappl_driver_t *drivers,
18 pappl_driver_cb_t driver_cb, pappl_ml_autoadd_cb_t autoadd_cb, const
19 char *subcmd_name, pappl_ml_subcmd_cb_t subcmd_cb, pappl_ml_system_cb_t
20 system_cb, pappl_ml_usage_cb_t usage_cb, void *data);
21
23 The
24 mainloop function starts the printer application and supports standard
26 command-line arguments and behaviors.
27
29 papplMainloop
30 Run a standard main loop for printer applications.
31 int papplMainloop (
33 int argc,
34 char *argv[],
35 const char *version,
36 const char *footer_html,
37 int num_drivers,
38 pappl_pr_driver_t *drivers,
39 pappl_pr_autoadd_cb_t autoadd_cb,
40 pappl_pr_driver_cb_t driver_cb,
41 const char *subcmd_name,
42 pappl_ml_subcmd_cb_t subcmd_cb,
43 pappl_ml_system_cb_t system_cb,
44 pappl_ml_usage_cb_t usage_cb,
45 void *data
46 );
47 This function runs a standard main loop for a printer application. The
49 "argc" and "argv" arguments are those provided to the main function.
50 The "version" argument specifies a numeric version number for the
52 printer application that conforms to semantic versioning guidelines
53 with up to four numbers, for example "1.2.3.4".
54 The "footer_html" argument specifies HTML text to use in the footer of
56 the web interface. If NULL, the footer is omitted.
57 The "num_drivers", "drivers", and "driver_cb" arguments specify a list
59 of drivers and the driver callback for printers. Specify 0 and NULL if
60 the drivers are configured in the system callback. The "autoadd_cb"
61 argument specifies a callback for automatically adding new printers
62 with the "autoadd" sub-command and for auto-detecting the driver when
63 adding manually.
64 The "usage_cb" argument specifies a callback that displays a usage/help
66 summary. If NULL, a generic summary is shown as needed.
67 The "subcmd_name" and "subcmd_cb" arguments specify the name and a
69 callback for a custom sub-command. If NULL, no custom sub-commands
70 will be supported.
71 The "system_cb" argument specifies a function that will create a new
73 pappl_system_t object. If NULL, a default system object is created.
74 The "data" argument provides application-specific data for each of the
76 callbacks.
77
79 pappl_ml_subcmd_cb_t
80 Sub-command callback
81 typedef int (*pappl_ml_subcmd_cb_t)(const char *base_name, int num_options, cups_option_t *options, int num_files, char **files, void *data);
83 pappl_ml_system_cb_t
85 System callback
86 typedef pappl_system_t * (*pappl_ml_system_cb_t)(int num_options, cups_option_t *options, void *data);
88 pappl_ml_usage_cb_t
90 Program usage callback
91 typedef void (*pappl_ml_usage_cb_t)(void *data);
93
95 pappl(1), pappl-client(3), pappl-device(3), pappl-job(3), pappl-log(3),
96 pappl-mainline(3), pappl-makeresheader(1), pappl-printer(3), pappl-re‐
97 source(3), pappl-system(3), https://www.msweet.org/pappl
98
100 Copyright © 2019-2020 by Michael R Sweet.
101 PAPPL is licensed under the Apache License Version 2.0 with an (op‐
103 tional) exception to allow linking against GPL2/LGPL2 software (like
104 older versions of CUPS), so it can be used freely in any project you'd
105 like. See the files "LICENSE" and "NOTICE" in the source distribution
106 for more information.
1072021-02-15 pappl main loop functions pappl-mainloop(3)