Skip to content

Commit

Permalink
Import cups.org releases
Browse files Browse the repository at this point in the history
git-svn-id: svn+ssh://src.apple.com/svn/cups/cups.org/tags/release-1.1.20rc6@4306 a1ca3aef-8c08-0410-bb20-df032aa958be
  • Loading branch information
msweet committed May 10, 2013
0 parents commit 1810112
Show file tree
Hide file tree
Showing 916 changed files with 497,526 additions and 0 deletions.
33 changes: 33 additions & 0 deletions .cvsignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
config.cache
config.h
config.log
config.status
configure
cups-config
cups.list
cups.sh
make.log
printpro.common
printpro.version
Makedefs
aix-4.3-powerpc
darwin-5.2-powerpc
darwin-5.3-powerpc
darwin-6.0-powerpc
freebsd-4.5-intel
hpux-10.20-hppa
hpux-11.00-hppa
irix-5.3-mips
irix-6.5-mips
linux-2.0-intel
linux-2.2-intel
linux-2.4-intel
solaris-2.5-intel
solaris-2.5-sparc
solaris-2.7-intel
solaris-2.7-sparc
solaris-2.8-intel
solaris-2.8-sparc
solaris-2.9-intel
solaris-2.9-sparc
tru64-4.0-alpha
81 changes: 81 additions & 0 deletions CGI.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
CGI - CUPS v1.1.19 - 05/27/2003
-------------------------------

This file describes the experimental scripting/CGI support
provided by CUPS starting with CUPS 1.1.19.

WARNING: CGI support is not complete; you may run into problems
and limitations in the implementation of CGI in CUPS that are
not present in full-featured web servers like Apache.


OVERVIEW OF CGI SUPPORT IN CUPS

CUPS has traditionally provided a dynamic web interface through
four CGI programs that are executed when users open special
directories on the CUPS server. Each CGI performs
administration, class, job, and printer functions as directed by
the user, but the actual programs that are run and functions
that are available are limited to those that were originally
designed into the scheduler.

Starting with CUPS 1.1.19, support is now available for CGI
programs and specific scripting languages, currently Java, Perl,
PHP, and Python. The interpreters for these languages are
currently configured at compile time. Future versions may
expand the interface to allow for generic support of scripting
languages similar to the Apache "AddHandler" directive, but with
external programs instead of modules.

The following MIME types are reserved for the CGI support in
CUPS (the names have been chosen to mirror those used by
Apache):

application/x-http-cgi CGI script/program
application/x-http-java Java program
application/x-http-perl Perl script
application/x-http-php PHP script
application/x-http-python Python script

In order to enable the corresponding type, you must create a new
/etc/cups/cgi.types file which maps the filename extensions to
the appropriate MIME type, for example:

application/x-http-cgi cgi
application/x-http-php php

CGI scripts/programs (application/x-http-cgi) also must have
execution permissions to be treated as a CGI script or program.


LIMITATIONS

CUPS implements most of the CGI/1.1 specification, with the
following limitations:

- No Location: redirection support.
- No PATH_INFO or PATH_TRANSLATED support.
- Limited HTTP field support; only the Content-Length
(CONTENT_LENGTH), Cookie (HTTP_COOKIE), and User-Agent
(HTTP_USER_AGENT) fields are placed in environment
variables at this time.


REPORTING PROBLEMS

If you have problems, READ THE DOCUMENTATION FIRST! If the
documentation does not solve your 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. The "/var/log/cups/error_log" file should also be sent,
as it often helps to determine the cause of your problem.

If you are running a version of Linux, be sure to provide the
Linux distribution you have, too.

Please note that the "cups-support@cups.org" email address goes
to the CUPS developers; they are busy people, so your email may
go unanswered for days or weeks. In general, only general build
or distribution problems will actually get answered - for
end-user support see the "README.txt" for a summary of the
resources available.
Loading

0 comments on commit 1810112

Please sign in to comment.