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-2016 by Apple Inc.