README.MORGAN

   1 2000/03/04
   2
   3 This readme documents the changes I have made to papd to implement Apple's
   4 Print Server Security Protocol.  With these patches and appropriate
   5 configuration choices in papd.conf, a client machine will be required to
   6 authenticate to papd with a username or userame/password pair before papd
   7 will spool the print job to lpr.  This requires LaserWriter 8.6.1+ on the
   8 client Mac.  Papd will switch to the username provided by the client and
   9 print as that user.
  10
  11 Papd will now respond to the following Postscript queries:
  12 RBISpoolerID
  13 RBIUAMListQuery
  14 RBILogin
  15
  16 Currently, only uams_guest.so, uams_passwd.so, and uams_pam.so
  17 authentication modules are supported.
  18
  19 To enable authentication on a particular printer, add the "au" flag to
  20 that printer's entry in papd.conf.  To define which uams to use for
  21 authentication, use an "am" entry.  The uams defined apply globally, to
  22 all printers.  It is not currently possible to define different
  23 authentication methods for different printers.  Here is an example printer
  24 setup for papd.conf:
  25
  26 lp:\
  27         :pr=|/usr/bin/lpr -Plp:\
  28         :au:\
  29         :am=uams_guest.so,uams_clrtxt.so:\
  30         :pd=/usr/local/atalk/etc/ppds/hp8100.ppd:
  31
  32 Or see the example papd.conf.
  33
  34 This patch also includes the patches by Andras Kadinger to enable binary
  35 printing through papd.
  36
  37 I've only been able to test these changes on a limited number of client
  38 Macs and only on Linux.  If there are any problems or feedback you'd like
  39 to give, feel free to send me email.
  40
  41 Hopefully these patches will be incorporated into Adrian Sun's standard
  42 netatalk distributions, but until then you can find it at:
  43
  44 http://web.orst.edu/~morgan/netatalk/
  45
  46 Enjoy!
  47
  48 Andy Morgan <morgan@orst.edu>
  49