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