X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Fcupsd.man.in;h=8db10ac4cf58fa4d2dffdd26846d164688a1037b;hb=a6580b70a3a761889a51320960961c0198a03491;hp=831890f97dd839f81c0fceb636be2efaae400f00;hpb=c07d5b2daf136da7af01c48ff78135d06d2762fc;p=thirdparty%2Fcups.git diff --git a/man/cupsd.man.in b/man/cupsd.man.in index 831890f97..8db10ac4c 100644 --- a/man/cupsd.man.in +++ b/man/cupsd.man.in @@ -1,78 +1,129 @@ .\" -.\" "$Id: cupsd.man.in 177 2006-06-21 00:20:03Z jlovell $" +.\" cupsd man page for CUPS. .\" -.\" cupsd man page for the Common UNIX Printing System (CUPS). +.\" Copyright 2007-2016 by Apple Inc. +.\" Copyright 1997-2006 by Easy Software Products. .\" -.\" Copyright 1997-2006 by Easy Software Products. +.\" These coded instructions, statements, and computer programs are the +.\" property of Apple Inc. and are protected by Federal copyright +.\" law. Distribution and use rights are outlined in the file "LICENSE.txt" +.\" which should have been included with this file. If this file is +.\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.\" These coded instructions, statements, and computer programs are the -.\" property of Easy Software Products and are protected by Federal -.\" copyright law. Distribution and use rights are outlined in the file -.\" "LICENSE.txt" which should have been included with this file. If this -.\" file is missing or damaged please contact Easy Software Products -.\" at: -.\" -.\" Attn: CUPS Licensing Information -.\" Easy Software Products -.\" 44141 Airport View Drive, Suite 204 -.\" Hollywood, Maryland 20636 USA -.\" -.\" Voice: (301) 373-9600 -.\" EMail: cups-info@cups.org -.\" WWW: http://www.cups.org -.\" -.TH cupsd 8 "Common UNIX Printing System" "12 February 2006" "Easy Software Products" +.TH cupsd 8 "CUPS" "12 February 2016" "Apple Inc." .SH NAME -cupsd \- common unix printing system daemon +cupsd \- cups scheduler .SH SYNOPSIS .B cupsd -[ -c -.I config-file -] [ -f ] [ -F ] [ -h ] [ -l ] +[ +.B \-c +.I cupsd.conf +] [ +.B \-f +] [ +.B \-F +] [ +.B \-h +] [ +.B \-l +] [ +.B \-s +.I cups-files.conf +] [ +.B \-t +] .SH DESCRIPTION -\fIcupsd\fR is the scheduler for the Common UNIX Printing System. It -implements a printing system based upon the Internet Printing Protocol, -version 1.1. If no options are specified on the command-line then the -default configuration file \fI@CUPS_SERVERROOT@/cupsd.conf\fR will be -used. +.B cupsd +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 +.I /etc/cups/cupsd.conf +will be used. .SH OPTIONS .TP 5 --c config-file -.br -Uses the named configuration file. +.BI \-c \ cupsd.conf +Uses the named cupsd.conf configuration file. .TP 5 --f -.br -Run \fIcupsd\fR in the foreground; the default is to run in the -background as a "daemon". +.B \-f +Run +.B cupsd +in the foreground; the default is to run in the background as a "daemon". .TP 5 --F -.br -Run \fIcupsd\fR in the foreground but detach the process from the -controlling terminal and current directory. This is useful for -running \fIcupsd\fR from \fIinit(8)\fR. +.B \-F +Run +.B cupsd +in the foreground but detach the process from the controlling terminal and current directory. This is useful for running +.B cupsd +from +.BR init (8). .TP 5 --h -.br +.B \-h Shows the program usage. .TP 5 --l -.br -This option is passed to \fIcupsd\fR when it is run from -\fIlaunchd(8)\fR. -.SH COMPATIBILITY -\fIcupsd\fR implements all of the required IPP/1.1 attributes and -operations. It also implements several CUPS-specific administration -operations. +.B \-l +This option is passed to +.B cupsd +when it is run from +.BR launchd (8) +or +.BR systemd (8). +.TP 5 +.BI \-s \ cups-files.conf +Uses the named cups-files.conf configuration file. +.TP 5 +.B \-t +Test the configuration file for syntax errors. +.SH FILES +.nf +.I /etc/cups/classes.conf +.I /etc/cups/cups-files.conf +.I /etc/cups/cupsd.conf +.I /usr/share/cups/mime/mime.convs +.I /usr/share/cups/mime/mime.types +.I /etc/cups/printers.conf +.I /etc/cups/subscriptions.conf +.fi +.SH CONFORMING TO +.B cupsd +implements all of the required IPP/2.1 attributes and operations. It also implements several CUPS-specific administrative operations. +.SH EXAMPLES +Run +.B cupsd +in the background with the default configuration file: +.nf + + cupsd + +.fi +Test a configuration file called +.IR test.conf : +.nf + + cupsd \-t \-c test.conf + +.fi +Run +.B cupsd +in the foreground with a test configuration file called +.IR test.conf : +.nf + + cupsd \-f \-c test.conf + +.fi .SH SEE ALSO -\fIbackend(7)\fR, \fIclasses.conf(5)\fR, \fIcups-deviced(8)\fR, -\fIcups-driverd(8)\fR, \fIcups-lpd(8)\fR, \fIcups-polld(8)\fR, -\fIcupsd.conf(5)\fR, \fIfilter(7)\fR, \fIlaunchd(8)\fR, -\fImime.convs(5)\fR, \fImime.types(5)\fR, \fIprinters.conf(5)\fR, -.br -http://localhost:631/help +.BR backend (7), +.BR classes.conf (5), +.BR cups (1), +.BR cups-files.conf (5), +.BR cups-lpd (8), +.BR cupsd.conf (5), +.BR cupsd-helper (8), +.BR cupsd-logs (8), +.BR filter (7), +.BR launchd (8), +.BR mime.convs (5), +.BR mime.types (5), +.BR printers.conf (5), +.BR systemd (8), +CUPS Online Help (http://localhost:631/help) .SH COPYRIGHT -Copyright 1997-2006 by Easy Software Products, All Rights Reserved. -.\" -.\" End of "$Id: cupsd.man.in 177 2006-06-21 00:20:03Z jlovell $". -.\" +Copyright \[co] 2007-2016 by Apple Inc.