Digital PDFs

AA-MES9A-TE

1988

80 pages

Original

3.8MB

view download

OCR Version

3.1MB

view download

Document:	ULTRIX-32 Guide to System Environment Setup
Order Number:	AA-MES9A-TE
Revision:	0
Pages:	80
Original Filename:

OCR Text

ULTRIX-32
Guide to

System Environment Setup

Order No. AA-MESB9A-TE

ULTRIX-32 Operating Systermn, Version 3.0

Digital Equipment Corporation

The information in this document is subject to change without notice and should not be
construed as a commitment by Digital Equipment Corporation.
Digital Equipment Corporation
assumes no responsibility for any errors that may appear in this document.

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

No responsibility is assumed for the use or reliability of software on equipment that is not
supplied by DIGITAL or its affiliated companies.

The following are trademarks of Digital Equipment Corporation:

DEC

Q-bus

DECnet

VAX

VAXstation

DECUS

ULTRIX

VMS

MASSBUS

ULTRIX-11

MicroVAX

ULTRIX-32

PDP

ULTRIX Worksystem Software

UNIBUS

dlilaliltla]]

UNIX is a registered trademark of AT&T in the USA and other countries.

IBM is a registered trademark of International Business Machines Corporation.
MICOM is a registered trademark of Micom System, Inc.
This manual was written and produced by the ULTRIX Documentation Group in Nashua, New

Hampshire.

Contents

About This Manual
AUAIEIICE

..eeviiiiiiiiieee

OrganiZatiOn

........cccooiii
etttiiieiiii
e e e e e oo e oo,
ecei

Related DOCUMENES

..v.viiiiiiiiiiiiiie
e e
eeeeeeeeee
eeee
ee

CONVENLIONS 1oiiiiiiii
et
e e e iiiii
e e e e e e e e e et
iicce

1.1 Preparation .....c.cccoooieiii
sttt iiiiiiiec
s e e et eseee e e e eiiee
e oo

1-1

1.2 Overview of System FilesS

......occcooviiiireieeeeeeeeeeeeeeeeeeeee oo

1-1

.....ccccccoiiiiiiiiiiiiiiiiee
e eeee oo
ceeeeee
eee s

1-2

1.3.1 Modifying The Password File .......ccccoocoeemmieiveevonaeeeiiinseessinnns
1.3.2 Using the passwd Command .........cc.cccoeeovveeoeveeoeneereieeeeinnnannn,

1-2

1.3.2.1 Improving System Security ........cccoceeeeemmvveereevreeeeeeireeeessinnn,
1.3.2.2 Changing the Shell and Description Fields ........ccooeovvvvennnn..

1.3.3 Accessing the Yellow Pages NetWork

...ccccccceevovveevevevveineiinnn,

1-5

..coociiii
e
iiiii
ee
iie

1-5

1.4.1 The Group File Format .......c.ccccoceomvooieeeeeeieeeeieeeeeeeeeeeeeeeeennin,
1.4.2 Sample Group File ENtries ......cccccoooveevmoureeoieeeeieeeeeeeeeeesveinenn

1-6

1.3 The Password File

1.4 The Group File

1.5 The Terminal Initialization FIle

....ooeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

1-5

1-6

1-7

1.5.1 The Terminal Initialization File Format ............ccoiiiiiiiininis
1.5.2 Sample Terminal Initialization File Entries ...........................

1-7
1-9

1.6 The File System Table .....cccccoomiiin

1-10

1.6.1 The File System Table Format ..........ccoooiviiiiiiiiiinnn...
1.6.2 Sample File System Table Entries ...

1-10
1-11

e,
1.7 The Sendmail Aliases File ......ccoooiiieririiimiiiiiiniiiiiiiii

1-12

1.7.1 The Sendmail Aliases File Format ..............cccooiviiiii
1.7.2 Sample Sendmail Aliases File Entries ...,

1-12
1-12

1.8 The Clock Daemon Table ......ccccoovriiimiiiiiiiiiiiiiiii
e,

1-13

1.8.1 The Clock Daemon Table Format ........cccccoccoiiiiiiiiiiiiiiinnn
1.8.2 Sample Clock Daemon Table Entry ...

1-13
1-14

1.9 The Message-of-the-Day File ...,

1-14

2 Adding and Deleting Users

2.1 AddIng USEIS ...cooiiiiiiiiiiiiiiiiiireene
et tre e
e e e e e ae e

2-1

2.2 Deleting USErs ......ccicviiiiiiiiiiiiiiiiiiienie ettt

e e e e e aeaaae e

2-3

3.1 Adding Terminals and Pseudoterminals ...........ccccocoiiiiiiiiiiiiiiinnnnnne.

3-1

3.1.1 Adding Terminals .....cc.ccccoeeeimiiiimiiiiniiniiiiii
e
3.1.2 Adding Pseudoterminals ........cccoccoovoiiiiiiiiiiiniiiiii

3-2
3-2

3 Adding Devices

3.2 Adding Disk and Tape Drives

......c.cccccociiiiiiiiiiiiiiiiiiiee,

3-3

3.3 Setting Up the System Console .........ccccccccciiiiiiiiiiiiiiiiiiiii.

3-4

4 Setting Up the Print System
4.1 Print System Files and Programs .........cccccovveiiiiiiiieiieiiienneeinieeeninneeennns
4.1.1 Print System Database and Support Files
4.1.2 The Print System Setup Program

........ccccccovvviiiinnnnin.

4-1
4-1

...........ccccociiiiiiiivenninenenee.

4-2

.......ccoooiiiiiiiiiiiiiniiiiiiiiinnennn.

4-2

......ccocoooeiiiiiiiiiiiniiiiinnnn

4-3

4.3 Manually Setting Up or Modifying Your Print System ....................

4-3

4.1.3 The Print System Control Files

4.2 Choosing a Print System Setup Method

4.3.1 Collecting Prerequisite Information ..........ccccooveeiriiiiiiiiiiiiiiennnnnn,

4-4

4.3.2 Identifying the Contents of the /etc/printcap File

.................

4-4

....ccoovvvriiiriiiiiiiiiiiiniiciicinnnnn,

4-6

4.3.3 Modifying the /etc/printcap File

4.3.3.1 Identifying the Name and Number of the Printer

.............

4-6

4.3.3.2 Choosing The Logical Device Name .......cccccevevriiiniiiiiinnernnnnnn.

4-6

4.3.3.3 Creating a Device Special File

4-7

4.3.3.4 Defining the Output Device

.......cccovieiiiiiiiiiiriiiniiiiiiinenennnen,

......ccooveiiiiiiiiiiiiiiiiiiiiiiiiiniiiiennens

4-7

4.3.3.5 Defining the Spooling Directory ......cccccccovviiiiviiiiiiiiiniiiinreenne.

4.7

4.3.3.6 Defining the Baud Rate

4-7

.........ccooovviiiiiiiiiiiiiiiiiiiiciine
e,

4.3.3.7 Defining the Output Filters ......cccoooiiiiiiiiiiiiiriiiiiieniieiiiineennnnn,

4-8

4.3.3.8 Defining the Remote Printers

..........ccoccoiviiiiiiiiiiiiiiniiieninnnn.

4-9

4.3.4 Using the /etc/printcap.examples File ..cocooiiiiiiiiiiiniiiiiiinninnnnnn.

4-10

4.3.4.1 Modifying the /etc/ttys File

4-10

4.4 Using the Automatic Printer Setup Program ..........ccocccooviiiiniiiennn.

4-11

4.4.1 Preparation

.....coooooiiiiiiiiiiiiiiiniiiiin

.....ccccciciiiiiiiiiiniiiiiin
et
eraa e e e rr e sesenenees

4.4.2 Using IPrsetuP

.oviviviiiiiiiiiiiie
e
e eer s e e e e e

4.4.2.1 Adding a New Printer to Your System

........cccceeerriiviinniinnnn.

4-11

4-14
4-14

4.4.2.2 Modifying an Existing Printer Specification ...........cccccvunenn..

4-15

4.4.2.3 Deleting an Existing Printer Specification

............cccooeerenn.

4-15

............cccoociveivirirvinnennnn.

4-15

4.4.2.4 Exiting From the Iprsetup Program

4.4.2.5 Viewing the /etc/printcap File ....cviviiiiiiiiiiiiiiiniiiiinnn,

4-15

4.4.2.6 Quitting the Current Operation or lprsetup Program .........

4-15

4.4.2.7 Getting On-line Help

.ccoooviiiiiiiiiii

4-16

4.4.3 Sample LA100 Line Printer Settings

..........cccccoviiiiviiiierinninnnnn.

4-16

4.5 Controlling Print Jobs

...cccooiiiiiiiiiiiiiiiiici

4.5.1 The lpd Line Printer Daemon
4.5.2 Controlling Printer ACtiVIty

4.5.3 Printing a File

.......ccccooooviviiiieeieieieeeeeseeeeennnnn,

4-17

.....ccccocovvviiviiieeiiieeeeeeeieeeeeeeeeeennenns

4-17

....cccooiiiieiiiiiiiiiiiiiiie
e eeeeeee e e e e
eeeeeeee

4-18

4.5.4 Checking the Print QUEUE ........coooovvviiviiieiieeeeeeeeeeeeeeceeeeeeeaaa
4.5.5 Removing a Job From the Queue ..........ccccceevvvvmvviieenirenaannnnnn.

4.5.6 Generating a Report of Printer USe .....ccoevereveeeeeeeieeennn,

4-18
4-19

4-19

5 Adding and Deleting Software Subsets
5.1 Using setld OPtIONS

.....coioviiiiiiiiiiiiicii
e e e e eiecceee
e s e e eaeeesiaee

5.1.1 Listing Software Subsets
5.1.2 Loading SUDSELS

5-1

.........cccoceovvieieeieeeeeiiiiiieeeeeeeeeiieeeeeesins

5-2

......ceeeiiiiiiiiiiiiii
e iiiitieeeee
e e e e eeea e

5-2

5.1.3 AddiIng SUDSELS ...cccvvvieiiiiiiiiieiiiieeeee e
5.1.4 Deleting SubSets ......cccoovviiiiiiiiiii
e
eeee
iiiiee
e,
5.1.5 Verifying Subset Installations

............cccccceevmmivveeereeesieiveeneeenn,

5-3
5-3
5-3

6 Monitoring and Managing System Performance
6.1 Managing Process Scheduling Priority

.......ccccoeeveveeeeveoieeeeeerereeisinnnnnn,

6-1

6.2 Generating System Accounting Information ..........cccceeevveeevvvveeeiinnenn,

6-1

6.2.1 Generating User Log-In Report .......cccccoovovvieevcveveeeceeseieaeaennnn,
6.2.2 Generating Command Usage Report ....ccccooeeeveeveevveeevvevirnennn,
6.2.3 Generating Printer Usage Report ....ccccocceovveveevveeeeeoceeevvienninn,

6-2

6.2.4 Generating Active System Report

6-2
6-3

.....ccccocovvvoevveeeeeoveeeeiiinnin,

6-4

6.3 Check Interprocess Communications Facilities Status ......ocovvveeuevn..

6-4

A Device Mnemonics

Figures

4-1:

Sample /etc/printcap File EXtract .....ccccccoeovvvvevoveeeeiieeeseeeeeeeeeeenin,

4-5

4-2:

/etc/printcap.examples File EXtract ........ccoccceevmvememoireeeiieeeeineesnninn,

4-10

Examples
2-1:

Sample adduser Sequence

2-2:

Sample removeruser SEQUENCE

