DIGITAL PLAIN PAPER COPIER OPERATOR'S MANUAL FOR PRINTER FUNCTION NETWORK PRINTER BOARD GA-1040 USER'S GUIDE FOR UNIX FILTER
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver FCC/IC NOTICE This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Trademarks EFI, Fiery, the Fiery logo, Fiery Driven and RIP-While-Print are registered trademarks of Electronics For Imaging, Inc. in the U.S. Patent and Trademark Office and/or certain other foreign jurisdictions.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver SOFTWARE LICENSE AGREEMENT YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE USING THIS SOFTWARE. IF YOU DO NOT AGREE TO THE TERMS AND CONDITIONS OF THIS AGREEMENT, DO NOT USE THE SOFTWARE. INSTALLING OR USING THE SOFTWARE INDICATES THAT YOU AGREE TO AND ACCEPT THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO ACCEPT THE TERMS OF THIS AGREEMENT YOU MAY RETURN THE UNUSED SOFTWARE FOR A FULL REFUND TO THE PLACE OF PURCHASE.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver PROPRIETARY RIGHTS You acknowledge that the Software, Coded Font Programs, Typefaces, and Trademarks are proprietary to Electronics For Imaging and its suppliers and that title and other intellectual property rights therein remain with Electronics For Imaging and its suppliers.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver LIMITATION OF LIABILITY IN NO EVENT WILL ELECTRONICS FOR IMAGING OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES, INCLUDING LOSS OF DATA, LOST PROFITS, COST OF COVER OR OTHER SPECIAL, INCIDENTAL, CONSEQUENTIAL OR INDIRECT DAMAGES ARISING FROM THE USE OF THE SOFTWARE, OR CODED FONT PROGRAMS, HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver TABLE OF CONTENTS Introduction .................................................................................................................................... 1 GUIDELINES ................................................................................................................................................. 1 Pre-installation .............................................................................................................................
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver PPD Options......................................................................................................................................... 35 PRINTING ................................................................................................................................................... 35 Methods of Printing ..............................................................................................................................
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Introduction This manual describes how to install the user software for the TOSHIBA GA-1040 Network Printer Board, set up printing, and manage print jobs from a Unix client. For information about setting up network servers and clients to use the GA-1040, see Administrator’s Guide. For general information on using the copier, your computer, your application software, or your network, see the manuals that accompany those products.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Pre-installation System Requirements English versions of the following operating systems are supported for use with the GA-1040 Printer Driver: • • • • • Sun Solaris 2.4 or later (SPARCstation) Sun Solaris 8 (Intel) HP-UX 10.0 or later IBM AIX 4.0 or later Red Hat Linux 6.0 or later The following system programs are needed for successful installation.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Motif 1.2 System Requirement Details HP-UX Motif 1.2 libraries: libXm Needed to be installed in target system. Solaris Motif 1.2 libraries: libXm Needed to be installed in target system. AIX Motif 1.2 libraries: libXm Needed to be installed in target system. Linux None No library is needed. Motif 2.1 libraries are linked statically. To determine which version of Motif is installed in your Unix or Linux system, do the following system checks.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver The driver cannot be installed on systems that have write-protection turned on for the /usr/local folder. The driver installation destination directory is fixed for each platform to the location specified in the table above. This is currently not configurable as there is no concept of registry in Unix systems where settings can be saved at installation time and that could be retrieved later by the driver at run-time.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Linux Additional Files Description shfilter.scr Middle script filter for Linux server installations used to parse parameters received from lp and passed to the CORE filter. The Linux installer assumes that the Korn shell exists in /bin. If Korn (ksh) does not exist in /bin, the /usr/local/tsbprn-ps/shfilter-ps.tos file must be modified to the existing shell in /bin. If Borne Again (bash) shell is available, edit the first line in shfilter-ps.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver setup Installation Program Depending on your network environment, distribution of clients, and planned print configuration, you may run only server installations of the Unix driver, or both client and server installations. Pre-Installation Procedures Before running server or client install program, review the following points: • Log in as the superuser (root) of the system to ensure that all files are installed to their correct location.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver system errors when launching the setup installation program directly on systems without Motif support. The install installation script will show an error message if it cannot find the Motif library in the system, except for Linux, where the driver is built to run even on systems without Motif support. If you are sure that you have Motif installed in the system, you can use the setup installation program directly.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver -h -u [q:] s: p: t: g: cdepth: Prints the usage guide. If no other parameter is specified, the program will terminate. Otherwise, it will launch the installation program either in graphical or text mode, depending on value of the “g” parameter. Uninstalls the specified The name of the local print queue to be set up or uninstalled. q: is optional.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver ./install –u t:all g:no runs the setup installation program in un-install and text mode to uninstall all print queues. ./install pshakuba s:hakuba p:direct cdepth:8 Runs in GUI mode and initialize the print queue, destination printer and port fields in the user interface. If Background color setting is removed from the Setup resource file, this will use the 8-bit color depth parameter to choose the background color for the user interface.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver GUI Mode The following buttons allows user to interactively control the installation and uninstallation process. • Install button This button starts the installation process. This button is disabled until all required fields are filled in. • Delete button This button deletes selected print queue in the list of installed print queues. If there is no print queue available, this button is disabled.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Introduction Tab The Introduction tab shows information about the setup installation program. Figure 1 Introduction tab General Tab Figure 2 General Tab (Server Install) • • • Figure 3 General Tab (Client Install) Print Queue o This is the name of the print queue to be created and associated with the Unix filter. Install Type o The print queue can be a server (default) or client print queue.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver • • • • • Printer Port/Remote Queue o On server install type, Printer Port is the Fiery printer port on the remote printer device. o On client install type, Remote Queue is the server-type print queue on the UNIX/Linux Network Server. o This is print, by default. Remote Server OS o Shown on client type installation, this specifies the type of operating system in the remote Network Server.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver • • • • • • system requires the scripts to be in a different location, specify the new location in this field. Middle script/Client script o This is for Linux installations only: This is the name to give the actual script installed on the system. By default, this is shfilter-ps.tos for server install type, and is shfilter.clnt for client install type. o For server installation type, the label is Middle script.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Status Dialog The Status dialog shows messages describing the progress of the installation process. The Done button closes the dialog after a successful installation or after an error occurs during installation. It is disabled during the install process. If a fatal error occurs, the setup installation program terminates. Figure 5 Status dialog Help Dialog The help button shows the help dialog, which describes the setup installation program.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver The program will also prompt for other settings such as manpage path, middle script name, temporary files location, or UI Link path. Follow screen prompts to specify non-default settings. Whenever a yes/no type question is asked, the upper-case letter identifies the default response. For example, y/N, N is the default. You can just press the Return (or Enter) key to use the default setting.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver shown when the man command is used. If a manpage has no entry in the windex file, the said manpage may not be displayed using the man command. If windex exists in the main manpage directory, an entry for the manpage must be added into it. If it does not exist in the main manpage directory, all manpages within the subdirectories will be available to the man command.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver rcutil Property Tabs The GA-1040 Printer Driver rcutil configuration program consists of four property tabs: Setup, Personality, Options, and About tabs. Setup Tab This tab contains the standard printer settings: paper size, paper source, destination tray, media type, orientation, duplex, and number of copies. Figure 7 Setup Tab Paper Size The list of available paper sizes will be determined from the PPD associated with the driver.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Paper Source The list of available input paper trays will be determined from the PPD associated with the driver. The user can select any one of the available trays.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Orientation The user can select Portrait, Landscape, Reverse Portrait, or Reverse Landscape.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Duplex The user can select the output job to be Single (single-sided), Long (two-sided with long edge) binding, or Short (two-sided with short edge binding). Keyword Name duplex Translation/Display Text Duplex Option Name single long short Translation/Display Text None Long Edge Binding Short Edge Binding Long Edge Binding The pages are bound on the long side, regardless of orientation.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Number of Copies The user can specify 1-999 copies. Keyword Name copies Translation/Display Text Number of Copies Type Integer Range 1 – 999 Additional PPD-specified Property Tabs The Personality and Options tabs are examples of PPD-specified property tabs. The settings in PPD tabs are detected from the PPD configuration file associated with the driver during installation.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Finishing The user can specify to turn on collation and stapling.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Options Tab Figure 17 Options tab Pedestal Option This setting provides the choices for the installed pedestal devices. Keyword Name pedestaloption Translation/Display Text Pedestal Option Option Name none pedestal1 pedestal2 lcf Translation/Display Text Not Installed Pedestal 1 Pedestal 2 Large Capacity Feeder Finisher Option This setting provides the choices for the installed finishing devices.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Punch Unit This setting provides the choices for the installed punch unit devices. Keyword Name punchunit Translation/Display Text Punch Unit Option Name none 2hole 3hole 4holef 4holes Translation/Display Text Not Installed 2 Hole Punch Unit 2/3 Hole Punch Unit 4 Hole Punch Unit (F) 4 Hole Punch Unit (S) About Tab The About tab displays the product name, version, copyright and patents information.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Help Dialog The Help dialog provides a description of the GA-1040 Printer Driver, including the features enabled in the driver. Figure 19 Help dialog The F533Readme.txt file that is shipped with the driver contains the text displayed in the Help dialog. The said file can be edited for further customization. The Help dialog also displays the list of keywords and options supported in the driver.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Localization The buttons and settings fields in the user interface can be renamed by editing the Rcutil resource file. This file is found in /usr/lib/X11/app-defaults, except in Solaris where it is found in /usr/openwin/lib/X11/app-defaults.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Using rcutil Running rcutil To launch the GUI setup program, run /opt/rcutil on the command line. $ /opt/rcutil Note: • The rcutil configuration program uses the same PPD configuration file as the CORE UNIX filter. It parses the PPD configuration file to display the settings in the GUI. If it cannot find the PPD configuration file, it will abort and the GUI will not display. Please coordinate with your System Administrator if you have this situation.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver # System-Default Profile for rcutil # #-Number of characters per line is expected to be less than 256. #-variables have to be in uppercase, values to be lowercase. # PageSize = Ledger Destination = Inner Orientation = Reverse Portrait Duplex = Long Finishing = StapleUL Punch = Left If this file exists in the user’s home directory, it is parsed and the values are reflected in the rcutil GUI controls or widgets.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver required to be turned on. This would allow the lp system account to have access to the settings file stored in the user’s home directory. If you’re having a problem printing in your system, check if the user’s home directory satisfies the condition described above. Use ls –l /home if the user’s home directory has executable access. If not, you can turn it on using “chmod o+x /home/userdirectory”.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Constraints As settings are changed, the program checks if the selection violates some constraints specified in the PPD configuration file. The constraints are rules that tell when an option is valid when combined with other options. For example, Punch holes cannot be done if there is no puncher. An A3 paper size may not be allowed to come from Tray 3. Duplex may not be allowed on Transparency paper. These are only examples.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Illustrated Process and Data Flow GUI Process rcutil (GUI) program is invoked by user PPD Read defaults from PPD. .f533rc Read settings from .f533rc • When Save settings button is clicked on, the non-default settings are saved back to the settings file. .f533rc is a custom default setting for each user. • The Exit button causes the rcutil to terminate.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Unix CORE Driver Process Unix CORE driver is invoked by lp command. PPD Read defaults from PPD. .f533rc Read settings from .f533rc Command line parameters Parse command line Apply features and generate output file.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Printer Driver Details This section describes in detail the features available in the GA-1040 Printer Driver.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Feature Duplex Keyword:Option duplex: single long short Relay relay: on off Options list options: on off language: postscript Language selection Non-native form simplex duplex, double, vd, d hduplex, hd relay options, optionson optionsoff post, postscript Text mode text: on off text, texton, ascii textoff Pesc mode pesc: on off pesc, pescon pescoff User’s Guide Description For simplex, print single sided
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver PPD Options Feature Rotate 180 Degrees Finishing Hole Punch Smoothing Pedestal Option Finisher Option Punch Unit Keyword:Option userrotate180: 0 1 finishing: none sort group alternation stapleul stapleur staplel2 staplet2 saddle punch: none left top refine: off type1 pedestaloption: none pedestal1 pedestal2 lcf finisher: false hangingfinisher finisher saddle punchunit: none 2hole 3hole 4holef 4holes Non-nati
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver The option can be in the non-native or native format. Native format means keyword:option while non-native means keywordoption. Some options can be specified as just option, for example, A4 or duplex. Methods of Printing Through rcutil • • • • • Run rcutil Make changes in the settings in the GUI Save settings (.f533rc will be updated in the user’s home directory). Exit rcutil Use lp command to send the job: o lp –d printqueue filename.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Printing in Netscape Navigator Specify in the print command the print queue and the options that will be applied to the printout. Figure 24 Print to Printer Figure 25 Print to File Then click on Print button to start printing the file through pshakuba print queue. In Figure 23, the printout will be double-sided (long edge) and will use tabloid paper size.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Printing in Adobe Acrobat Reader Specify in the print command the print queue and the options that will be applied to the printout. Figure 26 Acrobat Reader print dialog If printing to file, as in the following figure: Figure 27 Printing to file specify the destination file in the File Name field, then click the Print button.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Messages The following tables show the messages that the installation program and the rcutil configuration program may generate, with the possible causes why the messages are shown. Installation Phase These messages are shown during installation phase. Error Messages Message Please install the Motif library. The is missing. FATAL ERROR: Cannot parse command line parameters due to lack of memory.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Message You must be ‘root’ (superuser) to install. ERROR: The default folder for manpage of does not exist. ERROR: Printer queue already exists. Possible Cause “superuser” access is needed to be able to install the printer driver. The manpage cannot be installed because the path for the manpage cannot be found or accessed. Print queue that is passed as parameter as print queue to be installed is already in the system.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Message Install User Interface configuration program? Y/n Default driver path: Change driver path? y/N Specify a driver path? y/N Specify name of driver path: Default CORE filter manpage path: Change CORE filter manpage path? y/N Specify CORE filter manpage path? y/N Specify CORE filter manpage path: Default configuration program manpage path: Change configuration program manpage path? y/N Specify configuration program manpage path? y/N Specify configuration
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Message Specify path for temporary files: OS of remote server to connect to 1 – Sun SunOS/Solaris 2 – HP UX 3 – IBM AIX 4 – Red Hat Linux Default: Choose: Enable three-digit request numbers? y/N Default client middle script: Change client middle script? y/N Specify client middle script? y/N Specify client middle script: Default middle script: Change middle script? y/N Specify middle script? y/N Specify middle script: Default pass-thru name: Use
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver Message To see supported CORE options, enter: man EFTPS To see GUI setup program manpage, enter: man rcutil Description configuration program manpage. Tells users on how to view the CORE filter manpage. Tells users on how to view the configuration program manpage. rcutil Configuration Program Figure 31 Constraint violation error message Figure 28 When no setting is saved Figure 30 When any setting is saved Figure 29 Error when .f533rc cannot be written on.
TOSHIBA e-STUDIO28/35/45 Unix Printer Driver CORE Driver A banner page is automatically printed if there’s an error in the print job. Figure 32 Banner page template The banner page contains the following header information.
1-1, KANDA NISHIKI-CHO, CHIYODA-KU, TOKYO, 101-8442, JAPAN © 2002 TOSHIBA TEC CORPORATION All rights reserved