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