Toshiba 35, 28, 45 User Manual

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. This equipment generates, uses, and can
radiate radio frequency energy and, if not installed and used in accordance with the
instruction manual, may cause harmful interference to radio communications.
Operation of this equipment in a residential area is likely to cause harmful
interference in which case the user will be required to correct the interference at his
own expense.

This Class A digital apparatus complies with Canadian ICES-003.
Cet appareil numérique de la classe A est conformé à la norme NMB-003 du Canada.

WARNING:

Changes or modification made to this equipment, not expressly approved by Toshiba
Tec or parties authorized by Toshiba Tec could void the user’s authority to operate
the equipment.

For European models only:

WARNING:

This product complies with Class A for network connection. In a domestic
environment this product may cause radio interference in which case the user may
be required to take adequate measures.

1. Do not touch the connector terminal when disconnecting the cables of
peripheral equipment.

2. Before opening any covers or removing any units from the copier, discharge
the static electricity from your body by touching a metal part of the copier.

This product is carrying the CE-Mark in accordance with the related European
Directives. Responsible for CE-marking is TOSHIBA TEC GERMANY IMAGING
SYSTEMS GmbH, Carl-Schurz-Str. 7, 41460 Neuss, Germany.
e-mail: [e-mail]

The software described in this publication is furnished under license and may only be
used or copied in accordance with the terms of such license.

This product may be covered by one of more of the following U.S. Patents:
4,500,919, 4,837,722, 5,212,546, 5,343,311, 5,424,754, 5,467,446, 5,506,946,
5,517,334, 5,537,516, 5,543,940, 5,553,200, 5,615,314, 5,619,624, 5,625,712,
5,666,436, 5,760,913, 5,818,645, 5,835,788, 5,867,179, 5,959,867, 5,970,174,
5,982,937, 5,995,724, 6,002,795, 6,025,922, 6,041,200, 6,065,041, 6,112,665,
6,122,407, 6,134,018, 6,141,120, 6,166,821, 6,185,335, 6,201,614, 6,215,562,
6,219,659, 6,222,641, 6,224,048, 6,225,974, 6,226,419, 6,238,105, 6,239,895,
6,256,108, 6,269,190, 6,289,122, 6,292,270, 6,310,697, 6,327,047, 6,327,050,

User’s Guide i

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.

The Electronics For Imaging logo, the Fiery Driven logo, Command WorkStation,
DocBuilder, DocBuilder Pro, Fiery X3e, Fiery FreeForm, Fiery Scan, Fiery ScanBuilder,
Fiery WebInstaller, Fiery WebScan, Fiery WebSpooler, Fiery WebStatus, Fiery
WebTools, NetWise, Velocity, Velocity Balance, Velocity Build, Velocity Design,
Velocity Estimate, and Velocity Scan are trademarks of Electronics For Imaging, Inc.

All other terms and product names may be trademarks or registered trademarks of
their respective owners, and are hereby acknowledged.

Legal Notices

APPLE COMPUTER, INC. (“APPLE”) MAKES NO WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, REGARDING THE
APPLE SOFTWARE. APPLE DOES NOT WARRANT, GUARANTEE, OR MAKE ANY
REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF THE USE OF THE
APPLE SOFTWARE IN TERMS OF ITS CORRECTNESS, ACCURACY, RELIABILITY,
CURRENTNESS, OR OTHERWISE. THE ENTIRE RISK AS TO THE RESULTS AND
PERFORMANCE OF THE APPLE SOFTWARE IS ASSUMED BY YOU. THE EXCLUSION OF
IMPLIED WARRANTIES IS NOT PERMITTED BY SOME STATES. THE ABOVE
EXCLUSION MAY NOT APPLY TO YOU.

