File: README.txt

package info (click to toggle)
cupsys 1.0.4-12
  • links: PTS
  • area: main
  • in suites: potato
  • size: 9,988 kB
  • ctags: 12,841
  • sloc: ansic: 110,263; makefile: 684; sh: 222; lisp: 60
file content (200 lines) | stat: -rw-r--r-- 6,760 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
README - CUPS v1.0.4 - 12/30/1999
---------------------------------

INTRODUCTION

The Common UNIX Printing System provides a portable printing layer for
UNIX operating systems.  It has been developed by Easy Software
Products to promote a standard printing solution for all UNIX vendors
and users.  CUPS provides the System V and Berkeley command-line
interfaces.

CUPS uses the Internet Printing Protocol (IETF-IPP) as the basis for
managing print jobs and queues.  The Line Printer Daemon (LPD, RFC1179)
and AppSocket protocols are also supported with reduced functionality.

CUPS adds network printer browsing and PostScript Printer Description
("PPD")-based printing options to support real world applications under
UNIX.

CUPS also includes a customized version of GNU GhostScript (currently
based off GNU GhostScript 4.03) and an image file RIP that can be used
to support non-PostScript printers.

CUPS is Copyright 1993-1999 by Easy Software Products, All Rights
Reserved.  CUPS is currently licensed under the terms of the GNU
General Public License.  Please see the license file for details.


SYSTEM REQUIREMENTS

Binary distributions require a minimum of 10MB of free disk space. We
do not recommend using CUPS on a workstation with less than 32MB of RAM
or a PC with less than 16MB of RAM.

If you are installing from source you'll need an ANSI C compiler and
optionally one or more image file support libraries.  Complete source
installation instructions can be found in the CUPS System
Administrator's Manual in the files "doc/sam.html" or "doc/sam.pdf".


SOFTWARE REQUIREMENTS

The following operating system software is required to install one of
the binary distributions from Easy Software Products:

    - Digital UNIX (aka OSF1 aka Compaq Tru64 UNIX) 4.0 or higher
    - HP-UX 10.20 or higher
    - IRIX 5.3 or higher
    - Linux 2.0 with glibc2 or higher
    - Solaris 2.5 or higher (SPARC or Intel)


INSTALLING CUPS

We are currently distributing CUPS binary distributions in TAR format
with installation and removal scripts generated by our ESP Package
Manager (EPM) software, which is available from:

    http://www.easysw.com/epm

WARNING: Installing CUPS will overwrite your existing printing system.
Backup files are made by the installation script and restored by the
removal script, so if you experience problems you should be able to
remove the CUPS software to restore your previous configuration. 
However, Easy Software Products makes no warranty for this and will not
be liable for any lost revenues, etc.

To install the CUPS software you will need to be logged in as root
(doing an "su" is good enough).  Once you are the root user, run the
installation script with:

    ./cups.install ENTER

After asking you a few yes/no questions the CUPS software will be
installed and the scheduler will be started automatically.


READING THE DOCUMENTATION

Once you have installed the software you can access the documentation
(and a bunch of other stuff) on-line at:

    http://localhost:631

If you're having trouble getting that far, the documentation is located
in the "/usr/share/cups/doc" directory in the binary distributions, and
under the "doc" directory in the source archives.

Please read the documentation before asking questions.


SETTING UP PRINTER QUEUES

CUPS works best with PPD (PostScript Printer Description) files.  In a
pinch you can also use System V style printer interface scripts.

Two sample PPD files are provided with this distribution that utilize
the PostScript and image file RIPs and the sample HP printer driver. 
To add the sample DeskJet driver to the system for a printer connected
to the parallel port, use one of the following commands:

    Digital UNIX:

        /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/lp0 -E

    HP-UX:

        /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/c2t0d0_lp -E

    IRIX:

        /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/plp -E

    Linux:

        /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/par0 -E
        /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/par1 -E
        /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/par2 -E

    Solaris:

        /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/bpp0 -E
        /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/ecpp0 -E

Similarly, for the sample LaserJet driver you can use "LaserJet" and
"laserjet.ppd".

For other printers and interfaces see the CUPS System Administator's
Manual included with this software.

If you're interested in a complete, commercial printing solution for
UNIX, check out our ESP Print Pro software at:

    http://www.easysw.com/printpro


PRINTING FILES

CUPS provides both the System V "lp" and Berkeley "lpr" commands for
printing:

    lp filename
    lpr filename

Both the "lp" and "lpr" commands support printing options for the
driver:

    lp -omedia=A4 -oresolution=600dpi filename
    lpr -omedia=A4 -oresolution=600dpi filename

CUPS recognizes many types of images files as well as PostScript, HP-GL/2,
and text files, so you can print those files directly rather than through
an application.

If you have an application that generates output specifically for your
printer then you need to use the "-oraw" or "-l" options:

    lp -oraw filename
    lpr -l filename

This will prevent the filters from misinterpreting your print file.


REPORTING PROBLEMS

If you have problems, please send an email to cups-support@cups.org. 
Include your operating system and version, compiler and version, and
any errors or problems you've run into.  If you are running a version
of Linux, be sure to provide the Linux distribution you have, too.


OTHER RESOURCES

See the CUPS web site at "http://www.cups.org" for other site links.

You can subscribe to the CUPS mailing list by sending a message
containing "subscribe cups" to majordomo@cups.org.  This list is
provided to discuss problems, questions, and improvements to the CUPS
software.  New releases of CUPS are announced to this list as well.


LEGAL STUFF

CUPS is Copyright 1993-1999 by Easy Software Products.  CUPS, the CUPS
logo, and the Common UNIX Printing System are the trademark property of
Easy Software Products.

CUPS is provided under the terms of the GNU General Public License
which is located in the files "LICENSE.html" and "LICENSE.txt" (or the
file "cups.license" for a binary distribution.)  For commercial
licensing information, please contact:

    Attn: CUPS Licensing Information
    Easy Software Products
    44141 Airport View Drive, Suite 204
    Hollywood, Maryland 20636-3111 USA

    Voice: +1.301.373.9603
    Email: cups-info@cups.org
    WWW: http://www.cups.org