-------------------------------------------------------------------

.......c..cccovvvvvvrreeeiiiiiieireeeeeeeearereeesessans

Tables
A-1:

Devices Supported by MAKEDEV

.....ccooviiiiiiiiiiieeceteee
e

About This Manual

The objective of this guide is to provide you with information needed to
set up and maintain a working environment for users at your site.
The
guide assists you as you set up your particular environment and presents

guidelines from which you can develop specific procedures for your site.

Audience
The Guide to System Environment Setup is written for the person
It assumes

responsible for managing and maintaining an ULTRIX system.

that this individual is familiar with ULTRIX commands, the system
configuration, the system’s controller/drive unit number assignments and
naming conventions, and an editor such as vi(1)

or ed(1).

You do not

need to be a programmer to use this guide.

Organization
This manual consists of 5 chapters, one appendix, and an index. The
chapters and the appendix are:

Chapter 1:

Modifying System Files
Identifies and describes the most commonly accessed
ULTRIX system files and defines the file formats.

The

chapter also identifies system utilities that you can use
to modify the files.
Chapter 2:

Adding and Deleting Users
Identifies and explains how to use the various ULTRIX

system utilities to add users.
Chapter 3:

Adding Devices

Describes how to add devices using the MAKEDEV
script.

Chapter 4:

Setting Up the Print System
Explains how to set up the print system manually or, if
you prefer, interactively with the Iprsetup utility.

Chapter 5:

Adding Software Subsets
Explains how to use the setld utility to add software

subsets.

Chapter 6:

Monitoring System Performance
Offers guidelines for monitoring system performance.

Appendix A

Device Mnemonics
Lists the supported device mnemonics and explains how
to obtain detailed reference page information on devices.

Related Documents
You should have the hardware documentation for your system and
peripherals.

Conventions
The following conventions are used in this manual:
special

In text, each mention of a specific command, option,
partition, pathname, directory, or file is presented in this
type.

command(x)

In text, cross-references to the command documentation
include the section number in the reference manual where
the commands are documented.
For example: See the
cat(1) command.

This indicates that you can find the
material on the cat command in Section 1 of the reference
pages.

literal

italics

In syntax descriptions, this type indicates terms that are
constant and must be typed just as they are presented.
In syntax descriptions, this type indicates terms that are

variable.

[ ]

In syntax descriptions, square brackets indicate terms that
are optional.
’

In syntax descriptions, a horizontal ellipsis indicates that
the nrecedino item can be reneated nne or Mmave +Fimoa

function

In function definitions, the function itself is shown in this
type. The function arguments are shown in italics.

UPPERCASE

The ULTRIX system differentiates between lowercase and
uppercase characters.
Enter uppercase characters only
where specifically indicated by an example or a syntax line.

example

In examples, computer output text is printed in this type.

example

In examples, user input is printed in this bold type.

This is the default user prompt in multiuser mode.

This is the default superuser prompt.

>>>

This is the console subsystem prompt.

In examples, a vertical ellipsis indicates that not all of the
lines of the example are shown.

<KEYNAME
> In examples, a word or abbreviation in angle brackets
indicates that you must press the named key on the
terminal keyboard.

In examples, symbols like this indicate that you must hold
down the CTRL key while you type the key that follows
the slash.
Use of this combination of keys may appear on
your terminal screen as the letter preceded by the
circumflex character.

at all.

In some instances, it may not appear

Modifying System Files 1

1.1

Preparation

Before you install Version 3.0, you should back up your system, especially
any site-specific files.

Refer to the Advanced Installation Guide for more

information on site-specific files.

After installing the system, you should

check the site-specific files against the files shipped with Version 3.0.
Before restoring these files, be sure that all Version 3.0 specific information
is in the files you restore.

For example, previous to V1.2 the loopback

driver was specified in the /etc/hosts and the /etc/networks files.

From

V1.2 on, the loopback driver must be specified in the /etc/rc.local file as
well.

The rc.local file that is installed with Version 3.0 contains the

following correct loopback driver entries:
/etc/ifconfig
netmask

/etc/ifconfig

1.2

niO

“/bin/hostname’

broadcast

128.45.45.0\

255.255.255.0

100

localhost

Overview of System Files

This chapter describes some of the ULTRIX system files that you can
create or modify after your system has been installed.

These files perform

a number of different functions; for example, they enable user log in, the

setting up of mail aliases, and the display of a login message of the day.
The following sections describe:

The 'password file

The group file

The terminal initialization file

The file system table

The sendmail aliases file

The clock daemon table

The message of the day file

Most system files are created automatically during the system installation.
However, you can create or modify a file after the system has been

installed.

For example, to change login information for system users,

modify the /etc/passwd and /etc/group files.

To specify sendmail aliases,

create or modify the /usr/lib/aliases file. In most cases you will be using a
system editor, such as vi, to change the content of the files.

Where

applicable, the system tools available to modify the files are identified.
The following sections contain descriptions and sample entries for each of

the listed system files:

1.3

The Password File

The /etc/passwd file is a data file that contains an entry for every user
who has login privileges on your system. Although it is called the password
file, it contains more than user passwords.

Figure 1-1 illustrates the

contents of a password file created for an ULTRIX system that runs the
Yellow Pages.
root:R,r97fsje20ss:0:1:System
field:Pa9rek3.115e:0:1:F

PRIVILEGED

operator:sruF3.9ir,ePw:0:28:0perator
guest:n3Rel9s22:10:33:Guest

Account:/:/bin/csh

Account:/usr/field:/bin/csh
PRIVILEGED

Account:/opr:/opr/ops

account:/tmpguest:/bin/date

Joseph

Doe:/usr/staff/jjd:/bin/csh

jws::24:10:John

Walter

Smith:/usr/staff/jws:/bin/csh

jjd::34:10:John

1.3.1

Modifying The Password File

The system automatically creates a generic /etc/passwd file at installation,
but you must modify this file to include site and user specific information.
°

By default, the /etc/passwd file is Read Only; only the superuser can
edit the file itself.

However, once login accounts exist, registered

users can invoke system commands to change their password and
default shell.
o

The easiest way to modify password entries in the /etc/passwd file is

with the passwd command.
password.
o

The superuser can change any user

Individual users can change only their own password.

The easiest way to add or delete users in the /etc/passwd file is with
the adduser and removeuser commands.
invoke these commands.
use.

Only the superuser can

See Chapter 2 for a description of their

Each entry in the /etc/passwd file contains the following information:

the

user login name, the user password, the user id, the group id, a description
of the user, the pathname of the user home directory, and the pathname
of the default shell or command to be executed immediately following login.
The format for each entry is:
name:[passwordj:user-id:group-id:description:home-directory:[shell]
name

The first field contains the user’s login name (1 to 8
characters). The system uses this name in establishing
login permission.

password

The second field contains the user’s encrypted password.
An entry in this field is optional. The system uses this

password in verifying login permission.

user-id

The third field contains the user’s identification number
The system uses this number to determine a

(user ID).

user’s identity.

Once login permission is granted, the
system internally translates the login name to this user ID
number and uses it in identifying the user’s processes and
in determining owner access permission to files.
This
number must be unique for each user and should be less
than 32000.

group-id

The fourth field contains the primary group identification
number (group ID).
The system uses this number to

determine a user’s default group classification.
You can set
up the permissions for any file so that users with the
same group-id numbers can access the file, but those users
with different group-id numbers cannot.
Once login
permission is granted, the system internally establishes the
user’s group ID number and uses it in determining group
access permission to files.
This number must be unique
for each group and should be less than 32000.

A user may belong to a maximum of eight groups.
The
/etc/passwd file lists only the user’s primary group.
You
can see the user’s secondary groups by displaying the
/etc/group file.
description

The fifth field contains additional user information.
For
example:
user name, office location, office phone number,

and home phone.
The user name can be an ampersand
(&), which means that the login name and the user name
are the same.
User’s can maintain the description field

with the chfn command.

home-directory

The sixth field contains the absolute pathname to the
user’s home (initial working) directory. After establishing
the appropriate user and group identification, the system
uses this pathname to place the user in the named
directory.

shell

The seventh field contains the absolute pathname to the
command that is to be executed immediately upon
conclusion of the login process.
This is normally a version
of the shell (command interpreter) such as /bin/csh or
/bin/sh.
It can also be used to allow the user limited
access to the system.
By replacing a shell version with
the full pathname of a particular command, the user will
only be allowed to execute that command.
Furthermore,
the system will log the user out once he has executed that
command.

An entry in this field is optional.
If nothing is specified,
the system automatically invokes /bin/sh.
1.3.2

Using the passwd Command

In the preceding sample, only some of the user entries contain an
encrypted password in the password field. When creating accounts for new
users, you are not required to supply a password.
After users log in for
the first time (no password is required when the password field is blank),
they can create their own password using the passwd(1) command as
described in the ULTRIX Reference Pages.

1.3.2.1
Improving System Security- To improve system security when
modifying the /etc/passwd file, follow these procedures:
1.

Preassign the password for all new users on your system.

To do

this:
®

Log on as superuser.

Enter the passwd command giving the user’s login name as an
argument.
For example, to create a password for a user named
francis, type:
#

passwd

francis

When the passwd command prompts for the new password,
type a simple password.
The program encrypts this password and includes it in the
/etc/passwd file.
The user can then log in to the account with
the assigned password and change it.
See passwd(1l) in the
ULTRIX Reference Pages for additional details.

For file locking protection, use the vipw command to edit the
/etc/passwd file.
See vipw(8) in the ULTRIX Reference Pages for
details.

1.3.2.2
Changing the Shell and Description Fields - A registered user
can change the assigned login shell using the chsh command, giving his
login name and the pathname of the desired shell as arguments.
See
chsh(1) in the ULTRIX Reference Pages for a description of this command
and format.
Similarly, a registered user can change information in the description field
with the chfn command, giving his login name as an argument.
See
chfn(1)

in the ULTRIX Reference Pages for details.

1.3.3

Accessing the Yellow Pages Network

If your system includes the Yellow Pages software, you must make certain
adjustments to your /etc/passwd file.
°

If Yellow Pages is installed before you run uucpsetup or netsetup,
you must edit the /etc/passwd file and move the plus colon entry
(+:)

to the last line of the file. The sample /etc/passwd file shown

earlier in this chapter illustrates this case.
e

If you want to use the uucp utility throughout your YP network, you
must run uucpsetup on the YP master server machine and then
remake the password maps.

If you want to use the uucp utility for local use only, you can run
uucpsetup on your YP client machine.

See the Guide to the Yellow Pages Service for further information.

1.4

The Group File

Data for groups and group members is stored in the system group file
/etc/group.

This data file allows users with dissimilar group IDs in the

/etc/passwd file to access common files associated with a particular task,
such as a large programming project.

The system uses the /etc/group file

to determine which users are in which grouns and to establish access

permissions to those files created by group members.

To add groups or group members, edit the /etc/group file by creating a
new group entry or adding the user name to an existing entry.

Each entry in /etc/group contains information that the system uses when
translating individual group IDs to names and in verifying simultaneous
membership in multiple groups.
eight groups.

A user can be assigned to a maximum of

Each entry contains four fields of information which are

delimited by colons.

Also, each group file entry can be no more than 1024

characters in length.

1.4.1

The Group File

Format

The format of the /etc/group file is:
group:password:group-id:name,name...
group

The name of the group.

password

The encrypted password.

not be empty.
(*)

in this field.

This field is not used, but it should

When creating a new entry, put an asterisk
The asterisk eliminates group password

matching.

group-id

The group identification number. The system uses this number
to determine group access permissions to files.
primary group-id is listed in the passwd file.

The user’s
The users’

secondary groups are listed here in the /etc/group file.

The

group-id must be unique and should be be less than 32000.

name

The login names of the current group members, all of which
are delimited by commas.

Each group file entry can have as

many as 200 members, provided that the total number of

characters does not exceed 1024 characters.

When you enter

the member login names, it is acceptable to let the entry
wrap onto the next line of the display screen.

1.4.2

Sample Group File Entries

The following is a sample entry from a /etc/group file:
research:*:25: jones,wilson

This entry contains information for a group called research.

The password

field contains an asterisk, which eliminates password matching.
ID is 25, and current members are Jones and Wilson.

The group

To add members to an existing group, edit the /etc/group
file by adding
the users’ login names to the appropriate list.
For example:
research:*:25: jones,wilson,smith,thompson

This entry now lists four current members:
Thompson.

Jones, Wilson, Smith, and

To delete either an existing group or an existing member from a group,
edit the /etc/group file by deleting the appropriate entry or name.
For further information, see group(5)

1.5

in the ULTRIX Reference Pages.

The Terminal Initialization File

You may have to modify a configured terminal for daily operations.
To
modify a configured terminal, edit the terminal initialization file letclitys by
modifying the information listed for the appropriate terminal entry.
Each entry in the /etc/ttys file contains information that the getty command
uses during system boot to determine if a terminal is to be opened for
login.
There is one entry in the /etc/ttys file for each tty line.
Each
entry can contain 512 characters.

Each entry in the /etc/ttys file contains

five fields of information separated by spaces as described in the following
section.
For further information, see getty(8) and login(1) in the ULTRIX

Reference Pages.

1.5.1

The Terminal Initialization File

Format

The format of the /etc/ttys file is:
name command type status window= "string"

name

description

The name field defines the terminal’s special file (device)

name, as listed in /dev.
All terminals except network
pseudoterminals, workstation pseudoterminals, and modems use
the following naming convention:

tty[0-9A-Z][0-9]
The terminal names range from tty00 to tty99 and from ttyAOQ
to ttyZ9 for a total of 360 possible tty names.

Network pseudoterminals use the following naming convention:
ptylqrstull0-9a-f]

