Compaq AA-RH8RD-TE User Manual

Tru64 UNIX

Documentation Overview for Version 5.1A

Part Number: AA-RH8RD-TE

June 2001

Product Version: Tru64 UNIX Version 5.1A

This manual describes the documentation for the Compaq Tru64 UNIX
operating system. It also describes the structure of the documentation
kits and provides information about ordering them.

Compaq Computer Corporation
Houston, Texas

© 2001 Compaq Computer Corporation

COMPAQ, the Compaq logo, AlphaServer, TruCluster, and VAX Registered in U.S. Patent and Trademark
Office. Tru64, OpenVMS, and Alpha are trademarks of Compaq Information Technologies Group, L.P in
the United States and other countries.

Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation. Motif in the United States
and other countries. OSF/1, UNIX , X Window System, and The Open Group are trademarks of The Open
Group in the United States and other countries.

All other product names mentioned herein may be trademarks of their respective companies.

Confidential computer software. Valid license from Compaq required for possession, use, or copying.
Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software
Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under
vendor’s standard commercial license.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information
in this document is provided “as is” without warranty of any kind and is subject to change without
notice. The warranties for Compaq products are set forth in the express limited warranty statements
accompanying such products. Nothing herein should be construed as constituting an additional warranty.

About This Manual

1 Finding the Documentation You Need

1.1

1.1.1

1.1.2

1.1.3

1.2

1.2.1

1.2.2

1.2.3

1.2.4

1.2.5

1.3

1.4

1.4.1

1.4.2

1.5

1.5.1

1.5.2

1.5.3

1.6

1.6.1

1.6.2

1.6.3

1.6.4

Introduction to the Documentation Set .. . . .... . . .. ............... 1–1

Core Documentation .............................................

Supplementary Documentation . . .............................. 1–2

Layered Products ... . .............................................

Changes to the Version 5.1A Documentation Set ................ 1–3

Structural Changes . .............................................

Revised Documentation ... . . .... . . .. ............................ 1–3

New Documentation .............................................

Removed Documentation . . .. .. . .. .. ............................ 1–5

Device Driver Documentation . . .. .. ............................ 1–5

What You Get ..........................................................

Online Documentation ...............................................

The Documentation CD–ROM . .. . ............................. 1–7

Documentation on the World Wide Web .... . .. ............... 1–8

Printed Documentation ..............................................

End User Documentation Kit .. .. . ............................. 1–10

Developer’s Documentation Kit ... . ............................ 1–11

Additional Documentation in the Media Kit .. ............... 1–12

Documentation for Layered Products .............................. 1–12

TruCluster Server Software ... . .. .. ............................ 1–12

Other Products Packaged with Tru64 UNIX ................. 1–12

Tru64 UNIX Alpha Online Documentation Library .. . . .. . . 1–13

Device Driver Documentation . . .. .. ............................ 1–13

Contents

1–2

1–3

1–3

1–5

1–5
1–6

1–9

2 General User Documentation

2.1

2.1.1

2.1.2

2.1.3

2.1.4

2.1.5

2.1.6

Printed and Online Documentation .. . ............................. 2–1

CDE Companion ................................................. 2–1

Cluster Release Notes (revised) . . .. ............................. 2–2

Cluster Technical Overview (revised) ... . .. . .. .. ............... 2–2

Command and Shell User’s Guide (revised) . . ............... 2–2

Documentation Overview for Version 5.1A (revised) .. .. . .. . 2–2

Master Index (revised) .. . . .... . . .. . .............................. 2–3

Contents iii

2.1.7

2.1.8

2.1.9

2.1.10

2.2

2.2.1

2.2.2

2.2.3

2.3

2.3.1

2.3.2

2.3.3

2.3.4

2.3.5

2.3.6

Programming Support Tools ...................................

Release Notes for Version 5.1A (revised) .. . .. . ................ 2–4

Security (revised) ... . .............................................

Technical Overview for Version 5.1A (revised) ............... 2–5

Printed-Only Documentation . .. .. . .... . ............................

Quick Reference Card (revised) . . .. ............................

How to Access Tru64 UNIX Documentation (revised) .. . .. . 2–6

Tru64 UNIX Version 5.1A CD–ROMs (revised) .... . .. .. . .... 2–7

Online-Only Documentation . .. . .... . . .. ............................ 2–7

New and Changed Features from Previous Releases

(revised) .. .........................................................

Advanced Printing Software User Guide .................... 2–7

Common Desktop Environment: User’s Guide ............... 2–8

Common Desktop Environment: Advanced User’s and

System Administrator’s Guide ................................. 2–8

How to Order Tru64 UNIX Documentation .................. 2–8

