Greatly simplify the man page handling.
[thirdparty/cups.git] / man / cupsd-helper.8
1 .\"
2 .\" cupsd-helper man page for CUPS.
3 .\"
4 .\" Copyright 2007-2019 by Apple Inc.
5 .\" Copyright 1997-2006 by Easy Software Products.
6 .\"
7 .\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
8 .\" information.
9 .\"
10 .TH cupsd-helper 8 "CUPS" "26 April 2019" "Apple Inc."
11 .SH NAME
12 cupsd\-helper \- cupsd helper programs (deprecated)
13 .SH SYNOPSIS
14 .B cups\-deviced
15 .I request-id
16 .I limit
17 .I user-id
18 .I options
19 .br
20 .B cups\-driverd
21 .B cat
22 .I ppd-name
23 .br
24 .B cups\-driverd
25 .B list
26 .I request_id
27 .I limit
28 .I options
29 .br
30 .B cups\-exec
31 .I sandbox-profile
32 [
33 .I \-g
34 .I group-id
35 ] [
36 .I \-n
37 .I nice-value
38 ] [
39 .I \-u
40 .I user-id
41 ]
42 .I /path/to/program
43 .I argv0
44 .I ...
45 .I argvN
46 .SH DESCRIPTION
47 The \fBcupsd\-helper\fR programs perform long-running operations on behalf of the scheduler,
48 .BR cupsd (8).
49 The \fBcups-deviced\fR helper program runs each CUPS
50 .BR backend (7)
51 with no arguments in order to discover the available printers.
52 .LP
53 The \fBcups-driverd\fR helper program lists all available printer drivers, a subset of "matching" printer drivers, or a copy of a specific driver PPD file.
54 .LP
55 The \fBcups-exec\fR helper program runs backends, filters, and other programs. On macOS these programs are run in a secure sandbox.
56 .SH FILES
57 The \fBcups-driverd\fR program looks for PPD and driver information files in the following directories:
58 .nf
59
60     \fI/Library/Printers\fR
61     \fI/opt/share/ppd\fR
62     \fI/System/Library/Printers\fR
63     \fI/usr/local/share/ppd\fR
64     \fI/usr/share/cups/drv\fR
65     \fI/usr/share/cups/model\fR
66     \fI/usr/share/ppd\fR
67 .fi
68 .LP
69 PPD files can be compressed using the
70 .BR gzip (1)
71 program or placed in compressed
72 .BR tar (1)
73 archives to further reduce their size.
74 .LP
75 Driver information files must conform to the format defined in
76 .BR ppdcfile (5).
77 .SH NOTES
78 CUPS printer drivers, backends, and PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
79 Printers that do not support IPP can be supported using applications such as
80 .BR ippeveprinter (1).
81 .SH SEE ALSO
82 .BR backend (7),
83 .BR cups (1),
84 .BR cupsd (8),
85 .BR cupsd.conf (5),
86 .BR filter (7),
87 .BR ppdcfile (5),
88 CUPS Online Help (http://localhost:631/help)
89 .SH COPYRIGHT
90 Copyright \[co] 2007-2019 by Apple Inc.