tty[qrstul[0-9a-f]

This convention yields a total of 96 matched pairs ranging
from ptyq0 (ttyq0) to ptyuf (ttyuf).
Workstation terminals follow the same naming convention as
network terminals which is defined as follows:

This yields a total of 16 matched pairs ranging from ptyv0
(ttyv0) to ptyvf (ttyvf).
The modem (dialup) lines have the following convention:
ttyd[0-9a-f]

This convention yields 16 dialup line names ranging from ttyd0
to ttydf.

command

The command field contains the name of the command to be
executed each time the terminal is initialized. This field also
contains command arguments, if applicable. If the command
has arguments, both the command and its arguments must be
enclosed by double quotes. If there are no arguments, then
quotes are unnecessary.

The command usually contains /etc/getty, which allows users to
log in to the system. If the command field contains /etc/getty,
be sure to include the terminal’s baud rate. For further
information on getty, see getty(8) and gettytab(5) in the
ULTRIX Reference Pages.

If the terminal is a pseudodevice, then the command field
>

]

should contain the string none.

status

The type field defines the terminal type such as a vt100. If
the terminal is a pseudodevice, then ¢ype should be network.
The status field specifies the status of the terminal line.
terminal line can have up to four status values:

The

off or on

If the status is off, then the command and its associated
terminal line is disabled. For pseudodevices, set the
status to off.
if command is /etc/getty and the status is
off, then the terminal is disabled for logins. If the status
is on, then the command and its associated terminal line
is enabled. If nothing is specified, then off is the default.
modem or nomodem

If the status is modem then the terminal is a modem
(dial-in and dial-out). If the status is nomodem, then the
terminal is hardwired.
If nothing is specified, then
modem is the default.
secure

If the terminal is secure, then superusers (root) can log
in to the system on that terminal line.
If nothing is
specified, then the terminal line is not secure, meaning

that superusers cannot log in to the system on that line.

shared or not shared
If the terminal is shared, then logins, tip, and uucp can
use the same terminal (not simultaneously).

If nothing is

specified, then not shared is the default, meaning that
logins require one terminal, and tip and uucp require
another terminal.

uucp(1lc)

For further information, see tip(1)

and

in the ULTRIX Reference Pages.

window= "string"
The quoted string is a window system process that init
maintains for the terminal line.
init(8)

description

For further information, see

in the ULTRIX Reference Pages.

You should put any comments about the entry in this field,
preceded by a #.

1.5.2

Sample Terminal Initialization File

Entries

Here are sample entries from a /etc/ttys file:
console

»/etc/getty

std.9600+

vt100

secure

normal

console

ttyOl1l

v/etc/getty

std.9600"

vitl1l00

nomodem

direct

connect

ttypa

none

network

off

secure

network

tty

To modify a configured terminal, edit the /etc/ttys file and change the
appropriate field of the appropriate entry.

For example, to enable a

configured terminal, modify the status field of the appropriate entry to read
on.

Similarly, to disable a configured terminal, edit the /etc/ttys file to

modify the status field of the appropriate entry to read

off.

Note

The default console entry in the /etc/ttys file is set up to be a
1200 baud hardcopy terminal. If you are using a faster device
(such as a display terminal)

for a system console, you must

change the /etc/ttys file to a faster baud rate as shown in the
preceding example.

The next time you boot your system, init

will automatically act on the modified entry.
To implement a change during multiuser mode, use the kill command to
send a hangup signal to init.
#

kill

—-HUP

For example:

tty

This command sends a hangup signal to init which rescans the /etc/ttys file
and processes only those entries that have been modified.
information, see kill(1)

1.6

The

and init(8)

For further

in the ULTRIX Reference Pages.

File System Table

When necessary, you may have to modify the file system table, /etc/fstab,
to reflect required changes (for example, adding a new file system or
changing the order in which your file systems are to be loaded, dumped, or

checked).

To modify the file system table, you should edit /etc/fstab by

either creating a new entry, or adding or changing information for an
existing entry.

Before editing /etc/fstab, you should familiarize yourself with its format.
Each entry in /etc/fstab contains default information for the mount, dump,
and fsck commands.

For further information, see mount(8), dump(8)

fsck(8)

in the ULTRIX Reference Pages.

1.6.1

The

File

System Table

and

Format

Each entry in /etc/fstab contains seven fields of information that are
delimited by colons.

As defined in the /usr/include/fstab.h file, the format

of an /etc/fstab file is:
spec:file:type:freq:passno:name:opts:
spec

The spec field defines either the file system’s block special file

(device)

name, or it defines a remote file system like Network

File System (NFS).

Examples are: /dev/ra0g for a local system

and /usr/src@erie for a remote system.

file

The file field defines the absolute pathname to the directory on
which the file system is mounted. This is used as the default
information for the mount command.

type

The type field specifies the file system mode:

rw (read-write), ro

(read only), rq (read-write with quotas), sw (swap), and xx
(ignore).

If sw is specified and if the file system has been

configured for such use, swapon (invoked by /etc/rc)

makes that

file system part of the system swap space. If xx is specified, the
local file system is ignored, that is, not processed by mount,
dump, or fsck.

freq

The freq field specifies the file system dump frequency (every
nth day).

This is used as default information for the dump

command.

For NFS entries, this field should be a 0 value.

passno

The passno field defines the file system pass number.
used as the default order for the fsck command.
the root file system has a pass number of 1.

This is

Usually, only

The remaining file

systems should be assigned higher pass numbers, which enables
the fsck utility to simultaneously check file systems in parallel.

Before you create a new entry, first consider that all file systems
on a single disk should have different numbers.

Next, consider

that the fsck utility can check file systems on different disks at
the same time.

Therefore these file systems can have the same

pass number.
You should also be aware that NFS entries should have pass

numbers of O so that local execution of certain commands, such
as fsck and dump will ignore these particular /etc/fstab entries.
The reason for this is because NFS file systems specified in the

/etc/fstab file identify remote file systems that are usually
maintained by someone at the remote system site.

name

The name field defines specific file systems that you are
mounting.

opts

Supported file systems are: UFS and NFS.

The opts field defines file system-specific options that are being

passed to the file system being mounted.
To add an entry to the file system table, edit the /etc/fstab file.

1.6.2

Sample File System Table Entries

Here are two sample entries from an /etc/fstab file:
/dev/ra0g:/usr:rw:1:2:ufs::
/usr/src@erie:/usr/src:ro:0:0:nfs:bg

The first entry lists information for the ULTRIX File System (UFS), the
local file system that resides on a disk’s g partition and is mounted readwrite on the /usr directory.

This file system is dumped every day by

dump and is checked by fsck on the second pass.
a remote file system entry.

The second entry shows

Note that this file system is mounted read

only and that the freq and passno fields are both zero so that locally
executed commands such as dump and fsck will ignore these fstab entries.
Note

Because mount, dump, and fsck process the entries in order,
according to the pass field, the order of the entries in the
letc/fstab table is important. For example, mount will fail if it is
told to mount a file system on a directory that itself is not yet
mounted.

You should make sure that each entry in /etc/fstab is

listed in a logical order.

You should also ensure that NFS

entries have freq and passno field values of zero.

For example:

/dev/ra0a:/:rw:l:1:ufs::

/dev/rabh:/usr:rw:1:2:ufs::
/dev/ra0Of:/usr/staff:rw:1:3:ufs::
/usr/man@suez:/usr/man:ro:0:0:nfs:bg:

For more information on the fstab file, refer to fstab(5)
Reference Pages.

in the ULTRIX

For more information on NFS, refer to the Guide to the

Network File System.

1.7

The Sendmail Aliases File

Each entry in the /usr/lib/aliases file contains information that the sendmail
utility uses to route messages to users when an alias is specified in a mail
message.

To add a user name to this file, edit the /usr/lib/aliases file by

either creating a new alias entry or adding a new name to an existing
entry.

Before editing /ust/lib/aliases, you should familiarize yourself with its
format.

1.7.1

The Sendmail Aliases File Format

Each entry in /usr/lib/aliases contains two fields of information separated by
a colon.

The first field is the alias name.

user names separated by commas.

The second field is a string of

The format of the /usr/lib/aliases file

entries is:

alias:user,user...

alias
user

The alias field identifies the name of the alias group.
The user field contains a string of user login names, which are
separated by commas.

This information lists the user names to

which the mail is to be routed when the alias is specified. The
list of users can extend beyond one line.

To add user names to the alias file, edit /usr/lib/aliases.

1.7.2

Sample Sendmail Aliases File Entries

Here is a sample entry from a /usr/lib/aliases file:
research: jones,wilson,smith,thompson

This entry lists the names (Jones, Wilson, Smith, and Thompson)

to which

sendmail routes messages when the research alias is specified.
To make these additions immediately become part of the sendmail aliases
data base, use the newaliases command.
#

For example:

newaliases

This command reads the new information added to /usr/lib/aliases and

rebuilds the sendmail aliases data base.
For further information, see newaliases(1), aliases(5), and sendmail(8)

the ULTRIX Reference Pages.

1.8

The Clock Daemon Table

The clock daemon table, /usr/lib/crontab, is a symbolically linked file that
contains routine commands which the system clock daemon, cron, executes
at the specified dates and times.

For example, /usr/lib/crontab might