Safety & Comfort Guide .........................................

3 System and Network Management Documentation

3.1

3.1.1

3.1.2

3.1.3

3.1.4

3.1.5

3.1.6

3.1.7

3.1.8

3.1.9

3.1.10

3.1.11

3.1.12

3.1.13

3.1.14

3.1.15

3.1.16

3.1.17

3.1.18

3.1.19

3.1.20

3.1.21

Printed and Online Documentation .. . ............................. 3–1

AdvFS Administration (revised) . .. ............................ 3–1

Cluster Administration (revised) . ............................. 3–2

Cluster Hardware Configuration (revised) . .. ................ 3–2

Cluster Highly Available Applications (revised) ... .. . .. . .... 3–3

Cluster Installation (revised) .. .. . .. ............................ 3–3

Cluster LAN Interconnect (new) .. . ............................ 3–4

Guide to Prestoserve ............................................. 3–4

Installation Guide (revised) . . . .... . ............................ 3–4

Installation Guide — Advanced Topics (revised) ... . . .... . . . 3–5

Kernel Debugging ................................................ 3–5

Logical Storage Manager (revised) ............................ 3–6

Managing Online Addition and Removal (new) . .. . .. .. . .... 3–6

Network Administration: Connections (new) ................ 3–7

Network Administration: Services (new) . . .. .. ............... 3–8

Security (revised) ... . ............................................. 3–9

Sharing Software on a Local Area Network (revised) . .. .. . 3–9

Software License Management ................................. 3–9

System Administration (revised) .. . ............................ 3–10

System Configuration and Tuning ............................ 3–11

System Configuration Supplement: OEM Platforms ....... 3–11

X Window System Environment (revised) ... . ................ 3–11

2–3

2–4

2–6
2–6

2–7

2–8

iv Contents

3.2

3.2.1

3.2.2

3.2.3

3.3

3.3.1

3.3.2

3.3.3

3.3.4

Printed-Only Documentation . .. .. . .... . ............................

Full Installation Quick Start (revised) .. . . .... . ............... 3–12

Update Installation Quick Reference Card (revised) . . .. .. . . 3–12

X Window System Administrator’s Guide ....................

Online-Only Documentation . .. . .... . . .. ............................

BIND Configuration File Guide ................................

DECevent Translation and Reporting Utility ................ 3–13

Performance Manager (revised) .. . ............................. 3–13

sendmail Installation and Operation Guide ................. 3–13

4 Programming Documentation

4.1

4.1.1

4.1.2

4.1.3

4.1.4

4.1.5

4.1.6

4.1.7

4.1.8

4.1.9

4.1.10

4.1.11

4.1.12

4.1.13

4.1.14

4.1.15

4.2

4.2.1

4.2.2

4.2.3

4.3

4.3.1

4.3.2

4.3.3

4.3.4

4.3.5

Printed and Online Documentation .. . ............................. 4–1

Assembly Language Programmer’s Guide ................... 4–1

Asynchronous Transfer Mode .................................. 4–1

Calling Standard for Alpha Systems ......................... 4–2

Cluster Highly Available Applications (revised) ... .. . .. . .... 4–2

Compaq C Language Reference Manual (revised) . . .. .. . .. .. 4–2

Guide to Preparing Product Kits (revised) ... . ............... 4–3

Guide to Realtime Programming .............................. 4–3

Guide to the POSIX Threads Library ......................... 4–3

Network Programmer’s Guide (revised) .. . .. .. ............... 4–3

Programmer’s Guide ............................................

Programming Support Tools ...................................

Programming with ONC RPC .................................. 4–5

Security (revised) ... . .............................................

Writing Kernel Modules ........................................ 4–5

Writing Software for the International Market .............. 4–6

Printed-Only Documentation . .. .. . .... . ............................ 4–6

OSF/Motif Programmer’s Guide .............................. 4–6

OSF/Motif Style Guide ......................................... 4–7

Programmer’s Guide: STREAMS ............................. 4–7

Online-Only Documentation . .. . .... . . .. ............................ 4–7

Common Desktop Environment: Application Builder

User’s Guide ...................................................... 4–7

Common Desktop Environment: Desktop KornShell User’s

Guide ............................................................... 4–8

Common Desktop Environment: Help System Author’s and

Programmer’s Guide ............................................. 4–8

Common Desktop Environment: Internationalization

Programmer’s Guide ............................................. 4–8

Common Desktop Environment: Product Glossary ......... 4–8

3–11

3–12
3–12
3–12

4–4
4–5

4–5

Contents v

4.3.6

4.3.7

4.3.8

4.3.9

4.3.10