IN NO EVENT WILL APPLE, ITS DIRECTORS, OFFICERS, EMPLOYEES OR AGENTS BE
LIABLE TO YOU FOR ANY CONSEQUENTIAL, INCIDENTAL OR INDIRECT DAMAGES
(INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
INTERRUPTION, LOSS OF BUSINESS INFORMATION, AND THE LIKE) ARISING OUT
OF THE USE OR INABILITY TO USE THE APPLE SOFTWARE EVEN IF APPLE HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BECAUSE SOME STATES DO
NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL
OR INCIDENTAL DAMAGES, THE ABOVE LIMITATIONS MAY NOT APPLY TO YOU.

Apple’s liability to you for actual damages from any cause whatsoever, and
regardless of the form of the action (whether in contract, tort [including negligence],
product liability or otherwise), will be limited to $50.

Copyright © TOSHIBA TEC Corp. 2002 All Rights Reserved.

Under the copyright laws, this manual cannot be reproduced in any form without
prior written permission of TOSHIBA TEC. No patent liability is assumed, with respect
to the use of the information contained herein. No part of this manual may be copied
in whole or part without permission. The contents of this manual may change
without notification.

User’s Guide ii

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.

LICENSE

Electronics For Imaging, Inc. grants you a non-exclusive, non-transferable license to
use the software and accompanying documentation (“Software”) included with the
controller GA-1040 for TOSHIBA e-STUDIO28/35/45 Series printer you have
purchased, including without limitation PostScript® software provided by Adobe
Systems Incorporated.

You may:

a. use the Software solely for your own customary business purposes and solely

with the controller GA-1040 for TOSHIBA e-STUDIO28/35/45;

b. use the digitally-encoded machine-readable outline and bitmap programs

(“Font Programs”) provided with the controller GA-1040 for TOSHIBA e­STUDIO28/35/45 in a special encrypted format (“Coded Font Programs”) to
reproduce and display designs, styles, weights, and versions of letters,
numerals, characters and symbols (“Typefaces”) solely for your own
customary business purposes on a monitor used with the controller GA-1040
for TOSHIBA e-STUDIO28/35/45;

c. use the trademarks used by Electronics For Imaging to identify the Coded

Font Programs and Typefaces reproduced therefrom (“Trademarks”); and

d. assign your rights under this Agreement to a transferee of all of your right,

title and interest in and to the controller GA-1040 for TOSHIBA e­STUDIO28/35/45 provided the transferee agrees to be bound by all of the
terms and conditions of this Agreement.

You may not:

a. make use of the Software, directly or indirectly, to print bitmap images with

print resolutions of greater than 600 dots per inch, or to generate fonts or
typefaces for use other than with the controller GA-1040 for TOSHIBA e­STUDIO28/35/45;

b. make or have made, or permit to be made, any copies of the Software, Coded

Font Programs, accompanying documentation or portions thereof, except as
necessary for use with the controller GA-1040 for TOSHIBA e­STUDIO28/35/45 purchased by you; provided, however, that under no
circumstances may you make or have made, or permit to be made, any
copies of that certain portion of the Software which has been included on the
controller GA-1040 for TOSHIBA e-STUDIO28/35/45 hard disk drive or ROM.
You may not copy the documentation;

c. attempt to alter, disassemble, decrypt or reverse engineer the Software,

Coded Font Programs.

d. rent or lease the Software.

User’s Guide iii

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. Except as stated above, this Agreement does not grant you any right to
patents, copyrights, trade secrets, trademarks (whether registered or unregistered),
or any other rights, franchises or licenses in respect of the Software, Coded Font
Programs, Typefaces, or Trademarks. You may not adapt or use any trademark or
trade name which is likely to be similar to or confusing with that of Electronics For
Imaging or any of its suppliers or take any other action which impairs or reduces the
trademark rights of Electronics For Imaging or its suppliers. The trademarks may
only be used to identify printed output produced by the Coded Font Programs. At the
reasonable request of Electronics For Imaging, you must supply samples of any
Typeface identified with a trademark.

CONFIDENTIALITY

