README

                 LPRng - An Enhanced Printer Spooler
               Patrick Powell <papowell@lprng.com>

This is a modified version by other people than Patrick Powell,
though most of the code and documentation is from him, though
he is not involved in any of the changes since then.
				last updates 2007-01

The following is a guide to the documentation and LPRng files,
and the order you might want to read it in.  Files marked with +
should (must?) be read in order to succesfully install LPRng.

Patrick Powell

+ README          - this file (and please read all of it!)

+ INSTALL         - installation instructions

+ LPRng-Refernece.html, LPRng-Refernece.pdf,
   the LPRng Reference Manual available as extra package.

+ PrintingCookbook - a set of 'printing recipes' or setups and
     procedures that are commonly encountered.
     split out of the main LPRng and available as extra package.

OVERVIEW

The  LPRng  software  is an enhanced, extended, and portable
implementation of the Berkeley LPR print spooler functionality.
While providing the same interface and meeting RFC1179 requirements,
the implementation  is  completely new and provides support for
the  following  features:  lightweight  (no  databases needed) lpr,
lpc, and lprm programs; dynamic redirection  of  print queues;
automatic job holding; highly verbose  diagnostics; multiple printers
serving a single  queue;  client  programs  do not need to run SUID
root;  greatly enhanced security checks; and a greatly improved
permission and authorization mechanism.

The source software compiles and runs on a wide variety of UNIX
systems, and is compatible with other print spoolers and network
printers that use the LPR interface and meet RFC1179 requirements.

The package comes with filters for PostScript and HP printers, as
well as the usual 'dumb' printers.  Note that the PostScript and
HP filters do page counting and produce accounting information
accounting.  In addition, there are a wide variety of other filters
that can do page formatting, and produce banner pages.

For users that require compatibility with the SVR4 lp and lpstat
interface, lpr and lpq will simulate this interface, eliminating
the need for another print spooler package.  In addition,  a
publically available  PCNFSD server is distributed with LPRng, and
interfaces with the PC/DOS/Windows based NFS style print spoolers.

For users that require secure and/or authenticated printing support,
LPRng supports Kerberos V and/or SSL authentication methods.
Additional authentication support is extremely simple to add.

Finally, Astart Technlogies (http://www.astart.com) offers commercial
support for the LPRng software.

WHERE TO GET THE SOFTWARE:

The sourceforge project page for this software is:
   http://sourceforge.net/projects/lprng/

New versions will be available for download at:
   http://sourceforge.net/project/showfiles.php?group_id=34420&package_id=26541

The GIT repository can be browsed online at:
   http://lprng.git.sourceforge.net/git/gitweb.cgi?p=lprng/lprng;a=summary
and checked out via:
   git clone git://lprng.git.sourceforge.net/gitroot/lprng/lprng 

The LPRng developer mailinlist is
   lprng-devel@lists.sourceforge.net
and can be subscribed via:
   https://lists.sourceforge.net/lists/listinfo/lprng-devel

PLACES TO GET OLDER (UNMODIFIED) VERSIONS FROM:

Web Page and Refernce Manual in HTML format:
   http://www.lprng.com/LPRng.html
   and the Reference/ directory in the distribution

The software may be obtained from
   ftp://ftp.lprng.com/pub/LPRng  (Main site)

Mirrors:
    ftp://ftp.informatik.uni-hamburg.de/pub/os/unix/utils/LPRng  (DE)

DISTRIBUTION:

The LPRng software distribution has the following structure:

 README*     - various README files
 INSTALL      - Installation information

 configure, Makefile.in, ... - configuration and installation
     scripts.
 src/*        - source code
 ABOUT-NLS.LPRng - description of the GNU internationalization
 man/*        - man files for the major components.  I recommend
                reading lpd.8, printcap.5, and lpd.conf.5
 CHANGES      - change log
 TESTSUPPORT  - a mini lpr setup that can run as user
 UTILS/*      - set of utilities used during developement and for management