4.3.11

4.3.12

4.3.13

4.3.14

Common Desktop Environment: Programmer’s Guide ..... 4–9

Common Desktop Environment: Programmer’s Overview . 4–9

Common Desktop Environment: Style Guide and

Certification Checklist ...........................................

Java Documentation . ............................................

Ladebug Debugger Manual (revised) .. . .. . .... . ............... 4–9

Object File and Symbol Table Format Specification ....... 4–10

Technical References for Asian Languages . .. ................ 4–10

ToolTalk Service Documentation .. ............................ 4–10

X Window System Documentation ............................ 4–11

5 Supplementary Documentation

5.1

5.2

5.2.1

5.2.2

5.2.3

5.2.4

5.3

Web-Based Best Practices Documentation . . .. . .. .. ............... 5–1

Operating System CD–ROM . . .. .. . .. . .............................. 5–2

QuickSpecs . .... . . .. .. .............................................

Listings of Patches to the Operating System ................ 5–2

Text Version of the Tru64 UNIX Release Notes .............. 5–3

X Image Extension Documentation . . .. .. . .... . ............... 5–3

Associated Products CD–ROMs .. . .... . ............................ 5–4

6 Tru64 UNIX Reference Pages

6.1

6.1.1

6.1.2

6.1.3

6.1.4

6.2

6.3

Reading Reference Pages On Line . . . .............................. 6–1

Using the Documentation CD–ROM ... . .. .. . .. ............... 6–1

Using webman .... . .. .............................................

Using the xman Command .. .. . .. .. ............................ 6–2

Using the man Command ... . .. .. . .. ............................ 6–2

Reading Reference Pages in Printed Books .... .. . ................ 6–2

Overview of the Reference Page Sections .. . .. .. . .. ............... 6–3

4–9
4–9

5–2

6–1

7 Device Driver Documentation

A Documentation Listings

A.1 Components of the Tru64 UNIX and TruCluster Server

Printed Documentation Kits . . .. .. . .. .. ............................. A–1

A.1.1 Tru64 UNIX Documentation Kit .. ............................. A–1

A.1.2 TruCluster Server Documentation Kit . . .. . .. .. ............... A–2

A.2 Supplementary Documentation on the Documentation

CD–ROM .. .. .. ......................................................... A–2

A.3 Alphabetical Listing of Core, Supplementary, and TruCluster

Server Documentation . .. ............................................ A–3

vi Contents

Index

Figures

1–1
2–1

Structure of the Tru64 UNIX Documentation Kit ............... 1–9

Example Master Index Search .. . .. . .. .. ............................ 2–3

Tables

A–1 Alphabetical Listing of Core, Supplementary, and TruCluster

Server Documentation . .. ............................................

A–4

Contents vii

This manual describes the documentation that comes with the Compaq
Tru64™ UNIX operating system. It also provides information about
the structure of the documentation kits and the tools used to access the
documentation.

Audience

This manual is for anyone who needs to access documentation about the
Tru64 UNIX operating system. It can help you decide which manuals in
the documentation set are most useful to you and how you can use those
manuals.

New and Changed Features

This manual was revised to provide you with information about changes to
the Tru64 UNIX documentation that have been made since the last release
of the operating system. For an overview of the major changes to the Version

5.1A documentation set, see

Section 1.2.

Organization

About This Manual

This manual is organized as follows:

Chapter 1 Provides general information about the Tru64 UNIX

documentation set.

Chapter 2 Describes the manuals and other documentation that are used

Chapter 3 Describes the manuals and other documentation that

Chapter 4 Describes the manuals and other documentation that are

Chapter 5 Describes some additional documentation that is packaged on the

by all users of the Tru64 UNIX operating system.

are used by system and network administrators of the
Tru64 UNIX operating system.

used by software developers who program on or for the
Tru64 UNIX operating system.

Tru64 UNIX Operating System and Associated Products CD–ROMs.

About This Manual ix

Chapter 6 Describes the Tru64 UNIX reference pages, shows the various

ways of displaying the reference pages on line, and describes the
contents of the Reference Pages Documentation Kit.

Chapter 7 Describes the Device Driver Kit and the contents of

the books in that kit.

Reader’s Comments

Compaq welcomes any comments and suggestions you have on this and
other Tru64 UNIX manuals.

You can send your comments in the following ways:

• Fax: [phone] Attn: UBPG Publications, ZKO3-3/Y32

• Internet electronic mail: [e-mail]

A Reader’s Comment form is located on your system in the following
location:

/usr/doc/readers_comment.txt

Please include the following information along with your comments:

• The full title of the manual and the order number. (The order number
appears on the title page of printed and PDF versions of a manual.)