You agree to hold the Software and Coded Font Programs in confidence, disclosing
the Software and Coded Font Programs only to authorized users having a need to
use the Software and Coded Font Programs as permitted by this Agreement and to
take all reasonable precautions to prevent disclosure to other parties.

REMEDIES

Unauthorized use, copying or disclosure of the Software, Coded Font Programs,
Typefaces, or Trademarks will result in automatic termination of this license and will
make available to Electronics For Imaging other legal remedies.

LIMITED WARRANTY AND DISCLAIMER

Electronics For Imaging warrants that, for a period of ninety (90) days from the date
of delivery to you, the Software under normal use will perform without significant
errors that make it unusable. Electronics For Imaging’s entire liability and your
exclusive remedy under this warranty (which is subject to you returning the
controller GA-1040 for TOSHIBA e-STUDIO28/35/45 to Electronics For Imaging or an
authorized dealer) will be, at Electronics For Imaging’s option, to use reasonable
commercial efforts to attempt to correct or work around errors, to replace the
Software with functionally equivalent software, or to refund the purchase price and
terminate this Agreement. Some states/jurisdictions do not allow limitations on
duration of implied warranty, so the above limitation may not apply to you.

For warranty service, please contact your authorized service/support center.

EXCEPT FOR THE ABOVE EXPRESS LIMITED WARRANTY, ELECTRONICS FOR
IMAGING MAKES AND YOU RECEIVE NO WARRANTIES OR CONDITIONS ON THE
SOFTWARE OR CODED FONT PROGRAMS, EXPRESS, IMPLIED, STATUTORY, OR IN
ANY OTHER PROVISION OF THIS AGREEMENT OR COMMUNICATION WITH YOU, AND
ELECTRONICS FOR IMAGING SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OR
CONDITION OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Electronics For Imaging does not warrant that the operation of the software will be
uninterrupted or error free or that the Software will meet your specific requirements.

User’s Guide iv

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. THIS LIMITATION WILL APPLY EVEN IF
ELECTRONICS FOR IMAGING OR ANY AUTHORIZED DEALER HAS BEEN ADVISED OF
THE POSSIBILITY OF SUCH DAMAGE. YOU ACKNOWLEDGE THAT THE PRICE OF THE
CONTROLLER GA-1040 FOR TOSHIBA e-STUDIO28/35/45 REFLECTS THIS
ALLOCATION OF RISK. BECAUSE SOME STATES/JURISDICTIONS DO NOT ALLOW
THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR
INCIDENTAL DAMAGES, THE ABOVE LIMITATION MAY NOT APPLY TO YOU.

EXPORT CONTROLS

You agree that you will not export or re-export the Software or Coded Font Programs
in any form without the appropriate United States and foreign government licenses.
Your failure to comply with this provision is a material breach of this Agreement.

GOVERNMENT USE

Use, duplication or disclosure of the Software by the United States Government is
subject to restrictions as set forth in subdivision (c) (1) (ii) of the Rights in Technical
Data and Computer Software clause at DFARS 252.227-7013 or in subparagraphs (c)
(1) and (2) of the Commercial Computer Software-Restricted Right Clause at 48 CFR

52.227-19, as applicable.

THIRD PARTY BENEFICIARY

You are hereby notified that Adobe Systems Incorporated, a California corporation
located at 345 Park Avenue, San Jose, CA 95110-2704 (“Adobe”) is a third-party
beneficiary to this Agreement to the extent that this Agreement contains provisions
that relate to your use of the Fonts, the Coded Font Programs, the Typefaces and the
Trademarks licensed hereby. Such provisions are made expressly for the benefit of
Adobe and are enforceable by Adobe in addition to Electronics for Imaging.

GENERAL

This Agreement is governed by the laws of the State of California. This Agreement is
the entire agreement held between us and supersedes any other communications or
advertising with respect to the Software and Coded Font Programs. If any provision
of this Agreement is held invalid, the remainder of this Agreement shall continue in
full force and effect.