contain routine backup commands as well as commands that cause the
automatic removal of outdated or unused temporary files.

Once invoked during multiuser startup, the system activates the system
clock daemon, cron, every 60 seconds.

In turn, the system clock daemon

executes those commands listed in the /usr/lib/crontab file (clock daemon
table)

that are scheduled for that time.

Since each entry in /usr/lib/crontab contains information that specifies a
time and command sequence that is to be executed regularly, you should
stagger the crontab entry times so that the processes are not all running
at once.

When appropriate and especially during anticipated periods of

heavy user activity, you should also include the nice command in your
crontab file entries so that the crontab commands execute at a lower
priority.

To change the clock daemon table, edit /usr/lib/crontab.

For further

information on the clock daemon and prioritizing tasks, see cron(8)
nice(1l)

in the ULTRIX Reference Pages.

1.8.1

The Clock Daemon Table

Format

Each entry contains six fields of information separated by spaces.
format of the entries in the /usr/lib/crontab file is:
minute hour day month weekday command
minute

The exact minute that the command sequence is to be

executed.

and

The minute variable can be 0 through 59.

The

hour

The hour of the day on which the command sequence is to be
executed.

day

The hour variable can be 0 through 23.

The day of the month on which the command sequence is to

be executed.

month

The day variable can be 1 through 31.

The month of the year on which the command sequence is to
be executed.

weekday

The month variable can be 1 through 12.

The day of the week on which the command sequence is to be
executed.
7.

command

The weekday variable can be an integer from 1 to

Monday equals 1 and Sunday equals 7.

The command sequence that is to be executed.

The command

variable should contain the complete command sequence.
In addition, the first five fields may specify either a single time indicator,
a multiple time indicator, a time range, or an asterisk.

A single time

indicator may consist of one or two consecutive digits such as 3 or 33.

multiple time indicator consists of a string of indicators separated by
commas, such as 5,10,15,20.

A time range consists of two indicators

separated by a dash, such as 5-20.

An asterisk field entry represents all

times.

1.8.2

Sample Clock Daemon Table Entry

The following is a sample entry
0,30

from the /usr/lib/crontab file:

/usr/lib/atrun

This entry specifies that the cron command is to invoke /usr/lib/atrun daily

on the hour and half hour.

For further information, see cron(8)

in the

ULTRIX Reference Pages.

1.9

The Message-of-the-Day File

You may have to provide the system users with information that is
relevant to that day’s operation.
To do this, create a message-of-the-day
using the /etc/motd file.

As a general rule, the first line of the message-of-the-day file should
contain the adjective ULTRIX-32, the current version of the operating
system, and the day’s date.

After each login, the system displays the contents of the /etc/motd file at
the user’s terminal.
The system displays this same message after each
login until you either modify or delete the contents of /etc/motd.

Adding and Deleting Users 2

This chapter describes how to add and delete users.
system, use the adduser command.
use the removeuser command.

To add users to your

To remove users from your system,

You can also add or remove users manually

with the vipw command.

Note

If you install the Yellow Pages (YP)

service as described in the

Guide to the Yellow Pages Service, you cannot use the adduser
or the removeuser commands.

Refer to ypsetup(8yp)

and to the

Guide to the Yellow Pages Service for information on setting up

the YP service.

If the YP service is enabled, use the vipw

command to make changes to the /etc/passwd file.

2.1

Adding Users

The adduser command is an interactive facility for adding new user
accounts to the /etc/passwd system password file.

names to the /etc/group file.

It also adds user login

For each new user account, the adduser

command sets up a home directory with the C shell files and the Bourne
shell file and a bin subdirectory.

New accounts created in this way initially

have no password.

To add a user to the system, type:
#

/etc/adduser

The prompts request information about the user.

The default answers are

provided in square brackets for some of these entries.

these defaults by pressing the RETURN key.

You can select

The adduser command also adds users to the /etc/group file provided that
the group and the directory for that group already exist.

See Chapter 1

for more information on the group file.
Note

To add a user to a group other than users, you must create a
directory for that group before issuing the adduser command.
For information on adding directories, see mkdir(1)

in the

ULTRIX Reference Pages.
Be aware that if your system uses the Yellow Pages service, the
following message appears at your terminal in response to the
/etc/adduser command:
This system makes use of the Yellow Pages service for user

account administration.

Please add the new user by following the

steps given in the Overview of Yellow Pages chapter of the

Network Management Guide.
Example 2-1 depicts a sample interactive session with the adduser
program.

In this case, the system does not use the Yellow Pages service.

Example 2-1: Sample adduser Sequence
#/etc/adduser
Enter

Enter

full

name

What

group

for
for

new
new

should

user

(initials,

first

user:

Jim

Laker

this

user

into

[

last

users

]

member

name):

jal

usersl

Working
Enter

another

(<RETURN>

group

only

that

“jal

more):

should

users2

Working

Unknown
Known

group:

groups

users?2.

are:

system

daemon

uucp

bin

news

usersl

ris

users

guest

operator

ingres

staff

you

Adding

want

add

new

group

users2

/etc/group

the

/etc/group

file

[yes]

file...

(continued on next page)

Enter

group

Enter

another

(<RETURN>

number

for

group

only

new

that

group

“jal’

[105]:

should

member

more):

Working

Enter

parent

Adding

new

The

new

directory

for

jal

[/usr/users]:

/usr/usersl

user

account

initially

has

password.

This sequence of prompts and user entries shows that after the user’s login
name and full name were entered, the adduser command prompts for the
user’s login group, which has a default of users.
Notice that when users2
was entered as a secondary group, the adduser command found that this
group did not exist.
The adduser command next displays the known
groups and asks if users2 should be added to the /etc/group file.
The final
adduser prompt is for the entry of the user’s parent directory.
This is
the user’s home directory, which is the sixth field of the /etc/passwd file.

After the adduser command informs you that it has added the new user to
the system, you can verify the addition by checking the /etc/passwd file.
For example, type:
#

2.2

/etc/passwd

Deleting Users

Use the removeuser command to delete users from the system password
file.

The removeuser command also gives you the option of deleting the

user’s home directory and files.

This command displays default responses

in square brackets and enables you to select them by pressing the RETURN
key.

For further information, see removeusers(8)

in the ULTRIX

Reference Pages.
Note

You cannot use the removeuser command if you have enabled

the YP service as described in the Guide to the Yellow Pages
Service.
The removeuser command does not remove a user’s name from
the /etc/group file.

To remove a user from a group, you must

edit the /etc/group file.

To remove a user from the system password file, type:
#

/etc/removeuser

The prompts request information about the user you want to remove from

the system.

Example 2-2 shows the sequence of prompts and user entries that are
typically entered to remove a user from the system.

Example 2-2: Sample removeruser Sequence
#

removeuser

Enter

This

name

what

for

the

Jal::543:15:Jim

this

the

user

entry

you

removed:

/etc/passwd

jal

looks

|ike:

Laker:/usr/usersl/jal:/bin/csh

wish

delete?

Working

User
Do

jal

you

removed.

want

remove

all

subdirectories

You

should

Are

you

Deleting

have

sure

and

backed

that

you

jal’'s

home

files

directory,

(y/n)?

jal’'s

want

files

remove

you

jal’'s

files

not

wish

(y/n)y?

lose

/usr/usersl/jal

This sequence of prompts and user entries shows you what will happen
when you use the /etc/removeuser command to delete the user named jal
from the system.
After entering the user’s login name, the removeuser
command displays the /etc/passwd file entry and then prompts you to
If you type y, the removeuser command removes the

remove the entry.

entry from the /etc/passwd file and prompts you to delete all subdirectories
and files.
Last, the command tells you that it is deleting /usr/usersi/jal
directory.

them.

Adding Devices 3

This chapter describes how to add terminals, pseudoterminals, and device

drivers to your system.

It is organized as follows:

Adding terminals and pseudoterminals

Adding disk and tape drives

Before adding any device to your system configuration, check your system

configuration file to see if a description of that device type is entered
there.

If the device description is in the configuration file, then you use

the MAKEDEV script to add the particular device to your system.

If not,

you must rebuild and boot a new kernel after adding the device.

The

configuration file and building the kernel is described in the Guide to

System Configuration File Maintenance.
When you add a new device to your system configuration with the
MAKEDEV script, a special file is created for the device in the /dev

directory.

You can use the file command to display information about the

special files in the /dev directory.

For example, to display the status of

each special file in the /dev directory, type:
%

file

