man/cupsd.8

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