If you have any questions concerning this Agreement, please see Electronics For
Imaging’s web site at www.efi.com.

Electronics For Imaging
303 Velocity Way
Foster City, CA 94404

User’s Guide v

TOSHIBA e-STUDIO28/35/45 Unix Printer Driver

TABLE OF CONTENTS

Introduction .................................................................................................................................... 1

GUIDELINES................................................................................................................................................. 1

Pre-installation ............................................................................................................................... 2

SYSTEM REQUIREMENTS ............................................................................................................................. 2

MOTIF SUPPORT .......................................................................................................................................... 2

Motif 2.1.................................................................................................................................................. 2

Motif 1.2.................................................................................................................................................. 3

Obtaining the Installation Package ........................................................................................................ 3

INSTALLED FILES......................................................................................................................................... 3

setup Installation Program............................................................................................................6

PRE-INSTALLATION PROCEDURES ............................................................................................................... 6

INSTALL INSTALLATION SCRIPT .................................................................................................................... 6

SYNTAX ....................................................................................................................................................... 7

Notes on X_QueryColors........................................................................................................................ 9

GUI MODE ................................................................................................................................................10

Setup resource file ................................................................................................................................ 10

Introduction Tab ................................................................................................................................... 11

General Tab .......................................................................................................................................... 11

Advanced Tab .......................................................................................................................................12

Printer List............................................................................................................................................ 13

Printer Status........................................................................................................................................ 13

Status Dialog ........................................................................................................................................ 14

Help Dialog .......................................................................................................................................... 14

TEXT MODE............................................................................................................................................... 14

Installation mode .................................................................................................................................. 14

Uninstallation mode.............................................................................................................................. 15

POST INSTALLATION PROCEDURES ............................................................................................................ 15

Platform Specific Checks ...................................................................................................................... 15

rcutil Property Tabs ..................................................................................................................... 17

SETUP TAB ................................................................................................................................................ 17

Paper Size ............................................................................................................................................. 17

Paper Source ........................................................................................................................................18

Destination............................................................................................................................................ 18

Media Type ...........................................................................................................................................18

Orientation............................................................................................................................................ 19

Number of Copies ................................................................................................................................. 21

ADDITIONAL PPD-SPECIFIED PROPERTY TABS ..........................................................................................21

Personality Tab..................................................................................................................................... 21

Options Tab .......................................................................................................................................... 23

ABOUT TAB ...............................................................................................................................................24

MAIN CONTROLS .......................................................................................................................................24

HELP DIALOG ............................................................................................................................................ 25

LOCALIZATION .......................................................................................................................................... 26

Using rcutil ................................................................................................................................... 27

RUNNING RCUTIL ....................................................................................................................................... 27

SETTINGS FILE ...........................................................................................................................................27

User Home Directory Access Restrictions............................................................................................ 28

CONSTRAINTS ............................................................................................................................................ 30

SAVING SETTINGS...................................................................................................................................... 30

ILLUSTRATED PROCESS AND DATA FLOW ................................................................................................. 31

GUI Process.......................................................................................................................................... 31

Unix CORE Driver Process.................................................................................................................. 32

PRINTER DRIVER DETAILS......................................................................................................................... 33

Standard Options.................................................................................................................................. 33

User’s Guide vi

TOSHIBA e-STUDIO28/35/45 Unix Printer Driver

PPD Options......................................................................................................................................... 35

PRINTING................................................................................................................................................... 35

Methods of Printing ..............................................................................................................................36

Printing from Unix applications ........................................................................................................... 36

Messages ...................................................................................................................................... 39

INSTALLATION PHASE................................................................................................................................39

Error Messages..................................................................................................................................... 39

Status and Prompt Messages ................................................................................................................40

RCUTIL CONFIGURATION PROGRAM .......................................................................................................... 43