• The section numbers and page numbers of the information on which
you are commenting.

• The version of Tru64 UNIX that you are using.

• If known, the type of processor that is running the Tru64 UNIX software.

The Tru64 UNIX Publications group cannot respond to system problems
or technical support inquiries. Please address technical questions to your
local system vendor or to the appropriate Compaq technical support office.
Information provided with the software media explains how to send problem
reports to Compaq.

x About This Manual

Finding the Documentation You Need

You can find most of the Tru64 UNIX documentation you need on the
Documentation CD–ROM that comes with the Tru64 UNIX product and also
on the World Wide Web. Most of this documentation is provided on line in
HTML and PDF formats and is also available as printed books.

Your Web browser gives you access to the HTML format, and the Adobe
Acrobat Reader lets you view and print the PDF versions. The printed books
are packaged in kits that you can purchase from Compaq.

Additional documentation is included on the Tru64 UNIX Operating System
CD–ROM and on the Associated Products CD–ROMs.

This chapter can help you to find the documentation you need, in the format
that is most convenient to you.

1.1 Introduction to the Documentation Set

Tru64 UNIX is a feature-rich operating system designed to be used in many
different types of computing environments. The components of the operating
system range from those used by every user to those used by only a small
handful of users.

1

Likewise, the documentation must serve many different users in different
fields and with different levels of technical knowledge — from the novice
general user to the advanced system administrator or program developer.

The Tru64 UNIX documentation is organized according to whether it is
used by all users, or specifically by system and network administrators and
software programmers:

• General user documentation

This information is for all users of the Tru64 UNIX operating system.
Examples include the Master Index and the Release Notes. Users of this
information range from novice to advanced.

• System and network management documentation

This information is for those who install, configure, maintain, and
troubleshoot the Tru64 UNIX operating system.

• Programming documentation

Finding the Documentation You Need 1–1

This information is for those who develop software on and/or for the
Tru64 UNIX operating system.

Be aware, however, that some of this documentation is written to serve
different audiences. For example, the
parts to provide guidance for individual users, system administrators, and
programmers who must develop secure programs.

The following sections describe some of the terms used to categorize
documentation that is provided with the operating system or used in
conjunction with utilities and applications that run on the operating system.

1.1.1 Core Documentation

Core documentation consists of books and reference pages that help you to
use the Tru64 UNIX operating system, including the components provided
when you install the system’s optional and mandatory subsets.

The core documentation is provided in printed and online formats and was
created by Compaq writers who worked closely with the developers of the
operating system to document the system’s various components (except for a
few externally published manuals).

On line, the Tru64 UNIX reference pages are available as optional subsets of
the operating system and in HTML format on the Documentation CD–ROM.
They are also available as printed books in a multivolume kit.

Security manual is divided into three

For information about the core manuals and guides, see the “Printed and
Online Documentation” sections of Chapter 2, Chapter 3, and Chapter 4. For
information about the reference pages, see Chapter 6.

1.1.2 Supplementary Documentation

Supplementary documentation tends to be less formal in structure than
the core documentation. This category includes many different types of
documents, such as QuickSpecs (formerly called Product Descriptions),
release notes for some components of the Tru64 UNIX operating system,
and industry reference material and white papers that come from Compaq
engineers and other sources. Supplementary documentation exists only on
line, so it is not available in any of the printed Tru64 UNIX documentation
kits.

Much of the supplementary documentation is provided on the Documentation
CD–ROM, although some is packaged with the individual software subsets
or in various directories on Tru64 UNIX media. For more information about
the supplementary documentation on the Documentation CD–ROM, see the
“Online Documentation” sections of the following chapters. For information
about other supplementary documentation, see Chapter 5.

1–2 Finding the Documentation You Need

1.1.3 Layered Products

Layered products documentation consists of books and other documents that
aid in the use of separately licensed products, such as TruCluster™ and
Compaq C++. For more information, see Section 1.6.

1.2 Changes to the Version 5.1A Documentation Set

This section describes changes to the ways you can access documentation
and lists the documentation that was revised, removed, or offered for the
first time in this release. See the appropriate section in the following
chapters for information about a book’s content.

1.2.1 Structural Changes

With this release of Tru64 UNIX, the Compaq TruCluster Server
documentation is included on the Tru64 UNIX Documentation CD–ROM,
as well as on the Associated Products Volume 2 CD–ROM. The books are
described in Chapter 2, Chapter 3, and Chapter 4. See Section A.1.2 for
a list of the books and Section 1.6.1 for information about the TruCluster
Server software.

