MIT Information Systems

Macintosh Development

[Home] [About Us] [People] [Information Systems]
[Kerberos for Macintosh] [Applications] [Miscellaneous Documentation]

KLPR 2.1.3

Introduction
System Requirements
Getting KLPR
Changes in KLPR
Using KLPR

Setting Up a New Printer
Printing a File
Viewing the Print Queue
Deleting Jobs from the Print Queue
Uninstalling a Printer
Known Bugs and Issues

Introduction

KLPR is a Macintosh printing plug-in which provides seamless access to Athena printers and other printers served by LPR or LPRng servers. KLPR performs Kerberos v5 and v4 authentication using MIT Kerberos for Macintosh 3.5 or later.

System Requirements

A PowerPC based Macintosh running Mac OS 8.5 or later. (Limited functionality under Classic in Mac OS X, see Known Bugs and Issues for more info. No native Mac OS X version is available.)

MIT Kerberos for Macintosh 3.5 or later.

QuickDraw GX must not be installed.

Getting KLPR

You can download the latest version of KLPR from MIT Macintosh Software Downloads.

Changes since KLPR 2.1.1:

Using KLPR

Setting Up a New Printer

  1. Launch KLPR Queue Manager.

  2. Select Add New Printer... from the Printers menu. The following dialog will appear:

    If the printer is an Athena printer or the printer's name can be obtained through Hesiod, just enter the name.

    If your printer is not an Athena or Hesiod printer, obtain the printer name, print server name and the type of authentication used by your print server from your local system administrator. Uncheck Use Hesiod and enter the printer information into the dialog, which now looks like this:

    In general, you always want Create Desktop Printer to be checked. If you do not create a desktop printer, you will only be able to print PostScript files directly from KLPR Queue Manager. If you uncheck Create Desktop Printer and later decide you want one, just launch KLPR Queue Manager and select List Jobs in Queue under your printer in the Printers menu.

    Now click Add. If Create Desktop Printer was checked, a printer icon with the printer's name on it will appear on your desktop.

  3. If you want to use special features of the printer (such as output bin selection), download a printer description file (PPD) for the printer.

    For instance, if the printer is an HP printer, go to HP's web site and download the HP driver software for the Macintosh. When you launch the installer, select a Custom Install and install only the printer description files for HP printers.

    Select the printer's icon on the desktop and choose Change Setup... from the Printing menu. A dialog like this will appear:

    Select Change... and choose the printer description file for your printer. Then click OK.

    NOTE: Do not click the Auto Setup button! This will cause your machine to crash or hang. Sorry.

Printing a File

Printing a file to a KLPR printer is the same as printing a file to any Macintosh printer. Select Print... in the File menu, and use the pull-down menu to select your printer:

Click Print and your document will be sent to the print server to be printed.

Viewing the Print Queue

If your document is taking a long time to print, you may want to check on the progress of the print job. You can do this by launching KLPR Queue Manager and selecting List Jobs in Queue under your printer in the Printers menu. This will produce a dialog like this:

Deleting Jobs from the Print Queue

  1. Find the job number for your job by listing the jobs in the queue as described above. The job number is the number in the "Job" column.

  2. Select Cancel Job... under your printer in the Printers menu. The following dialog will appear:

    Enter the job number and click OK. Your job will be removed.

    You can also delete all the jobs you have access to delete by selecting Cancel All Jobs under your printer in the Printers menu. However, on unauthentic printers, you may have access to delete other users' jobs.

Uninstalling a Printer

  1. Drag the desktop printer icon for your printer into the trash. If you unchecked Create Desktop Printer in KLPR Queue Manager when you created the printer, skip this step.

  2. Launch KLPR Queue Manager and select Forget About This Printer under your printer in the Printers menu.

Known Bugs and Issues

The following limitations apply when using KLPR under Classic mode in Mac OS X:

However, you can print postscript files and check the status of print queues succesfully under Classic.

If you receive an error "Can't spawn spool thread [-108]" when you try to print using a Kerberized printer, you should try increasing the memory partition for the printer by choosing "Get Info" on the printer in the Finder. Try increasing the memory to 700 K.

KLPR will not work if your Macintosh is behind a NAT (such as an Airport card set to distribute DHCP addresses).

In the Macintosh "Print" dialog, regardless of whether you ask for a cover page before or after the document, the cover page always prints first.

The filename on Athena header pages is always klpr.ps. Turn on cover pages in the "Print" dialog if you need the actual file name on your header page.

Clicking the "Auto Setup" button from the "Change Setup..." dialog hangs or crashes the machine.

Buffer sizes are arbitrarily chosen to not cause the spooler to run out of memory, and no reasonable out-of-memory action is taken.

When cancelling a job which is currently being printed from the Desktop printer, you may get a dialog that says "KLPR: Internal KLPR error --- Negative transfer size (0)." This dialog can be safely ignored.

Infrequently, KLPR printers may get into a state where the desktop printer refuses to print jobs (the jobs sit in the queue). When this happens, you may need to throw out the desktop printer and create a new one.

While a job is listed in the desktop printer's job list, choosing "List of Jobs in Queue" with KLPR Queue Manager causes the job to fail to print.

Questions or comments? Send mail to macdev@mit.edu
Last updated on $Date: 2003/11/18 21:59:42 $
Last modified by $Author: smcguire $