CORE DRIVER .......................................................................................................................................... 44

User’s Guide vii

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.

The GA-1040 Printer Driver consists of a Unix filter (CORE) driver and the rcutil
configuration program:

• The CORE driver translates print commands and drives printing on UNIX and
Linux platforms.

• The rcutil configuration program provides a visual interface to the driver,
for graphical access to print properties specified in the PostScript Printer

Description (PPD) file.

It also comes with the install installation script that is used to install and un-install
print queues. The install installation script first checks the system for Motif support
before running the setup installation program.

This manual contains information on:

• Pre-installation and system requirements

• Installation and un-installation process

• rcutil Property tabs

• Using the rcutil configuration program to save print settings

• Print command reference

• Printing from the command line and from applications

• Error and status messages

Guidelines

This manual uses the following rules for the use of symbols and font style in this
document.

bold Verana font – means a title or an important concept

bold

Solaris “Solaris”, from here on, refers to both SunOS and Solaris.

User’s Guide 1

Courier New font – means a program name, program variable, a

directory or path name, or a constant value,

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.

UNIX/LINUX System System Tools

HP-UX /usr/bin/nslookup

/usr/sbin/lpshut
/usr/sbin/lpsched

Sun Solaris

(SPARC/Intel)

IBM AIX /usr/bin/host

Red Hat Linux /usr/bin/host

* If the utility is not in the specified path, the named utility must be found in
the system search path and can be run on the command line.

/usr/sbin/nslookup
/usr/lib/lpshut
/usr/lib/lpsched
/usr/bin/lpstat

/usr/sbin/piomisc_base
/usr/bin/lpstat

/usr/lib/lpadmin
/usr/bin/enable
/usr/lib/accept
/usr/lib/lpadmin
/usr/bin/enable
/usr/lib/accept

/usr/bin/enable
mkque
mkquedev
/etc/rc.d/init.d/lpd or
/etc/init.d/lpd

Motif Support

The rcutil configuration program ships in two versions: Motif 1.2 and Motif 2.1.
Motif 2.1 supports combo box, spin box, and notebooks for property pages. For

systems with Motif 1.2 support, the Unix driver is shipped with Motif 1.2 option
menus and custom property pages.

The following packages are available:

Motif 2.1

System Requirement Details

Solaris Motif 2.1 libraries: libXm Needed to be installed in target system.
AIX Motif 2.1 libraries: libXm Needed to be installed in target system.
Linux None No library is needed. Motif 2.1 libraries

are linked statically.

There is no Motif 2.1 support for the HP-UX driver.

User’s Guide 2

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.

Check if the following files exist:

• /usr/include/Xm/ComboBox.h

• /usr/include/Xm/Notebook.h

• /usr/include/Xm/SpinB.h

If you have these files, you have Motif 2.1 installed in your system.

If not, check if the /usr/include/Xm sub-directory exists. If so, you have Motif 1.2
installed.

If Motif is not installed on HP-UX, SunOS/Solaris, or IBM AIX systems, the driver
may not be installed or run correctly. You would need to install Motif first before
being able to install the Unix driver. For more information, please refer to the install
Installation Script section.

Obtaining the Installation Package

The package is shipped as one compressed file: toshiba1.2.tar.Z or toshiba2.1.tar.Z
To uncompress the file, use uncompress <Zfile>

Then use tar to restore the files: tar –xvf <tarfile>

Installed Files

Platform Installation Destination Path

HP-UX /usr/local/tsbprn
Sun Solaris (SPARC) /etc/lp/interfaces/tsbprn
Sun Solaris (Intel) /usr/local/tsbprn
IBM AIX /usr/local/tsbprn
Red Hat Linux /usr/local/tsbprn

The driver and user interface files are placed in /usr/local/tsbprn folder, except
on Solaris systems. In most Solaris systems, the /usr/local directory is a mounted
NFS remote system and it is write-protected. Because of this, the drivers are