This release also introduces a new search function that will help you find
specific Tru64 UNIX and TruCluster Server topics in any document on the
documentation Web site or on a local area network. See Section 1.4 for more
information.

1.2.2 Revised Documentation

The following core and supplementary documentation was revised in this
release. The changes were made to the printed books and their online
versions, unless otherwise noted.

In some cases, the documents were revised to provide information about new
and changed features to the operating system. In other cases, the revisions
expand or otherwise improve existing information.

Although the TruCluster Server manuals were previously available,
this release marks the first time they are included on the Tru64 UNIX
Documentation CD–ROM. All of the cluster manuals have been revised.

General User Documentation

• Cluster Release Notes

• Cluster Technical Overview

• Command and Shell User’s Guide

Finding the Documentation You Need 1–3

• How to Access Tru64 UNIX Documentation (print-only document)

• Master Index

• Quick Reference Card (print-only document)

• Release Notes for Version 5.1A

• Security

• Technical Overview for Version 5.1A

• Tru64 UNIX Version 5.1A CD–ROMs (print-only document)

System and Network Administration

• AdvFS Administration

• Cluster Administration

• Cluster Highly Available Applications

• Cluster Hardware Configuration

• Cluster Installation

• Full Installation Quick Start (print-only document)

• Installation Guide

• Installation Guide — Advanced Topics

• Logical Storage Manager

• Network Administration

The information in this manual has been divided into two new manuals:

– Network Administration: Connections (Section 3.1.13)

– Network Administration: Services (Section 3.1.14)

• Performance Manager (online-only document)

• Sharing Software on a Local Area Network

• System Administration

• Update Installation Quick Reference Card (print-only document)

• X Window System Environment

Programming Documentation

• Compaq C Language Reference Manual

• Guide to Preparing Product Kits

• Ladebug Debugger Manual (online-only document)

• Network Programmer’s Guide

1–4 Finding the Documentation You Need

• Technical Reference for Using Chinese Features (online-only document)

• Technical Reference for Using Japanese Features (online-only document)

1.2.3 New Documentation

The following documentation is new with this release:

• Managing Online Addition and Removal

This manual is provided on line and in printed format; it is included with
the system and network management documentation.

• Cluster LAN Interconnect

This manual is provided on line and in printed format; it is included
with the system and network management documentation and the
programming documentation.

• System Limits

This document is available only from the Web. See Section 1.4.2 for
more information.

1.2.4 Removed Documentation

The Compaq Portable Mathematics Library manual has been removed from
the Tru64 UNIX documentation set. It is still available on the Web in the
documentation sets of previous releases of the operating system.

1.2.5 Device Driver Documentation

Chapter 7 now describes the documentation provided with Version 2 of the
Device Driver Kit.

1.3 What You Get

The documentation that you receive from Compaq depends upon the
purchase you make:

• If you purchase a Tru64 UNIX media kit, you receive a CD–ROM
containing all of the online documentation, as well as printed versions of
the Startup documentation described in Section 1.5.

• If you purchase the Tru64 UNIX Documentation Kit, you receive printed
versions of the books described in Section 1.5.

• If you purchase an Update Contract for the media, you receive the most
current version of the Documentation CD–ROM, and printed versions of
new and revised books in the Startup documentation.

Finding the Documentation You Need 1–5

• If you purchase an Update Contract for the documentation set, you
receive printed versions of the books that have been updated.

• If you purchase a system with the Tru64 UNIX operating system
preinstalled (often called a FIS system, for factory installed software),
online versions of the following books are installed on the system:

Release Notes for Version 5.1A

–

– Installation Guide

– Installation Guide — Advanced Topics

– Security

– System Administration

– Network Administration: Services

– Network Administration: Connections

– Documentation Overview for Version 5.1A (the book you are reading)

– Safety & Comfort Guide

1.4 Online Documentation

The documentation for the Tru64 UNIX operating system, including the
reference pages, is available on the Tru64 UNIX Documentation CD–ROM
in formats that are readable with a Web browser or with the Adobe Acrobat
Reader.

This documentation, as well as documentation for associated applications,
is also available on the World Wide Web (see Section 1.4.2). Most of the
features that are available on the Documentation CD–ROM, such as the
links to other documentation, are also available on the Web.

If you are working on a Compaq Alpha™ system, the operating system
provides a Netscape browser for viewing the HTML documentation. If you
want to view the documentation on a Windows PC or Macintosh, you will
need a browser that supports frames and JavaScript Version 1.1, such as
Version 4.0 or higher of Netscape Navigator, Netscape Communicator, or
Microsoft Internet Explorer.