/dev/*

For further information, see file(1)

and MAKEDEV(8)

in the ULTRIX

Reference Pages.

3.1

Adding Terminals and Pseudoterminals

When adding lines and multiplexers, you must physically connect the

devices as follows:
1.

Stop system activity by using the /etc/shutdown command and then
power down the system by turning off the processor or by issuing
the correct console command.

For further information, see the Guide

to System Shutdown and Startup.
2.

If appropriate for your device, set the control status registers (CSRs)

and interrupt vectors on the board.
standard addresses.
standard address.

Most DIGITAL devices have

Refer to the appropriate device manual for the

Install the board.

Power up the machine.

Boot the system.

Refer to the Guide to System Shutdown and

Startup for information on booting your processor.
After physically connecting the terminal line or multiplexer, follow the
procedures outlined in this text to complete the addition of the device.

3.1.1

Adding Terminals

The following procedure explains how to add a terminal multiplexer to your
system.

This procedure applies to terminal multiplexers for all machines.

To add a terminal multiplexer, refer to Appendix A for the MAKEDEV
device mnemonic for your controller, then follow these steps:
1.

Use the cd command to move into the /dev directory,
#

/dev

Invoke the MAKEDEV script for your controller using the format:
MAKEDEVY

device#

The device variable is the mnemonic device name for the terminal
you are adding.

When using
AavsIL

The # variable is the device number 0 through 10.

MAKEDEV,

ARA

L
d

be sure to save its output since you will refer

to this output when updating the /etc/ttys file.
3.

Edit the /etc/ttys file to reflect the new tty lines that MAKEDEV
created. For a discussion of the /etc/ttys file, refer to Chapter 1.

3.1.2

Rebuild and boot a new kernel, if necessary.

Adding Pseudoterminals

To add a pseudoterminal, refer to Appendix A for the appropriate
MAKEDEV device mnemonic, then follow these steps:
1.

Use the cd command to move into the /dev directory,
#

/dev

Invoke the MAKEDEV script for your pseudoterminal using the format:
MAKEDEV

pty#

The # variable specifies which set (0 through 5)
you want to create.

of pseudoterminals

Kach single set creates 16 pseudoterminals, for

a total of 96 in the system.

By default, the installation creates the

first two sets of pseudoterminals, pty0 and ptyl.

These lines are

named /dev/itvn0 throuch /dev/ttvof and /dev/ttva0d throuch /dev/ttvaf

Thus, to create the next logical set of pseudoterminals, named
/dev/ttyrO through /dev/ttyrf, invoke the MAKEDEV script as follows:
#

MAKEDEV

pty2

When using MAKEDEV, be sure to save its output since you will refer

to this output when updating the /etc/ttys file.
3.

Edit your /etc/ttys file to reflect the new pseudoterminal lines that
MAKEDEV created for you. For a discussion of the /etc/ttys file, refer

to Chapter 1.
4.

Modify the system configuration file, /usr/sys/conf/SYSTEM_NAME,
then rebuild and boot a new kernel,

if necessary.

For further

information, see the Guide to System Configuration File Maintenance.

3.2

Adding Disk and Tape

Drives

After you install the new controller at a DIGITAL standard address and
successfully run the diagnostics, you must physically connect the devices as

follows:
1.

Stop system activity by using the /etc/shutdown command and then
power down the system by turning off the processor or by issuing

the correct console command.

For further information, see the Guide

to System Shutdown and Startup
2.

If appropriate for your device, set the control status registers (CSRs)

and interrupt vectors on the board.
3.
4.

Install the board.
Power up the machine.

Boot the system.

Refer to the Guide to System Shutdown and

Startup for information on booting your processor.
To add a drive to your software configuration, refer to Appendix A for the
MAKEDEV device mnemonic for the drive you are adding, then follow these
steps:

Use the cd command to change to the /dev directory:
#

/dev

Invoke the MAKEDEV script for the controller using the format:
MAKEDEV

device#

The device variable is the mnemonic device name for the drive you
are adding.
The # variable is the device number 0 through 31.

Modify the system configuration file, /usr/sys/conf/SYSTEM_NAME,
then rebuild and boot a new kernel, if necessary.

For further

information, see the Guide to System Configuration File Maintenance.
This example shows how to add two disk drives to your system:
#

MAKEDEV

ra0

ral

This example shows how to add two tape drives to your system:
#

3.3

MAKEDEV

tms0O

tmsl

Setting Up the System Console

The default console entry in the /etc/ttys file is set to e for the baud rate.
For example:
console

"/etc/getty

If you have a hard-copy console, you can accept this default. However, if
you have a CRT console, you must change the entry in the /etc/ttys file to
std.9600.

For example:

console

retc/getty

std.9600¢x

Setting Up the Print System 4

The ULTRIX-32 print system software supports a wide variety of printers

configured within a local or remote network. This chapter describes the
files and programs that enable this support and that you use in setting up,
modifying, and maintaining your print system.

4.1

Print System Files and Programs

There are three broad categories of print system programs and files:

Print system database and support

Print system setup

Print system control

The following sections briefly identify and describe the components of each
category; subsequent sections in this chapter detail their use.

4.1.1

Print System Database and Support Files

The print system database and support files identify the elements of your
print system.
your site.
®

They specify what is available and how it is configured at

These files are:

{etc/printcap —

This file provides a descriptive database of your print

system software and hardware.
generic /etc/printcap file.
configuration explicitly.

The ULTRIX-32 software provides a

You modify this file to define your
At minimum, your /etc/printcap entries should

include a definition of the available printer(s), the local or remote
host(s), the print filter(s), the baud rate(s), the spooling directory(s),
and the output device associated with each printer. All users have
read access to this file; only the superuser has write access.
printcap(5)

See

in the ULTRIX Reference Pages and Section 4.3.2 for

more information.
o

/etc/printcap.examples —

definitions.

This file contains examples of line printer

You can use this file primarily as a sample or you can

copy the file as a template for your /etc/printcap file.

/devIMAKEDEV -

This shell script creates a device special file in the

/dev directory for each line printer.
this script.

See MAKEDEV(8)

Only the superuser has access to

in the ULTRIX Reference Pages and

Section 4.3.3.2 for more information.
°

/usr/lib/lpd —
handler.
file.

This program, the line printer daemon, is a print spool

Normally, the program is invoked at boot time from the rc

The daemon works with several system programs and files to

coordinate and synchronize printer activity.
supplies this file.

The ULTRIX-32 software

While you do not modify the file, you can specify

spooling, logging, and locking activities via the command line.
the superuser can access this program.

See Ipd(8)

Only

in the ULTRIX

Reference Pages and Section 4.5.1 for details.
o

{usr/lib/Ipdfilters —
print programs.

This directory contains print filter files used by
Omnly the superuser has write access to these files;

all users have read and execute permissions.

See Section 4.3.3.6 for

more information plus a listing of supported print filters and their
inclusion in the /etc/printcap file.
o

letc/hosts.lpd -~

This file contains the names and network addresses

of local and remote machines that can access system printers.
lusr/lib/ipd uses this file to check access privileges.

See Ipd(8)

in the

ULTRIX Reference Pages and Section 4.3.3.7 for more information.
°

letc/hosts.equiv —

addresses)

This file contains the names (but not the network

of "trusted” remote hosts.

Privileged access to a host

machine is granted to root if the name of the host is contained
within both the /etc/hosts.lpd file and the /etc/hosts.equiv files. See
Ipd(8)

in the ULTRIX Reference Pages and Section 4.3.3.7 for more

information.

4.1.2

The Print System Setup Program

The ULTRIX-32 software provides an automatic printer setup program to
simplify the task of setting up and modifying your print system. lprsetup
provides an interactive, easy-to-use method; it takes the information that
you supply, creates or deletes the spooling directory, modifies the /etc/ttys

file to prevent logins on the printer line, and creates or deletes the
corresponding /etc/printcap entry. See Iprsetup(8)

in the ULTRIX Reference

Pages and Section 4.4 for additional information.

4.1.3

The

Print System Control Files

In general, a well planned and structured print system needs little
maintenance.

Nevertheless, the ULTRIX-32 software provides files and

programs that simplify your work with the print system.

For example:

letc/lpc —

This program lets you control the operation of the line

printer system.

While most control functions are available only to

the superuser, some functions can be accessed by general users.
Ipc(8)
®

See

in the ULTRIX Reference Pages and Section 4.5.2 for details.

/etc/pac -

This program generates accounting information about

printer use at your site.

program.

See pac(8)

Only the superuser can access this

in the ULTRIX Reference Pages and Section

4.5.6 for details.
o

fusr/ucb/lpr —

printing.

This program lets you queue and submit files for

See Ipr(1)

in the ULTRIX Reference Pages and Section

4.5.3 for details.
o

/usr/ucb/lpq -

This program lets you examine the status of jobs

currently on the print queue.

See Ipg(1l)

in the ULTRIX Reference

Pages and Section 4.5.4 for details.
°

/usr/ucb/lprm —

queue.

This program lets you remove jobs from the print

See Iprm(1)

in the ULTRIX Reference Pages and Section

4.5.5 for details.

4.2

Choosing a

Print System Setup Method

You have two options for setting up or modifying your print system:
1.

You can set up your printer system manually. If you are familiar

with ULTRIX-32 and the print system, or if you are making a small
modification to your current setup, you might prefer to make changes
manually. Section 4.3 describes this process.
2.

You can use Iprsetup, an interactive program that walks you through

the process and provides on-line help.

If you are setting up a print

system for the first time, you might prefer this procedure. Section
4.4 describes the program and its use.

Choose the option that best complements your experience and the
requirements of your site.

The following sections describe each method and

the related files and programs.

4.3

Manually Setting Up or Modifying Your Print System

To set up or modify your print system manually, you must first create or
edit several files.

To help you in this process, the following sections

describe how to:
o

Collect prerequisite information

Identify the contents of the /etc/printcap file

Modify the /etc/printcap file

Select and define the logical device name for each printer

Create a device special file for each printer

Create and define a spooling directory for each printer

Identify and define the baud rate for each printer

Identify and define the output filter for each printer

Identify and define additional printer symbol entries

Identify and define remote printers

Use the /etc/printcap.examples file

Modify the /etc/ttys file

4.3.1

Collecting Prerequisite Information

Your primary goal is to build a data base of information about the type
and capabilities of printers supported at your site.

To build this data base,

first collect the following information about your print system configuration:

Determine which printers are attached via parallel lines, and which
printers are attached via serial lines. This data affects your entries in
both the /etc/itys file and the /etc/printcap file.

Identify the physical port to which each printer is attached. You need

this information when creating special device files and when making
printer specification entries in the /etc/printcap file.

Identify each remote printer you intend to configure into your print
system.

You need this information when making remote printer

specification entries in the /etc/printcap file.
®

Identify the capabilities of each printer, including the required print
filters.

You need this information when making printer synonym

entries in the /etc/printcap file.

Identify the parity requirements of applications software in use at
your site.

You need this information when examining or modifying

several printer synonym entries in the /etc/printcap file.

4.3.2

Identifying the Contents of the /etc/printcap File

You identify the local and remote printers within the /etc/printcap file.
These definitions establish how the ULTRIX-32 software knows and

controls access to each printer specified within your configuration.

generic version of /etc/printcap is created during the automated phase of

system installation.
However, you must modify this file to define the
specific local or remote printers you want accessed.
To modify /etc/printcap, you must understand each field in the line entries
of the file.

Be aware that:

Each field in /etc/printcap is separated from the next by a colon.
A backslash indicates that the next line is part of the same entry.

The first line contains the printer’s logical device name(s)

and a

description of the printer configuration for the /etc/printcap entry.
Subsequent lines define the parameters for each printer.

If you do

not specify certain parameters in /etc/printcap, the print system uses
a default value.

See printcap(5)

in the ULTRIX Reference Pages for a complete description

of the printcap fields and default values.
The following sample depicts an extract from an /etc/printcap file where the
system configuration includes local and remote hosts with attached printers.
#
#

LINE

PRINTERS

#
[ p2121lab2ltucson’s

1g0l

line

printer

Lab:\

lp=:rm=tucson:rp=ip2:sd=/usr/spool/Ip2:mx#0:

Ip31311ab3iig02

line

printer

Lab:\

:lp=:rm=phoenix:rp=Ip3:sd=/usr/spool/|Ip3:mx#0:

#
#
#

LASER

PRINTERS

#
I nlinOlllaserllnalinOlalprimary

In0l

laser

printer:\

lp=:rm=tucson:rp=lna:sd=/usr/spool/Ina:mx#0:

In0Ol1

taser

W
I

cif=/usr/lib/Ipdfilters/In0lof:\
cvif=/usr/lib/lpdfilters/In0Olvf:\

:pp=/usr/lib/lpdfilters/InOlpp:\

gf=/usr/lib/Ipdfilters/in01Sgf:\

T OIE W

dn=/usr/lib/Ipd:\

:lp=/dev/Iph:sd=/usr/spool/Ina:\

#IniinOlllaserilnallnOlalprimary

nf=/usr/lib/lpdfilters/In01Snf:\

Figure 4-1

:pw#HB80:p
| #66 :mc#20:sf:

Sample /etc/printcap File Extract

printer:\

4.3.3

Modifying the /etc/printcap File

Once you are familiar with the format of the /etc/printcap file, and have
collected the necessary information about your print system configuration

and components, you can modify the /etc/printcap file.

4.3.3.1

Identifying the

Name and Number of the

Printer -

The first

required item in any /etc/printcap entry is the name and number of the

printer. For example,
IpOllplOiparaliel

port

iine

printer:

In this example, the IpO entry is for a parallel line printer interface.

Since

IpO is generally your primary line printer, it uses the /etc/printcap entry Ip

by default. If you use the command Ipr, your file will print on this printer.
You could alternately specify Ipr

— PO, which would also print your file.

You can enter alternate names for the printer, such as “letter”, ‘“draft”
“LA-180 DecWriter III.”

If the name contains blanks or tabs, it should be

specified last.

4.3.3.2

Choosing The

Logical Device

physical connection (the port)

Name -

You must relate the

of each local printer to a logical device name

for that printer.

Note

The port information should be in the Site Management Guide,
prepared by the DIGITAL field service personnel who installed
the printer hardware.

The logical device name is specified in the Ip=
within /etc/printcap.

field of the printer entry

For example, in the first sample within Figure 4-2,

the logical device name associated with the LP25 printer is specified as
:Ip =/deV/Ip:
To choose a logical device name for your printer, relate the port number to
a logical device name.
Logical device names have one of the following
forms:
o

/devl/lpn for printers attached by parallel interfaces

/devittynn for printers attached by all serial interfaces

In both cases, n specifies the port number.
If your printer is an LGO1,
LG02, LP27, or LP29 attached to an LP11 interface, the installation has
already created an entry called /dev/Ip0, located in the /dev directory.
If
your printer is not configured this way, you must create entries in the /dev

directory.

The following section describes how to do this.

4.3.3.3

Creating a

Device Special File -

To create a device special file

in the /dev directory for each line printer, you run the shell script
MAKEDEV for each logical device. Use the logical device name as the
parameter passed to MAKEDEV.
#

MAKEDEV

For example:

/dev
Ipl

In this case, MAKEDEV creates a device special file for Ip1

named Ip1.

You must run MAKEDEV for each logical device name that does not
already exist.
exists.

Use the Is command to verify whether the device name

For example,

Ipl

-1
not

Ipl
found

For most serial line printers, the device name will be an existing terminal,

which can then no longer be used as a logical terminal.

The resulting files

become named special files for known devices.
When you have finished running the MAKEDEV script, you can check the
results by examining the /dev directory.

Use the Is command to determine

that each entry you created is listed.

4.3.3.4

Defining the Output Device -

When the print system is

physically connected to the printer port, it needs to open a device for the
output it produces.

You define that device with the lp parameter.

The

argument for Ip is the name of the file you created when you ran the

MAKEDEV script.

For example, you would define the device as:

tlp=/dev/1p0

4.3.3.5

Defining the Spooling Directory -

its own spooling directory.

Each line printer must have

Use the parameter sd to define the spooling

directory to the /etc/printcap data base.

For example,

:sd=/usr/spool
/| pd

Remember, you must create the spooling dlrectory itself, unless you use the

default directory /usr/spool/lpd.

4.3.3.6

Defining the

rate for the printer.

Baud Rate -

The br parameter specifies the baud

The baud rate is dependent upon the printer

hardware and can be found in your printer hardware manual.
rate applies only to serial printers and not to parallel printers.

The baud

:br#4800

This example defines the baud rate 4800 to the /etc/printcap data base.

4.3.3.7

Defining the Output Filters ~

filter program.

directory.

Every printer requires an output

The supported output filters reside in the /usr/lib/Ipdfilters

See Section 4 of the ULTRIX Reference Pages for a detailed

description of each supported print filter.

The more commonly used print

filters include:

la750f

Used to filter text data destined for the LA75 dot matrix
printer.

Handles printer device dependencies and performs

accounting functions.

1g020f

Used to filter text data destined for the LGO02 line printer.
Also handles printer device dependencies and performs
accounting functions.

InO1lof

Used to filter text data destined for the LNO1 and LNO1S
laser printers.
Handles printer device dependencies and
performs accounting functions.

InO1pp

Used to filter text data destined for the LNO1S laser
printer. This filter enables the pr(1)

print function and

sends the required control sequences to the printer that set
the size of the printable area.
In03of

Used to filter text data destined for the LNO03 and LNO03S
laser printers.

Handles the printer device dependencies and

performs accounting functions.

In03rof

Used to translate ASCII to Postscript format, enabling text
data printing on Postscript printers.

Also handles printer

dependencies and performs some accounting functions.

lgf

Used to filter text data destined for various letter quality
printers including: LQP02, LP25, LP26, LP27, LA50,
LA75, LA100, LA120, LA210, and LGO1.

Handles printer

device dependencies and performs accounting functions.
Ipf

Used to filter text data destined for the following impact
printers:

LP25,LP26, LP27,LA50, LA75.A100, LA120,

LA210, and LGO01.

Handles printer device dependencies

and performs accounting functions.

Used to transparently concatenate data directly to the
This filter can be used with any printer; it allows

printer.

device specific escape characters and control sequences to
reach the printer.

You define the output filter by including its path name in the /etc/printcap

file.

For example, if you are entering the printer specifications for an

LNO1 printer at your site and intend to use the InO1of output filter, enter
:of=/usr/lib/tpdfilters/In0Olof:

in the /etc/printcap file.

See Figure 4-2 for a sample of /etc/printcap print

filter entries.

4.3.3.8

Defining the Remote Printers -

To access a remote printer, you

must define the parameters Ip, rm, rp, and sd.
The argument for Ip is null.

For example, Ip=:.

the name of the remote host machine.

The argument for rm is

For example, rm=nin:. The

argument for rp is the name of the remote printer at that host.

example, rp=1Ip2:.

For

As entries in the /etc/printcap file, these fields would

be:
lp=:
irm=nin:
rp=1ip2:

In this example, nin is the remote host machine and lp2 is the remote
printer at that host.

system manager.

You must obtain these names from the remote

The argument for sd is the spooling directory.

For

example,
:sd=/usr/spool/Ipd

You should check your system’s /etc/hosts.lpd file, to ensure that it
contains the names of the remote machines in your network.

If the

remote system name is not in /etc/hosts.lpd, include it, and confirm with

the remote host’s system manager that your system users have access to
that printer.
Print requests to a remote system are accepted only if your system’s name

has been entered in the /etc/hosts.lpd file.

Note that an asterisk (*)

the start of any line in /etc/hosts.lpd allows remote print requests from all
systems.

Similarly, to allow remote systems to access your system’s

printers, enter their names in your system’s /etc/hosts.lpd file.

4.3.4

Using the /etc/printcap.examples File

The ULTRIX-32 software provides you with a file containing examples of
printer definitions.
This file, /etc/printcap.examples, assists you in setting
up your individualized file.

It consists of commented entries for various

types of printers and print capabilities.

In addition, it offers brief
instructions for using this file when creating or modifying your system’s

letc/printcap file.

To access /etc/printcap.examples, type:
#

/etc/printcap.examples

In response to your entry, the system displays an expanded version of the
sample file shown here.
#i#

/etc/printcap.examples:

/etc/printcap

templates.

‘

This

you

can

entries

file

‘

contains

use

examples

tailor

are

now

the

line

printcap

printer

entries

definitions

you

need.

#
#

The

Tailor

the

need.

When

# this
#

comments.

entries

you

done,

are

can

copy

file to /etc/printcap.

recover

from

while

# /etc/printcap.tmp
#H##

Copy

use,

editing

this

and

this

file

delete

file

the

/etc/printcap.tmp.

entries

you

/etc/printcap

Should you make a mistake you

this

file,

you

can

to /etc/printcap.examples,

copy

and

the

begin

local

LNO1l

printer

DMF32

parallel

:dn=/usr/1lib/Ipd:\

tif=/usr/lib/Ipdfilters/In0Olof:\

1 f=/usr/adm/ind-errs:\

lp=/dev/Ip:\

:mc#20:\

:mx#2000:\

:of=/usr/lib/Ipdfilters/InOlof:\

pl#60:\

Tpw#80:\

:sd=/usr/spool/In:

Hit#

Figure 4-2

/etc/printcap.examples File Extract

cannot

again.

interface:\

not

append

replica

#HH#

file

4.3.4.1

Modifying the /etc/ttys File —

If your printer is connected via a

serial line, you must edit the /etc/ttys file as follows:
Log on as superuser.
2.

Open /etc/ttys and locate the ttynn entry that corresponds to the
serial printer device specification.

For example, in Figure 4-3, the

line that corresponds to the serial printer is identified as tty02.

Edit the /etc/getty entry by changing the "on” entry to "off” if this
has not already been done.

#
#

dmf0

has

the

following

lines:

#
tty00

n/etc/getty

vt100

off

nomodem

secure

unused

tty0l

vw/etc/getty

vt100

nomodem

secure

vt100

tty02

n/etc/getty

vt100

off

nomodem

secure

printer

lab
(In0Olb)

tty03

n/etc/getty

vt100

off

nomodem

unused

spare

tty04

n/etc/getty

2»

vt100

off

nomodem

unused

spare

tty05

w/etc/getty

vt100

off

nomodem

unused

spare

tty06

n/etc/getty

vt100

off

nomodem

unused

spare

tty07

n/etc/getty

vit100

off

nomodem

unused

spare

#
#

Figure 4-3:

4.4

Sample /etc/ttys Extract

Using the Automatic Printer Setup Program

The Iprsetup program is an interactive program for setting up and
modifying the line printers on your system. You can use this program

when you need to add or delete a printer from your system or when you
need to modify the information relating to an existing printer.

After you

have entered the specification, Iprsetup creates the spooling directory,
modifies /etc/ttys to prevent logins on the printer line, and creates or

deletes an entry in /etc/printcap for the specification that you made.
4.4.1

Preparation

Access to the Iprsetup program is restricted to the superuser.

You must

log on as superuser before invoking the program.
When working with the Iprsetup program, you will need to specify
information about your system. Although the Iprsetup program sets default
values and provides on-line help, it simplifies your task if you are familiar
with the hardware and software specifications that Iprsetup needs.
items include:

These

Printer number

Specify a number from 0 to 99.

The

lprsetup default value, shown in square
brackets [n], indicates the number of printers
currently specified in the /etc/printcap file,
plus the entry you are about to make.

For

example, if you currently have 2 printer
specifications in the /etc/printcap file, the
program displays a default value of 3,
indicating that you are adding a third printer

specification.
Printer name

Specify the name of the printer type -- 1a100,
In01, or 1p27, for example.

You can specify

the name for a printer on a local or remote
system.

lprsetup uses this name to formulate

a default response for later questions. The
program displays a list of printer types from

which you can choose.

The default value is

‘unknown.’
Printer synonym

Specify the name by which you can identify
the printer.

For example, ‘draft’ could

represent an lg01 line printer.

Device pathname

Specify the name of the special file to open
for output.

For example, use /dev/lp for a

parallel printer.

For a serial line printer,

enter /dev/ttynn, where nn specifies the
printer number or any valid double-digit
number.

The program defaults to the next

consecutive number when setting up this file.

For example, if this is the third device on
your print system, the program supplies a

default value of /dev/tty03.
Printer baud rate

Specify the printer baud rate for serial
printers only.

The default value differs

according to the printer type.

Your serial

printer hardware manual lists the required

baud rate.

Accounting file name

Specify the (optional)

accounting file used to

keep track of the number of pages printed by

each user.

There should be a unique file

name for each printer.

For example, the

accounting file name for the third line printer
on your system could be /usr/adm/Ip3acct.

The program supplies a default value of
/usr/adm/xxnnacct where xx specifies the
printer type and nn specifies the printer
number.

Spooling directory

Specify the directory where files are queued

before they are printed.

Each spooling

directory should be unique. For example, you
could specify /usr/spool/lpd3 for the third line
printer.

The program supplies a default value

of /usr/spool/lpdn where n specifies the printer
number.

Error log file

Specify the (optional)
errors are reported.

should be unique.

log file where printer
Each printer’s log file

For example, you could

use /usr/adm/lp3err for the third line printer
at your site.

The program defaults to

/usr/adm/lpnerr where n specifies the printer

number.
Printcap symbol

Specify the (optional)

printcap symbol you

want to modify or add.

The program

provides a listing of available symbols and
on-line help.

Each of these symbols

represents a field in the /etc/printcap file.

See printcap(5) for a listing of the fields and
options.

Output filter

Specify the (optional)
with the printer.

output filter to be used

The choice of output filter

depends on the printer type. The lprsetup
program provides an on-line help listing of
available filters.

To get this listing, type ‘of’

for output filter when the program prompts
for a symbol name.

the on-line listing.

Then type help to get

Output flags

Specify the system’s treatment of the printer
line.

If your users are working with software

that requires parity changes (7 to 8 bit or
vice versa)

or generates both carriage return

and line feed characters, you should check
and possibly add or modify the settings for
the ‘fc’, ‘fs’, ‘xc¢’ or ‘xs’ printcap symbols.
For a complete discussion of print system

flags, see tty(4)

in the ULTRIX Reference

Pages.

4.4.2

Using lprsetup

When you are ready to set up or modify your printer configuration, and
are familiar with the hardware as well as the items listed in the previous

table, invoke the Iprsetup program.
1.

Enter the Iprsetup command in response to the system prompt:
#

Iprsetup

The program responds with a banner and menu.

ULTRIX-32

Printer

Command

add

Setup

modify

For example:

Program

delete

exit

view

quit

help

Select the menu item that you need to set up or modify your print
system.

4.4.2.1

The following sections describe how to do this.

Adding a New Printer to Your System - Choose the first menu

item, add, to add a new printer to your system. Type the entire word,

add, or abbreviate your choice by typing a.

In response to either entry,

the program displays a series of prompts, one at a time, for the following
information:

printer name, printer type, device pathname, accounting file,

spooler directory, error log file, and printer synonym. At each prompt,
Iprsetup provides a default value.
RETURN key.

value.

To accept the default value, press the

To request a different value, simply enter the non-default

4.4.2.2

Modifying an Existing Printer Specification -

Choose the second

menu item, modify, to modify an existing printer specification.
entire word, modify, or abbreviate your choice by typing m.

Type the

In response to

either entry, the program prompts for a printer name. Enter the synonym
name of a printer that currently exists in the /etc/printcap file.
If you are unsure of the synonym name, open the /etc/printcap file and
view the contents.
synonym name.

Locate the entry you intend to modify and check the

Exit the /etc/printcap file, return to the Iprsetup program,

and enter the required information.

4.4.2.3

Deleting an Existing Printer Specification -

Choose the third

menu item, delete, to delete an existing printer specification. Type the
entire word, delete, or abbreviate your choice by typing d.

In response to

either entry, the program prompts for a printer name. Enter the synonym
name of the printer you want deleted from the etc/printcap file.
If you are unsure of the synonym name, open the /etc/printcap file and
view the contents.
synonym name.

Locate the entry you intend to delete and check the

Exit the /etc/printcap file, return to the lprsetup program,

and enter the required information.

4.4.2.4

Exiting From the

Iprsetup Program -

item, exit, to leave the lIprsetup program.

abbreviate your choice by typing e.

Choose the fourth menu

Type the entire word, exit, or

In response to either entry, the

program exits and the system displays its prompt.

4.4.2.5

Viewing the /etc/printcap File -

Choose the fifth menu item,

view, to look at the current /etc/printcap file for your system.
entire word, view, or abbreviate your choice by typing v.

Type the

In response to

either entry, the program opens the /etc/printcap file for you.

4.4.2.6

Quitting the Current Operation or Iprsetup Program -

the sixth menu item, quit, to return to the lprsetup menu.

Choose

This item is

particularly helpful when you make an error and want to start again.

aware, however, that choosing this item during another operation causes the
program to ignore the entries made up to that point in the operation. Type

the entire word, quit, or abbreviate your choice by typing q.
to your entry, the program returns to the main menu.

In response

4.4.2.7

Getting On-line

Help -

Choose the seventh menu item, help, to

get on-line help while you are working with Iprsetup.

Initially, the help

item provides general information about the lprsetup program itself.
Typing help during another operation results in your getting additional

information about the operation you are currently performing.

Type the

entire word, help, or abbreviate your choice by typing h or ?.

In response

to your entry, the program displays information relevant to the current
operation.

4.4.3

Sample LA100 Line

Printer Settings

The following sample depicts the setup of an LA100 serial line printer.

This sample uses the printer number 0 for the LA100 and a baud rate of
4800 bps as specified in the hardware manual.

This printer is connected

on line tty02 and uses the default accounting file, spooling directory, error

log file, and flags set for an LA100 printer.

Thus, the printer settings you

will find in the /etc/printcap are:
Printer

Symbol

4.5

value

/usr/adm/lIpacct

4800

0177777

023

| f

/usr/adm/lIperr

I p

/dev/tty02

200

/usr/lib/lIpdfilters/Ipf

pwW
sd

80
/usr/spool/|pd

Controlling Print Jobs

Once installed with the proper software, the line printer spooler needs little
maintenance.
print jobs.

Nevertheless, there are times when you will need to control
To do this, you must understand the files and commands that

the system uses.
°

{usr/lib/lpd

/etc/lpc

/usr/ucb/lpr

/usr/ucb/ipg

fusr/ucb/lprm

/etc/pac

’T‘}‘\O

‘Fn"nun'nn‘

The files and commands are:

Qanf‘ir\nc

r]acn‘v"n'\o

kntxr

g1ean

FhAacn

31N

v
rd

e vmm s

o ]~

4.5.1

The

Ipd Line

Printer Daemon

The line printer daemon, Ipd, provides network communications of print
requests.
It also provides the selection and start of specific print filters
for specific print requests.
The print filters process the varying input
formats into printer-specific output format.
The line printer daemon interface is a task that runs itself and always
stays running, ready for input. This daemon is generally started at boot
time from the /etc/rc file.
The Ipd command invokes the line printer

daemon. When users submit print jobs with the Ipr command, the line
printer daemon schedules jobs to be printed and notifies printers that have
jobs waiting.
When first invoked, the line printer daemon checks the spooler directory
lusr/spool/lpd for the existence of a lock file.
The lock file is a signal to
Ipd that another job is currently printing.
If a lock file is not present, Ipd
creates one to reserve access to the printer for that particular print job.

Once the daemon creates the lock file, it scans the directory of files
These files are control files which represent print jobs.
For example:
beginning with c¢f.
%

lpr

-1

memo.1l

total

/usr/spool/lpd

~-rW-frW---~rW-fW=----

1
1

daemon
dmf

86
2358

July
July

9
9

11:11
11:11

cfAO24myvax
dfAO024myvax

-rW-r--r--

root

July

11:11

lock

~rw-rw-r--

root

July

11:11

status

The control file beginning with cf contains print instructions and the data
file beginning with df contains the formatted text.
The lock file contains
the process ID of the currently running daemon, while the status file
contains a line describing the current printer status. For further

information, see Ipd(8)

4.5.2

in the ULTRIX Reference Pages.

Controlling Printer Activity

The Ipc command allows you to control the activity of the line printers
and spooler queues listed in /etc/printcap.
You can use the Ipc command

to do the following:
®

Enable/disable a printer

Enable/disable a spooler queue
Alter order of queued jobs
o

Display printer, queue, or daemon status

Note

You must be superuser to enable or disable a printer or queue,
or to alter the order of queued jobs.

When invoked without arguments, the Ipc command prompts for commands
and arguments from the standard input.
The Ipc command may be invoked to change the order of jobs in the print
queue. To place an important job at the top of the queue, invoke Ipc, use
the topq command with the printer and job number as arguments.
Then
exit the Ipc procedure.
For example:
#

Ipc

Ipc>

topqg

queue
exit

order

Ip:

Ipc>

changed

For a complete list of Ipc commands and arguments, see Ipc(8) in the
ULTRIX Reference Pages.
4.5.3

Printing a

File

The Ipr command queues and submits a job for printing.

If you have a

file named memo.l, you can print the file using:
%

Ilpr

memo.1

The print command paginates the job before printing.
%

To do this type:

memo.1

If you pipe the file to Ipr, the file name is listed as standard input.

For

example:
%

cat

memo.1

Ipr

If no files are named, the standard input is read.

For further information, see lpr(1) in the ULTRIX Reference Pages.
4.5.4

Checking the Print Queue

The Ipg command displays the current contents of the line printer queue
and lists the jobs that have not yet printed.

For example:

1pq
is

ready

and

printing

Rank

Owner

Job

Files

Total

Size

active

dmf

memo . 1

23056

bytes

Ist

dmf

(standard

6987

bytes

input)

There are two jobs in the print queue belonging to user dmf.

The active

job is number 24, memo.l. The Ipq command displays information in the
order in which it is scheduled to print.

For further information, see Ipq(8)

in the ULTRIX Reference Pages.

4.5.5

Removing a Job From the Queue

The Iprm command allows you to remove a job from a queue.

To locate

the job number, and then remove a print job, type:
%

lpq

ready

and

printing

Rank

Owner

Job

Files

Total

Size

active

dmf

memo .1

23056

bytes

Ist

dmf

/etc/printcap

6987

bytes

tprm

dfA024myvax

dequeued

cfA024myvax

dequeued

When used without arguments Iprm deletes the currently active job, if it is
owned by you or if you are the superuser.

If invoked with a user’s name,

it removes all print jobs owned by that user.
Iporm(1)

in the ULTRIX Reference Pages.

4.5.6

Generating a

For further information, see

Report of Printer Use

Periodically, you should generate a report of your printer use.

The pac

command can be used only if you have specified an accounting file for each
printer for which a report is wanted.

command.
#

To generate this report, use the pac

For example:

/etc/pac

This command displays a report detailing number of pages printed, feet of
paper consumed, and total estimated cost per user.
information, see pac(8)

For further

in the ULTRIX Reference Pages.

Adding and Deleting Software Subsets 5

This chapter describes how to use the setld program to list, load, add,
delete, and verify software subsets.
You can save disk space with the
setld program by specifying and loading only the software subsets that you

need.

For detailed information on the setld command, its options, and the
command line syntax, see setld(8) in the ULTRIX Reference Pages.
Note
You must be the superuser to run the setld program.

5.1

Using setld Options

The setld command has specific options for listing, loading, adding, deleting,
and verifying software subsets. Although each option is different, the setld

command line syntax has certain common arguments, namely:
o

The optional path variable specifies the destination of the subset.
Specify this variable if you are loading the software to a file
hierarchy that starts somewhere other than at root (/).

The optional subset variable specifies the name of the subset.

The loc-code variable specifies the device special file or mount point
containing the media from which the subset or product is to be
transferred.

If you specify a path variable, it must precede the command option.
However, if you specify a subset or loc_code variable, it must follow the
command option.
Note

All NFS file systems should be dismounted before using the setld
command with the -a, -d, and -! options.

5.1.1

Listing Software Subsets

To get a listing of software subsets with the status of each and its
description, use the setld command with the -i (inventory) option.
The
syntax is:

/etc/setld

[path]

—-i

[subset]

For example, to display a list of subsets for a system running ULTRIX-32
Version 3.0, type:
#

/etc/setld

-i

You get a listing similar to this:

Subset

Status

Description

ULTACCTO030

Accounting Software

ULTBINO30

installed

Kernel

ULTBASEO30

installed

Base

Configuration

Files

System

ULTCOMMO30

Communications

ULTDCMTO030

Document

Utilities

Preparation

ULTEXERO30

instal led

System

Exerciser

UWSFONTO020

installed

X11/DECWindows

Fonts

UWSX11020

instal led

X11/DECwindows

User

Software

Package

Environment

To display the files included in a particular subset -- ULTBASEO030, for
example, type:
#

/etc/setld

-i

ULTBASEOQ30

You get a listing similar to this:
./vmb.exe

.Jusr/var/tmp
./usr/var/spool/rje

./usr/var/spool/mqueue/syslog

./.¢cshrc

5.1.2

Loading Subsets

To load a software product to your system for the first time, use the setld
command with the -| (load)
#

/etc/setld

option.

[path]

-1

The syntax is:
<loc_code>

In response, the setld program loads the mandatory subsets and the
optional subsets selected during the installation.
For example, assume you want to load the available software subsets from
the installation media located at drive 1 on a TK50 device to the hierarchy
that has its root at /mnt.
#

/etc/setid

5.1.3

To do this, type:

/mnt

-1

/dev/rmtlh

Adding Subsets

To add a subset to your system, use the setld command with the -a
(add)

option.

The syntax is:

/etc/setld

[path]

-a

<loc_code> subset

[subset...]

For example, assume you want to reinstall the UWSX11020 subset on your
system.

The software currently resides at /dev/rmtih and you want to add

it to your directory at /mnt.
#

/etc/setld

/mnt

-a

To do this, type:
/dev/rmtlh

UWSX11020

Note

Use the —a option only if the software product or individual
subset has been loaded previously.

See the preceding section,

Loading Subsets, for instructions on loading subsets for the first
time.

5.1.4

Deleting Subsets

To delete a subset from your system, use the setld command with the -d
option.

The syntax is:

/etc/setld

[path]

-d subset

[subset. . .]

For example, assume you want to delete the UUCP subset from your
system. The subset currently resides at /mnt.
#

5.1.5

/etc/setld

/mnt

-d

To delete this subset, type:

ULTUUCPO30

Verifying Subset Installations

To verify that a subset is installed correctly, use the setld command with
the -v option.
The syntax is:

/etc/setld

-v

[subset]

For example, to verify that the Communications Utilities subset has
installed correctly, type:
#

setld

-v

ULTCOMMO30

If the subset is installed, you get this message:
Checking

setld

data

files.

However, if the subset is not installed, you get this message:
Checking

setid

ULTCOMMO30:

data

not

files.

currently

installed

If you do not specify the optional subset variable, the setld program
verifies the correctness of all installed subsets.

Monitoring and Managing System Performance 6

This chapter provides guidelines that you can use to monitor and to
manage system performance.

The chapter points out the system-level

reports that you can produce to assist you in monitoring the system.

also offers guidelines for particular system management and optimization
tasks.

Specifically, the chapter discusses:
o

Managing system scheduling priority

Generating system accounting information

Checking Interprocess Communications Facilities Status

6.1

Managing Process Scheduling Priority

You can manage the system’s process scheduling priority of a given process
For example:

using the renice command.

/etc/renice

—u

name

In this example, the renice command lowers the scheduling priority of the
specified running processes, where name is the login ID of the user.
As the superuser, you can raise the scheduling priority of a user’s
processes by using a negative number instead of a positive number.
example:

For

# /etc/renice -5 —u name
You can raise or lower process scheduling priority on a scale from +20 to
-20.
For further information, see renice(8) in the ULTRIX Reference
Pages.

6.2

Generating System Accounting Information

There are two types of system accounting information: accumulated and
archived.
During daily operations, system accounting information is
accumulated so that you can keep track of day-to-day operations.
With
this information, you can keep track of:

User logins

Command usage

Printer usage

This section also describes commands used to display archived system
statistics.

6.2.1

Generating User Log-in Report

The system automatically maintains two log-in accounting files:
and /usr/adm/wtmp.

/etc/utmp

The system records all active logins in /etc/utmp and

accumulates a user log-in history in /usr/adm/wtmp.
You can generate a report of the system’s login-history with the ac

command:
#

/etc/ac

-p

Over time, /usr/adm/wtmp increases in size. After you generate a hardcopy
of the file you should clear it.

To clear the /usr/adm/wtmp file, use the cp

command with the arguments:
#

/dev/null

/usr/adm/wtmp

This command copies /dev/null to /usr/adm/wtmp.

That is, it reduces

/usr/adm/wtmp to a zero-length file.
Note

The system automatically enables log-in history, but it

accumulates a log-in history only if /usr/adm/wtmp exists.

disable the system log-in history, remove /usr/adm/wtmp.
For further information, see cp(1)

6.2.2

and ac(8).

Generating Command Usage

Report

During multiuser startup, /etc/rc normally enables system process
accounting.

When process accounting is enabled, the system records

information on each executed process (command)

in /usr/adm/acct.

some systems, system process accounting may be disabled to save disk
space.

You can display the contents of the system’s current process accounting
file, /usr/adm/acct using the sa command. For example:
#

/etc/sa

This report shows which commands are being used most often on the
system.

The file /usr/fadm/acct increases in size depending upon your system’s
activity.
To manage space on your /usr file system, you should condense
the process accounting information as necessary.
To condense
/usr/adm/acct, use the sa command with the -s option specified.
example:
#

/etc/sa

For

-s

This command merges the current information in /usr/adm/acct into the
process history file, /usr/adm/savacct.
Note

To disable process accounting immediately, type:
#

/etc/accton

To disable process accounting the next time the system reboots,
comment out this line in the /etc/rc file by putting a # in the
first column of the line on which the statement appears.
This
makes the accton line a comment which is not executed. For

example:
#

/etc/accton

/usr/adm/acct;

echo

-n

accounting’

/dev/console

For further information, see sa(8)

in the ULTRIX Reference Pages.

6.2.3

Report

Generating Printer Usage

Your system normally records all printer information in the default
accounting file named in /etc/printcap.

To generate a report of your printer usage, use the pac command.
example:
#

For

/etc/pac

The pac command displays a report detailing usage per user: number of

pages printed, feet of paper consumed, and total estimated cost.

Note
The system enables printer accounting only if /etc/printcap names
a default accounting file.
For further information, see printcap(5)
in the ULTRIX Reference Pages.

For further information, see pac(8)

in the ULTRIX Reference Pages.

6.2.4

Generating Active System Report

In addition to those commands that are used to display accumulated
system accounting information, the system has a number of commands that
you can use to display active system statistics. For example:
o

The iostat(1) command displays a report of current I/O statistics.

The ps(1) command displays a report of the system’s process status.

The uptime(1) command displays a report of how long the system
has been up.

The vmstat(1l) command displays a report of virtual memory
statistics.

The w(1) command displays a report of currently active users and
what they are doing.

The pstat(8) command displays various system tables.

The netstat(1) command displays network activity.

The nfsstat(8nfs) command displays activity on the Network File
System (NFS).

For further information on these commands, see the ULTRIX Reference
Pages.

6.3

Check Interprocess Communications Facilities Status

Some of the interprocess communications (IPC) facilities requested and
used by various processes are not automatically released when the
processes exit. You should alert system users to release the facilities after
the processes are finished with them. The users can either include an
explicit system call in the program to release the facilities, or they can
release the facilities using the ipcrm command after the process exits. The
facilities that must be released are shared memory, semaphores, and
message

queues.

If the users release the facilities properly, then there is no need to
administer them.
However, if the number of available message queues,
shared memory, or semaphores becomes exhausted, then use the ipcs
command to see the status of these resources.
If necessary, you can
release them by using the ipcrm command.
However, make sure that the
users are finished with the resources before you release them. You should
also show the users how to clean up the resources after having finished
using them.

This example shows how to use the ipcs command and gives a sample
output:

ipcs

IPC

status

Message
T

***

from

Shared

/dev/kmem

Fri

Jul

07:36:20

1985

Queues:
KEY

message

queues

MODE

are

currently

OWNER

defined

GROUP

***

Memory

KEY

400

1627788395

MODE
——rw-——me———

OWNER

GROUP

gdp

staff

OWNER

GROUP

gdp

staff

Semaphores
T

KEY

1644565427

MODE
-—-ra-——————

You must be logged in as superuser to release facilities owned by another
To release the semaphore found in the example type:

user.

ipcrm

-s

The -s indicates that a semaphore is to be released, and 2 is the unique
ID of the semaphore that was reported in the ipcs output.
For further
information, see ipcrm(1) and ipcs(1) in the ULTRIX Reference Pages.

Device Mnemonics A

This appendix identifies and defines the mnemonics that are used to attach
any hardware or software device to your system.
The mnemonics are used

by the /devIMAKEDEV shell script to create the character or block special
files that represent each of the devices.
The mnemonics also appear in
the system configuration file as described in the Guide to System
Configuration File Maintenance.

Table A-1 lists the mnemonics in seven categories: generic, consoles, disks,

tapes, terminals, modems, and printers.

The generic category lists the
mnemonics of a general nature and includes memory, null, trace, and tty

devices.
The consoles category lists the system console devices that the
ULTRIX operating system uses.
The disks, tapes, terminals, modems, and
printers categories identify the appropriate mnemonics for those devices.
The description heading in Table A-1 identifies the corresponding device
name.
It does not define the mnemonic’s use.
For detailed information
on the use of each mnemonic in relation to both the MAKEDEV script and

the system configuration file, refer to the reference pages in Section 4 of
the ULTRIX Reference Pages.
If on-line reference pages are available, you
can also use the man command.
For instance, if you enter at the system

prompt:
#

man

the system displays the reference page for the Mass Storage Control
disk controller driver.
Where appropriate, the SYNTAX

Protocol (MSCP)

section of the reference page defines the device’s syntax as it appears, or
should appear, in the config file. Refer to /deviIMAKEDEV for additional

software device mnemonics that MAKEDEV uses.
Refer to MAKEDEV(8)
the ULTRIX Reference Pages for a description of the MAKEDEV utility.

You should note that Table A-1 uses the convention of an asterisk (*)
beside a mnemonic and a question mark (?) beside a device name to mean
a variable number. The range of the variable number is dependent on the

particular device.

Table A-1: Devices Supported by MAKEDEV
Category

Mnemonic

Description

Generic

boot*
mvax*
vaxstation*
std
drum

Boot and std devices by cpu number; e.g., boot750
All MicroVAX setups; e.g., mvax2000
A VAXstation 2000 setup; e.g., vaxstation2000
Standard devices below with all console subsystems:
Kernel drum device

errlog
kUmem
kmem
mem
null
trace
tty
local

Error log device

Consoles

Disks

Tapes

Kernel Unibus/Q-bus virtual memory
Virtual main memory
Physical memory
A null device
A trace device
A tty device
Customer specific devices

console

System console interface

crl

Console RL02 disk interface for VAX 86?0

cs*
ctu*
cty*
cfl
ttycp

Console
Console
Console
Console
Console

RX50 floppy interface for VAX 8?70
TU58 cassette interface for VAX 11/750
extra serial line units for VAX 87?70
RX01 floppy interface for 11/787?
line used as auxiliary terminal port

hp*

MASSBUS disk interface for RM?? drives

ra*
ese*

UNIBUS/Q-bus/BI/HSC MSCP disk controller interface
UNIBUS/Q-bus/BI/HSC MSCP electronic ESE20 disk

rb*

UNIBUS IDC RLO2 disk controller interface
for RB?? drives

rd*
rz

VAXstation 2000 and MicroVAX 2000 RD type drives
SCSI disks (RZ22/RZ23/RZ55/RRD40)

rk*
rl*
rx*

UNIBUS RK?? disk controller interface
UNIBUS/Q-bus RL?? disk controller interface
VAXstation 2000 and MicroVAX 2000 RX type drives

mu*
tms*

TU78 MASSBUS magtape interface
UNIBUS/Q-bus/BI/HSC TMSCP tape controller interface
UNIBUS/Q-bus/BI/HSC TMSCP optical disk
UNIBUS/Q-bus TS11/TS05/TU80 magtape interface
TE16/TU45/TU77 MASSBUS magtape interface
VAXstation 2000 and MicroVAX 2000 TZK50
cartridge tape

rv*
ts*
tu*
st*