installed in /etc/lp/interfaces/tsbprn, by default.

User’s Guide 3

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.

If the installation directory does not exist, or cannot be created, the setup
installation program will display error messages and terminate.

The following files are included in the Unix Driver package:

Common Files Description

GA1040ReleaseNotes.pdf Release Notes
GA1040.pdf This documentation and manual.
RELEASE.NUMBER This file contains the release number.
EFTPSxx CORE UNIX driver program that interprets and renders

printed output. “xx” specifies the release number.

rcutil Driver utility providing graphical access to print features

and settings.

Rcutil Resource file that sets characteristics of the graphical

interface.

F533Readme.txt Driver readme file, displayed as online help in the rcutil

Help dialog. This file can be customized for a particular

environment.
toshibaps.ppd GA-1040 PPD configuration file.
pdltype Utility program that checks the type of input file, whether

text file, PostScript file, PCL5 or PCL6 file.
f533.man CORE Driver manual pages.
rcutil.man Interface manual pages.
install Installation script that checks for Motif support before

launching the setup installation program.
setup Installation/un-installation program for CORE driver and

rcutil configuration program.
Setup.txt Installation program readme file, displayed as online help in

the setup Help dialog box. This file can be edited or

customized for a particular environment.
Setup Resource file that sets characteristics of the graphical

interface for the installation program.

AIX Additional Files Description

bafilter-ps Back-end program required for installation on AIX systems.
passthru.ins Installation script for the pass-through filter.

HP-UX Files Description

modelscr Server installation model script.
remote.scr Client installation model script.

Solaris Additional

Description

Files

modelscr Server installation model script.
ver5.7 Solaris 5.7 installation requirements.
ver5.8 Solaris 5.8 installation requirements.

User’s Guide 4

TOSHIBA e-STUDIO28/35/45 Unix Printer Driver

Linux Additional

Description

Files

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.tos file,
replace #!/bin/ksh with #!/bin/bash.

shfilter.clnt Middle script filter for Linux client systems that passes the

input file from the client to the server print queue.

User’s Guide 5

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. Only root is allowed to perform installation procedures.

• The installation program can be executed from the current folder, or from a local
copy of the installation folder. We recommend making a local copy of the
installation folder. It is important to run it where it is located. For one, it uses the
Setup resource file for defining its Motif-based user interface.

• If a print queue would be re-installed, uninstall it first before re-installing to
ensure that the driver is updated correctly. The setup installation program

provides the capability to un-install print queues.

• The rcutil interface was developed using Motif 1.2, Motif 2.1 and C
programming language. Except for Linux systems, it is required that the Motif 2.1

or Motif 1.2 libraries be installed on the system where the setup installation
program will be used and where rcutil will be installed. For safety, use the
install script utility for installing as it performs initialization checks before
launching the setup installation program.

• To launch the setup installation program in GUI mode, the DISPLAY
environment variable must be set. The user must manually set this on the
command line. For example, type “DISPLAY = host:0.0” on the command line.

host is the name of the terminal where setup would be launched. It can also be
the IP address of the said terminal. After assigning value to DISPLAY, export the

environment variable by typing export DISPLAY on the command line. If setup
cannot still launch in GUI mode, you may need to add the terminal in the hosts

file, done by typing xhost host on the command line. Please coordinate with
your system administrator on how to configure your system for running programs

with GUI.

• If DISPLAY is not set, the setup installation program will run in Text mode. The
installation program detects the system capability for graphics and can run in
either Text or GUI mode.

• Man pages must be updated to customize it to your need. Currently the man­pages contains a place-holder for the contact info for troubleshooting. You can
update this with a correct contact info. NOTE: Do not modify application names
such as “EFTPS35” as the installation program automatically parses it.

• Update text files that are used by the driver as Help files for further
customization. These files are the Setup.txt and F533Readme.txt

install Installation Script