To view the PDF files, you need to install Version 3.0 or higher of the
Adobe Acrobat Reader or the Reader plug-in to your Web browser. The
Documentation CD–ROM provides the Acrobat Reader for Tru64 UNIX
systems, Windows PCs, Macintosh, and several other platforms. You can
also obtain the latest version directly from the Adobe Systems Inc. Web site:

http://www.adobe.com

1–6 Finding the Documentation You Need

With Acrobat Reader, you can scroll through books, print selected sections or
entire books, and copy sections to the clipboard.

The Version 5.1A release offers a new full-text search facility, called isearch,
for finding information in Tru64 UNIX documentation on the Web and on
local area networks, using any platform, including UNIX workstations,
Macintosh computers, and PCs:

• When accessing Tru64 UNIX documentation on the Web, you simply
type a word or words in the search facility to find the places in the
documentation that discuss the topic.

• To use the search facility on an intranet, your system administrator
must install the isearch software on your local server. Thereafter, users
with access to that server can search the documentation in the same way
as they would on the Web.

The required software is provided free on the Tru64 UNIX Documentation
CD–ROM.

1.4.1 The Documentation CD–ROM

The Documentation CD–ROM contains HTML and PDF versions of Tru64
UNIX documents. The complete set of operating system reference pages is
available in HTML format. The CD–ROM provides links to these HTML
and PDF documents.

You can use the Tru64 UNIX Documentation CD–ROM on a Tru64 UNIX
system, as well as on a Windows PC or Macintosh — laptop or workstation —
or on any other system that uses the ISO 9660 Level 1 CD–ROM standard.

In addition to the isearch facility described in Section 1.4, the Documentation
CD–ROM contains a copy of the AltaVista Search CD–ROM software with a
complete index of the HTML documents. The AltaVista software runs on an
x86–based PC with Windows 95, Windows 98, Windows 2000, or Windows
NT Version 4.0.

The CD–ROM’s online Documentation Library is arranged in categories
that generally follow the structure of the printed documentation kits. Each
category is represented by a bulleted list, with the bullet for each book
colored to indicate the documentation subkit to which the book belongs:

• A blue bullet indicates documentation for general users.

• A purple bullet indicates documentation for programmers.

• A red bullet indicates documentation for system and network
administrators.

Finding the Documentation You Need 1–7

• A silver bullet indicates supplementary documentation, which is
documentation that is not part of any kit and cannot be ordered from
Compaq.

• A green bullet indicates reference pages.

Books that meet the needs of different audiences appear in several
categories. For example, you will find the Security manual in the General
User, Programming, and System and Network Management categories
because it serves each of those audiences. Because it is part of the General
User subkit, its bullet is blue in all of the categories in which it appears.

Most cross-references are hot links, so you can follow those references from
book to book, from book to reference page, from reference page to book, and
from reference page to reference page.

Each book you refer to opens in a separate window so you can easily move
from book to book as you gather the information you need. When following
links to reference pages, the first reference page opens in a new window, and
references to subsequent reference pages will appear in the same reference
page window as long as you keep it on your screen.

The Documentation CD–ROM also contains the webman viewer, a program
you can use with your browser to view reference pages. For information
about the webman viewer, see Chapter 6.

To mount the Documentation CD–ROM on Tru64 UNIX systems, PCs, and
Macintosh computers, see the information accompanying the Documentation
CD–ROM. The Tru64 UNIX Installation Guide provides an overview of using
CD–ROMs on Tru64 UNIX systems.

1.4.2 Documentation on the World Wide Web

You can find most of the Tru64 UNIX core and supplementary documentation,
the reference pages, and other useful documentation on the World Wide Web.
To view this documentation, point your browser to the following Web site:

http://www.tru64unix.compaq.com/docs

Other documentation you will find there includes the following:

• Tru64 UNIX Best Practices documentation (see Section 5.1 for details)

• Tru64 UNIX Device Driver documentation library (see Chapter 7 for
details)

• TruCluster Server (including the TruCluster reference pages)

• Documentation sets from previous versions of the operating system

• Advanced Server for UNIX (ASU)

1–8 Finding the Documentation You Need

• Internet Express for Tru64 UNIX (formerly Open Source Internet
Solutions)

• Tru64 UNIX Porting Guides

• Tru64 UNIX POSIX Conformance Documentation

• System Limits

This document lists the system limits for the components of the Tru64
UNIX operating system.

The Web site also provides updates to documentation between formal
product releases. For example, Compaq maintains online Technical Updates,
which provide information about restrictions and problems that have been
discovered with specific versions since their release. Visit the following Web
site to see the Technical Update for Version 5.1A:

http://www.tru64unix.compaq.com/docs/pub_page/update_list.html

