]> git.ipfire.org Git - thirdparty/cups.git/blob - man/cupsenable.man
Load cups into easysw/current.
[thirdparty/cups.git] / man / cupsenable.man
1 .\"
2 .\" "$Id: cupsenable.man 5099 2006-02-13 02:46:10Z mike $"
3 .\"
4 .\" cupsenable/cupsdisable man page for the Common UNIX Printing System
5 .\" (CUPS).
6 .\"
7 .\" Copyright 1997-2006 by Easy Software Products.
8 .\"
9 .\" These coded instructions, statements, and computer programs are the
10 .\" property of Easy Software Products and are protected by Federal
11 .\" copyright law. Distribution and use rights are outlined in the file
12 .\" "LICENSE.txt" which should have been included with this file. If this
13 .\" file is missing or damaged please contact Easy Software Products
14 .\" at:
15 .\"
16 .\" Attn: CUPS Licensing Information
17 .\" Easy Software Products
18 .\" 44141 Airport View Drive, Suite 204
19 .\" Hollywood, Maryland 20636 USA
20 .\"
21 .\" Voice: (301) 373-9600
22 .\" EMail: cups-info@cups.org
23 .\" WWW: http://www.cups.org
24 .\"
25 .TH cupsenable 8 "Common UNIX Printing System" "12 February 2006" "Easy Software Products"
26 .SH NAME
27 cupsdisable, cupsenable \- stop/start printers and classes
28 .SH SYNOPSIS
29 .B cupsdisable
30 [ -E ] [-U
31 .I username
32 ] [ -c ] [ -h
33 .I server[:port]
34 ] [ -r
35 .I reason
36 ] destination(s)
37 .br
38 .B cupsenable
39 [ -E ] [-U
40 .I username
41 ] [ -c ] [ -h
42 .I server[:port]
43 ] destination(s)
44 .SH DESCRIPTION
45 \fIcupsenable\fR starts the named printers or classes.
46 .LP
47 \fIcupsdisable\fR stops the named printers or classes. The
48 following options may be used:
49 .TP 5
50 -E
51 .br
52 Forces encryption of the connection to the server.
53 .TP 5
54 -U username
55 .br
56 Uses the specified username when connecting to the server.
57 .TP 5
58 -c
59 .br
60 Cancels all jobs on the named destination.
61 .TP 5
62 -h server[:port]
63 .br
64 Uses the specified server and port.
65 .TP 5
66 -r "reason"
67 .br
68 Sets the message associated with the stopped state. If no reason is specified
69 then the message is set to "Reason Unknown".
70 .SH COMPATIBILITY
71 Unlike the System V printing system, CUPS allows printer names to
72 contain any printable character except SPACE, TAB, "/", or "#".
73 Also, printer and class names are \fInot\fR case-sensitive.
74 .LP
75 The System V versions of these commands are \fIdisable\fR and
76 \fIenable\fR. They have been renamed to avoid conflicts with the
77 \fIbash(1)\fR build-in command of the same name.
78 .LP
79 The CUPS versions of \fIdisable\fR and \fIenable\fR may ask the
80 user for an access password depending on the printing system
81 configuration. This differs from the System V versions which
82 require the root user to execute these commands.
83 .SH SEE ALSO
84 \fIaccept(8)\fR, \fIcancel(1)\fR, \fIlp(1)\fR, \fIlpadmin(8)\fR,
85 \fIlpstat(1)\fR,
86 .br
87 http://localhost:631/help
88 .SH COPYRIGHT
89 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
90
91 .\"
92 .\" End of "$Id: cupsenable.man 5099 2006-02-13 02:46:10Z mike $".
93 .\"