The install script is the installation utility and is the secure way for installing or
un-installing the Unix driver. It performs initial system checks before actually

launching the setup installation program. Its major role is to check if Motif library is
installed in the target system. This is provided for convenience to avoid unexpected

User’s Guide 6

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.

The install installation script assumes pre-defined libraries for determining
whether the systems supports Motif or not.

The script checks if the libraries below exist in their specified locations:

Platform Library location

HP-UX /usr/lib/libXm.2
Sun Solaris (SPARC) /usr/lib/libXm.so.4
Sun Solaris (Intel) /usr/lib/libXm.so.4
IBM AIX /usr/lib/libXm.a
Red Hat Linux None

If not, the script will show an appropriate message.
If you think Motif is installed in the system, you can also try running setup
installation program directly on the command line: ./setup

• If it fails (crashes), please take note of any error message you get from the

system and send it to us. This would help us update the install script to reflect
whatever library or file the setup installation program may require to run
successfully in your system.

• BUT if setup runs and shows the user interface, that could mean that it has

found the Motif library somewhere in your system, meaning, you have a
different location than /usr/lib for the Motif library. In this case, you can
modify the install script to reflect this library path. You can contact us if

you like us to do this update for you – just inform us the correct library path
for your target system.

Syntax

./install [-uh] [[q:]<queue>] [s:<server>] [p:<portvalue>]

[t:<insttype>] [g:<guitype>] [cdepth:<dval>]

To run setup directly, use “setup” in the same syntax, as:
./setup [-uh] [[q:]<queue>] [s:<server>] [p:<portvalue>] [t:<insttype>]

[g:<guitype>] [cdepth:<dval>]

If no parameter is specified, this launches the setup installation program in
graphical install mode.

Parameters that are enclosed in square brackets are optional.

User’s Guide 7

TOSHIBA e-STUDIO28/35/45 Unix Printer Driver

-h

-u Uninstalls the specified <queue>
[q:]<queue> The name of the local print queue to be set up or uninstalled. q:

s:<server> The destination network printer server.
p:<portvalue> The printer port in <server>. <portvalue> is the name of the

t:<insttype> Identifies the type of action on the print queue(s).

g:<guitype> Tells whether to run in Graphical-mode or Text-mode. <guitype>

cdepth:<dval>

The parameters can be specified in any order. In text mode, if a <queue> or
<server> is not specified in the command line parameter, the program will prompt
for it.

Example Usage:

./install q:pshakuba s:hakuba p:direct

where pshakuba is the desired print queue name, hakuba is the
network target printer, and direct is the Fiery direct port in the
hakuba printer. This opens the setup installation program in server
install type and GUI mode.

./install pshakuba

will open the setup installation program in server install type and
print Fiery port. This opens in GUI mode. The Network Printer field

will be empty waiting for user to specify a target printer.

./install pshakuba s:hakuba g:no

will run the setup installation program in Text mode. The pshakuba is
the desired print queue name. hakuba is the network target printer. It
will ask if the default print Fiery port will be used. And if not, it will
prompt for a new value.

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.

is optional. Any parameter without the tag is assumed to be
a print queue name. Only the last <queue>, if there’s more
than one specified in the parameter, will be used.

printer port. This is print by default.

In Install mode, this implies installing of a server or client print

queue. <insttype> can be either server (default) or client.

In Un-install mode, if <insttype> is all, this un-installs all print

queues. All other values would un-install <queue>, if it is
specified. This is not all (not set and not used) by default.

can be either yes (GUI, default) or no (Text).

<dval> is for depth value. Specifies the color depth to use to be

able to formulate the background color when running in GUI
mode. <dval> can be no or any numeric value. Non-digit

values are treated as no. no tells the program to use
system default colors for displaying the user interface.

This cdepth parameter is relevant ONLY if the Background color

setting is removed or commented out in the Setup resource
file. This is unused if Background color setting is in the

resource file.

User’s Guide 8