We recommend that you view this site periodically to see if any new
information has been added.

1.5 Printed Documentation

When you purchase a Tru64 UNIX media kit, you receive printed versions of
various manuals to help you install and begin using the operating system. To
receive printed versions of the rest of the core documentation, you must order
a Tru64 UNIX Documentation Kit (Figure 1–1) or one or more of its subkits.

Figure 1–1: Structure of the Tru64 UNIX Documentation Kit

Startup Kit

End User

Kit

General
User Kit

System and Network

Management Kit

Developer's

Kit

Finding the Documentation You Need 1–9

The printed manuals include a letter icon on the spine to help you quickly
find the book you are looking for. The following icons are used:

G Indicates books that are for general users

Indicates books that are for system and network administrators

S

P

Indicates books that are for programmers

Although a book’s primary audience determines the documentation kit
it is packaged in, some books help meet the needs of several audiences.
For example, a general user can read the Programming Support Tools
manual (packaged in the Developer’s Documentation Kit) to get advanced
information about using commands such as grep or awk. The Security
manual (packaged in the General User Documentation Kit) provides
information for system administrators and programmers, as well as for
general users. Keep this in mind when searching for information on specific
topics.

The following sections describe the kits that comprise the Tru64 UNIX
Documentation Kit and the documentation that each kit contains. This
documentation is also provided on line, except where indicated.

1.5.1 End User Documentation Kit

The End User Documentation Kit contains all the information needed to
install, use, and administer the Tru64 UNIX system. This kit is divided
into three subkits as follows:

• Startup Documentation Kit

This kit is primarily for the person who installs the Tru64 UNIX
operating system. It contains information on how to configure software
components and some information (such as the Release Notes) needed
by all Tru64 UNIX users.

When you order the Tru64 UNIX operating system, the books in the
Startup Documentation Kit are packaged with the distribution media.

This kit contains the following documentation:

Release Notes for Version 5.1A
Technical Overview for Version 5.1A
Documentation Overview for Version 5.1A
Installation Guide
Installation Guide — Advanced Topics
Full Installation Quick Start Card (printed only)
Update Installation Quick Reference Card (printed only)
Quick Reference Card (printed only)
Tru64 UNIX Version 5.1A CD–ROMs (printed only)

• General User Documentation Kit

1–10 Finding the Documentation You Need

This kit provides general information on how to use the Tru64 UNIX
operating system. The manuals in this kit are for everyone who uses
Tru64 UNIX.

This kit contains the following documentation:

CDE Companion
Command and Shell User’s Guide
Master Index
Security

• System and Network Management Documentation Kit

This kit is for people who are responsible for managing the Tru64
UNIX operating system or network. The manuals in this kit provide
information on how to configure, manage, and tune Tru64 UNIX systems.

This kit contains the following documentation:

AdvFS Administration
Guide to Prestoserve
Kernel Debugging
Logical Storage Manager
Managing Online Addition and Removal
Network Administration: Connections
Network Administration: Services
Sharing Software on a Local Area Network
Software License Management
System Administration
System Configuration and Tuning
System Configuration Supplement: OEM Platforms
X Window System Administrator’s Guide
X Window System Environment

(printed only)

1.5.2 Developer’s Documentation Kit

The Developer’s Documentation Kit is for software developers who write
programs on or for the Tru64 UNIX operating system. The books in this kit
include information on tools and programming recommendations.

This kit contains the following documentation:

Assembly Language Programmer’s Guide
Asynchronous Transfer Mode
Calling Standard for Alpha Systems
Compaq C Language Reference Manual
Guide to the POSIX Threads Library
Guide to Preparing Product Kits
Guide to Realtime Programming
Network Programmer’s Guide
OSF/Motif Programmer’s Guide (printed only)
OSF/Motif Style Guide (printed only)
Programmer’s Guide
Programmer’s Guide: STREAMS (printed only)

Finding the Documentation You Need 1–11

Programming Support Tools
Programming with ONC RPC
Writing Kernel Modules
Writing Software for the International Market

1.5.3 Additional Documentation in the Media Kit

The following documentation is packaged in the Tru64 UNIX media kit, but
is not included in any of the orderable Tru64 UNIX documentation kits:

How to Access Tru64 UNIX Documentation
Cluster Technical Overview

1.6 Documentation for Layered Products

Compaq and third-party vendors produce many applications that run on
Tru64 UNIX systems. The documentation for most of these products is
included with the individual application software. The following sections
provide some guidance.

1.6.1 TruCluster Server Software

TruCluster Server is a separately licensed product that ships on the
Associated Products CD–ROM Volume 2. It is a highly integrated synthesis
of Tru64 UNIX software, Compaq AlphaServer™ systems, and storage
devices that operate as a single system.

