summaryrefslogtreecommitdiff
path: root/man/cupsd.8
blob: e671ae3287a4ead9dee3b50095879abc4725eb7a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
.\"
.\" cupsd man page for CUPS.
.\"
.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
.\" information.
.\"
.TH cupsd 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cupsd \- cups scheduler
.SH SYNOPSIS
.B cupsd
[
.B \-c
.I cupsd.conf
] [
.B \-f
] [
.B \-F
] [
.B \-h
] [
.B \-l
] [
.B \-s
.I cups-files.conf
] [
.B \-t
]
.SH DESCRIPTION
.B cupsd
is the scheduler for CUPS. It implements a printing system based upon the Internet Printing Protocol, version 2.1, and supports most of the requirements for IPP Everywhere. If no options are specified on the command-line then the default configuration file
.I /etc/cups/cupsd.conf
will be used.
.SH OPTIONS
.TP 5
.BI \-c \ cupsd.conf
Uses the named cupsd.conf configuration file.
.TP 5
.B \-f
Run
.B cupsd
in the foreground; the default is to run in the background as a "daemon".
.TP 5
.B \-F
Run
.B cupsd
in the foreground but detach the process from the controlling terminal and current directory. This is useful for running
.B cupsd
from
.BR init (8).
.TP 5
.B \-h
Shows the program usage.
.TP 5
.B \-l
This option is passed to
.B cupsd
when it is run from
.BR launchd (8)
or
.BR systemd (8).
.TP 5
.BI \-s \ cups-files.conf
Uses the named cups-files.conf configuration file.
.TP 5
.B \-t
Test the configuration file for syntax errors.
.SH FILES
.nf
.I /etc/cups/classes.conf
.I /etc/cups/cups-files.conf
.I /etc/cups/cupsd.conf
.I /usr/share/cups/mime/mime.convs
.I /usr/share/cups/mime/mime.types
.I /etc/cups/printers.conf
.I /etc/cups/subscriptions.conf
.fi
.SH CONFORMING TO
.B cupsd
implements all of the required IPP/2.1 attributes and operations. It also implements several CUPS-specific administrative operations.
.SH EXAMPLES
Run
.B cupsd
in the background with the default configuration file:
.nf

    cupsd

.fi
Test a configuration file called
.IR test.conf :
.nf

    cupsd \-t \-c test.conf

.fi
Run
.B cupsd
in the foreground with a test configuration file called
.IR test.conf :
.nf

    cupsd \-f \-c test.conf

.fi
.SH SEE ALSO
.BR backend (7),
.BR classes.conf (5),
.BR cups (1),
.BR cups-files.conf (5),
.BR cups-lpd (8),
.BR cupsd.conf (5),
.BR cupsd-helper (8),
.BR cupsd-logs (8),
.BR filter (7),
.BR launchd (8),
.BR mime.convs (5),
.BR mime.types (5),
.BR printers.conf (5),
.BR systemd (8),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
Copyright \[co] 2007-2019 by Apple Inc.