]> git.ipfire.org Git - thirdparty/cups.git/blob - man/cupsd.man.in
Update .gitignore to ignore compressed man pages.
[thirdparty/cups.git] / man / cupsd.man.in
1 .\"
2 .\" cupsd man page for CUPS.
3 .\"
4 .\" Copyright 2007-2016 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 information.
8 .\"
9 .TH cupsd 8 "CUPS" "12 February 2016" "Apple Inc."
10 .SH NAME
11 cupsd \- cups scheduler
12 .SH SYNOPSIS
13 .B cupsd
14 [
15 .B \-c
16 .I cupsd.conf
17 ] [
18 .B \-f
19 ] [
20 .B \-F
21 ] [
22 .B \-h
23 ] [
24 .B \-l
25 ] [
26 .B \-s
27 .I cups-files.conf
28 ] [
29 .B \-t
30 ]
31 .SH DESCRIPTION
32 .B cupsd
33 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
34 .I /etc/cups/cupsd.conf
35 will be used.
36 .SH OPTIONS
37 .TP 5
38 .BI \-c \ cupsd.conf
39 Uses the named cupsd.conf configuration file.
40 .TP 5
41 .B \-f
42 Run
43 .B cupsd
44 in the foreground; the default is to run in the background as a "daemon".
45 .TP 5
46 .B \-F
47 Run
48 .B cupsd
49 in the foreground but detach the process from the controlling terminal and current directory. This is useful for running
50 .B cupsd
51 from
52 .BR init (8).
53 .TP 5
54 .B \-h
55 Shows the program usage.
56 .TP 5
57 .B \-l
58 This option is passed to
59 .B cupsd
60 when it is run from
61 .BR launchd (8)
62 or
63 .BR systemd (8).
64 .TP 5
65 .BI \-s \ cups-files.conf
66 Uses the named cups-files.conf configuration file.
67 .TP 5
68 .B \-t
69 Test the configuration file for syntax errors.
70 .SH FILES
71 .nf
72 .I /etc/cups/classes.conf
73 .I /etc/cups/cups-files.conf
74 .I /etc/cups/cupsd.conf
75 .I /usr/share/cups/mime/mime.convs
76 .I /usr/share/cups/mime/mime.types
77 .I /etc/cups/printers.conf
78 .I /etc/cups/subscriptions.conf
79 .fi
80 .SH CONFORMING TO
81 .B cupsd
82 implements all of the required IPP/2.1 attributes and operations. It also implements several CUPS-specific administrative operations.
83 .SH EXAMPLES
84 Run
85 .B cupsd
86 in the background with the default configuration file:
87 .nf
88
89 cupsd
90
91 .fi
92 Test a configuration file called
93 .IR test.conf :
94 .nf
95
96 cupsd \-t \-c test.conf
97
98 .fi
99 Run
100 .B cupsd
101 in the foreground with a test configuration file called
102 .IR test.conf :
103 .nf
104
105 cupsd \-f \-c test.conf
106
107 .fi
108 .SH SEE ALSO
109 .BR backend (7),
110 .BR classes.conf (5),
111 .BR cups (1),
112 .BR cups-files.conf (5),
113 .BR cups-lpd (8),
114 .BR cupsd.conf (5),
115 .BR cupsd-helper (8),
116 .BR cupsd-logs (8),
117 .BR filter (7),
118 .BR launchd (8),
119 .BR mime.convs (5),
120 .BR mime.types (5),
121 .BR printers.conf (5),
122 .BR systemd (8),
123 CUPS Online Help (http://localhost:631/help)
124 .SH COPYRIGHT
125 Copyright \[co] 2007-2018 by Apple Inc.