The TruCluster Server documentation is included on the Tru64 UNIX
documentation CD–ROM, as well as with the software on the Associated
Products CD–ROM Volume 2 and in printed form in a separately orderable
documentation kit (see Section A.1.2 for more information).

1.6.2 Other Products Packaged with Tru64 UNIX

The CD–ROMs in the Tru64 UNIX media kit include the software and
documentation for several separately licensed products. You do not need a
license to view this documentation, which in most cases is provided in both
HTML and PDF (or PostScript) formats.

In addition to the previously mentioned TruCluster Server software, the
following separately licensed products are among those included with the kit:

• Advanced File System (AdvFS) Utilities

• Advanced Server for UNIX

See the Tru64 UNIX Version 5.1A CD–ROMs sheet packaged with the Tru64
UNIX media for a complete list and the location of the layered products

1–12 Finding the Documentation You Need

included with Tru64 UNIX. See Section 5.3 for information about the Tru64
UNIX Associated Products CD–ROMs.

1.6.3 Tru64 UNIX Alpha Online Documentation Library

Many of the layered products produced by Compaq, such as Compaq’s
C++ product and the Distributed Computing Environment (DCE), are
included on the Tru64 UNIX Alpha Software Product Library, a collection of
CD–ROMs in a kit that is updated every three months. The documentation
for these products is included on the companion Tru64 UNIX Alpha Online
Documentation Library CD–ROM. These software and documentation kits
are separately orderable products; they are not included with the Tru64
UNIX media kit. For information about ordering these kits, contact your
Compaq sales representative.

1.6.4 Device Driver Documentation

Documentation for programmers who create device driver software for the
Tru64 UNIX operating system is available as a separately orderable kit. See
Chapter 7 for more information about the Device Driver Documentation Kit.

Finding the Documentation You Need 1–13

General User Documentation

This chapter describes the general user documentation, which provides
information for all users of the Tru64 UNIX operating system. The books in
this category provide introductory information for people who are unfamiliar
with Tru64 UNIX, as well as advanced information for the experienced user.
Each document is individually described.

Printed books can be purchased from Compaq in the documentation kits
described in Section 1.5.

Except for a few externally published manuals, the documentation described
here was produced by Compaq writers working closely with the developers of
the Tru64 UNIX operating system.

Books identified as revised, were updated with the Version 5.1A release.

2.1 Printed and Online Documentation

The documentation described in this section is provided on the Tru64 UNIX
Documentation CD–ROM and in the optional printed documentation kits.
For more information on the printed documentation set, see Section 1.5.

2

2.1.1 CDE Companion

The CDE Companion provides an introduction to Compaq’s implementation
of the Common Desktop Environment (CDE), an easy method of interacting
with the Tru64 UNIX operating system.

For users migrating from DECwindows Motif to CDE, this book serves as an
introduction to the new environment, providing information on how to use
CDE to complete tasks previously done by using DECwindows.

For users who are new to desktop environments, this book provides
quick-start information on topics such as logging into the system, navigating
the system, and using and managing the desktop and applications.

This book can be used in conjunction with the Common Desktop
Environment: User’s Guide.

General User Documentation 2–1

2.1.2 Cluster Release Notes (revised)

The Cluster Release Notes provide a brief introduction to the TruCluster
Server and describe known problems and workarounds.

2.1.3 Cluster Technical Overview (revised)

The Cluster Technical Overview describes the major components of the
TruCluster Server product. The opening chapter introduces the features of
a TruCluster Server cluster. Subsequent chapters provide a more in-depth
description of certain features, including:

• Clusterwide file systems, storage, and device names

• The connection manager

• Highly available applications

• The cluster application availability (CAA) component

• The cluster alias subsystem

• The cluster interconnect

• The distributed lock manager (DLM)

• Installation and system management

______________________ Note _______________________

A printed version of this book is packaged with the Tru64
UNIX operating system media but is not included in any of the
Tru64 UNIX documentation kits. It is, however, included in the
TruCluster Server documentation kit.

2.1.4 Command and Shell User’s Guide (revised)

The Command and Shell User’s Guide introduces the basic features of the
Tru64 UNIX operating system. It describes how to use the command line
interface and to perform such tasks as copying files and creating directories.
It also describes how to use the shells and their built-in commands.

Although this manual is primarily for users who have little or no familiarity
with UNIX-compatible systems, experienced users can find useful shortcuts
and tips.

2.1.5 Documentation Overview for Version 5.1A (revised)

The document you are currently reading.

2–2 General User Documentation