Compaq AA-RH8RD-TE manual

T ru64 UNIX Documentation Over view f or V ersion 5.1A Part Number: AA-RH8RD-TE June 2001 Product V ersion: T r u64 UNIX V ersion 5.1A This manual describes the documentation for the Compaq T ru64 UNIX operating system. It also describes the structure of the documentation kits and provides information about ordering them. Compaq Computer Corporatio[...]

© 2001 Compaq Computer Corporation COMP AQ, the Compaq logo, AlphaServer , T ruCluster, and V AX Registered in U.S. Patent and T rademark Office. T ru64, OpenVMS, and Alpha are trademarks of Compaq Information T echnologies Group, L.P in the United States and other countries. Microsoft, Windows, and W indows NT are trademarks of Microsoft Corporat[...]

Contents About This Manual 1 Finding the Documentation Y ou Need 1.1 Introduction to the Documentation Set . . . . . . . . . . . . ....... ........ 1–1 1.1.1 Core Documentation . .......... .......... ......... .......... ..... 1–2 1.1.2 Supplementary Documentation . . . . ....... ...... ....... ...... .. 1–2 1.1.3 Layered Products . . . . . [...]

2.1.7 Programming Support T ools .... .......... .......... ......... .. 2–3 2.1.8 Release Notes for V ersion 5.1A (revised) . . . . . . . .... ...... ..... 2–4 2.1.9 Security (revised) . . . . . ....... ......... .......... .......... ........ 2–4 2.1.10 T echnical Overview for V ersion 5.1A (revised) ....... ...... .. 2–5 2.2 Printed-Only[...]

3.2 Printed-Only Documentation . . . . . . . . . . . ....... .......... ......... .. 3–11 3.2.1 Full Installation Quick Start (revised) . . . . . . . . . .... ...... ... .. 3–12 3.2.2 Update Installation Quick Reference Card (revised) . . . . . . . . 3–12 3.2.3 X W indow System Administrator ’s Guide ..... ....... ...... .. 3–12 3.3 Onlin[...]

4.3.6 Common Desktop Environment: Programmer ’s Guide ..... 4–9 4.3.7 Common Desktop Environment: Programmer ’s Overview . 4–9 4.3.8 Common Desktop Environment: Style Guide and Certification Checklist ...... ...... ....... ...... ....... ... ...... .. 4–9 4.3.9 Java Documentation . .... ...... ...... .... ...... ....... ...... ..... 4–9[...]

Index Figures 1–1 Structure of the T ru64 UNIX Documentation Kit ....... ...... .. 1–9 2–1 Example Master Index Search . . . . . . . . . . ....... ...... ....... ...... .. 2–3 T ables A–1 Alphabetical Listing of Core, Supplementary , and T ruCluster Server Documentation . . . .... ...... ... ....... ...... ....... ...... ... .. A–4 Cont[...]

[...]

About This Manual This manual describes the documentation that comes with the Compaq T ru64™ UNIX operating system. It also provides information about the structure of the documentation kits and the tools used to access the documentation. A udience This manual is for anyone who needs to access documentation about the T ru64 UNIX operating system.[...]

Chapter 6 Describes the T ru64 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 [...]

1 Finding the Documentation Y ou Need Y ou can find most of the T ru64 UNIX documentation you need on the Documentation CD–ROM that comes with the T ru64 UNIX product and also on the W orld W ide W eb. Most of this documentation is provided on line in HTML and PDF formats and is also available as printed books. Y our W eb browser gives you access[...]

This information is for those who develop software on and/or for the T ru64 UNIX operating system. Be aware, however , that some of this documentation is written to serve different audiences. For example, the Security manual is divided into three parts to provide guidance for individual users, system administrators, and programmers who must develop[...]

1.1.3 Layered Pr oducts Layered products documentation consists of books and other documents that aid in the use of separately licensed products, such as T ruCluster™ and Compaq C++. For more information, see Section 1.6. 1.2 Chang es to the V ersion 5.1A Documentation Set This section describes changes to the ways you can access documentation an[...]

• How to Access T ru64 UNIX Documentation (print-only document) • Master Index • Quick Reference Card (print-only document) • Release Notes for V ersion 5.1A • Security • T echnical Overview for V ersion 5.1A • T ru64 UNIX V ersion 5.1A CD–ROMs (print-only document) System and Network Administration • AdvFS Administration • Clus[...]

• T echnical Reference for Using Chinese Features (online-only document) • T echnical 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 s[...]

• 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 T ru64 UNIX operating system preinstalled (often called a FIS system, for factory installed software), online versions of the following books are installed on the system: – Relea[...]

W ith Acrobat Reader , you can scroll through books, print selected sections or entire books, and copy sections to the clipboard. The V ersion 5.1A release offers a new full-text search facility , called isearch , for finding information in T ru64 UNIX documentation on the W eb and on local area networks, using any platform, including UNIX workstat[...]

• 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[...]

• Internet Express for T ru64 UNIX (formerly Open Source Internet Solutions) • T ru64 UNIX Porting Guides • T ru64 UNIX POSIX Conformance Documentation • System Limits This document lists the system limits for the components of the T ru64 UNIX operating system. The W eb site also provides updates to documentation between formal product rele[...]

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 S Indicates books that are for system and network administrators P Indicates books that are for programmers Although a book’s primary audience determines the docu[...]

This kit provides general information on how to use the T ru64 UNIX operating system. The manuals in this kit are for everyone who uses T ru64 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 r[...]

Programming Support T ools Programming with ONC RPC W riting Kernel Modules W riting Software for the International Market 1.5.3 Additional Documentation in the Media Kit The following documentation is packaged in the T ru64 UNIX media kit, but is not included in any of the orderable T ru64 UNIX documentation kits: How to Access T ru64 UNIX Documen[...]

included with T ru64 UNIX. See Section 5.3 for information about the T ru64 UNIX Associated Products CD–ROMs. 1.6.3 T ru64 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 T ru64 UNIX Alpha Software Product L[...]

[...]

2 General User Documentation This chapter describes the general user documentation, which provides information for all users of the T ru64 UNIX operating system. The books in this category provide introductory information for people who are unfamiliar with T ru64 UNIX, as well as advanced information for the experienced user . Each document is indi[...]

2.1.2 Cluster Release Notes (revised) The Cluster Release Notes provide a brief introduction to the T ruCluster Server and describe known problems and workarounds. 2.1.3 Cluster T echnical Overview (re vised) The Cluster T echnical Overview describes the major components of the T ruCluster Server product. The opening chapter introduces the features[...]

2.1.6 Master Index (re vised) The Master Index can help you find the information you need in the core documentation set, as follows: • In the printed version of this book, the index items direct you to the books and pages where the topic is discussed. • In the online version of this book, clicking on an index entry in many cases will take you t[...]

2.1.8 Release Notes for V ersion 5.1A (revised) The Release Notes for V ersion 5.1A are for all users of the T ru64 UNIX operating system. This book includes the following information: • An overview of the new and changed features of the V ersion 5.1A software • Announcements about features and interfaces that are scheduled for removal in futur[...]

• Part 1 is aimed at general users. It introduces the enhanced security features and helps users to start using them. Other topics include the following: – How to connect to other systems – Using the security features of the Common Desktop Environment (CDE) – Using access control lists (ACLs) on files and directories • Part 2 describes ho[...]

• Networking protocols and applications • Supported file systems • The T ru64 UNIX kernel, symmetric multiprocessing, virtual memory , and device recognition • Major features of the T ru64 UNIX development environment • T ru64 UNIX interoperability with W indows NT and W indows 2000 • T ru64 UNIX security • Internationalization featur[...]

The card titled How to Access T ru64 UNIX Documentation provides a brief overview of the various ways available to you to find and access the information you need, including the T ru64 UNIX reference pages. It also lists the documentation included in the printed documentation kits. This book is packaged with the T ru64 UNIX operating system media, [...]

2.3.3 Common Desktop En vironment: User’s Guide The Common Desktop Environment: User ’s Guide describes the basic features of the CDE and describes how to use the desktop and the desktop applications. It expands upon some of the topics in the CDE Companion and provides illustrations of the graphical interface as it is displayed on workstation s[...]

3 System and Netw ork Management Documentation This chapter describes the T ru64 UNIX system and network management documentation, which provides information on topics such as configuring systems and networks, maintaining disks, and using system administration tools. The books in this category are generally geared toward advanced users. Each docume[...]

3.1.2 Cluster Administration (revised) The Cluster Administration manual describes how to perform tasks related to the day-to-day management of a T ruCluster Server system. This manual is intended for the person who will configure and manage the T ruCluster Server system. Instructions in this manual assume the user is an experienced UNIX administra[...]

products (DS-DWZZH UltraSCSI hubs, and HSZ70 and HSZ80 RAID array controllers) • How to prepare systems for a T ruCluster Server configuration and how to connect host bus adapters to shared storage using the DS-DWZZH UltraSCSI hubs and the newest RAID array controllers (HSZ70 and HSZ80) • How to set up and upgrade Memory Channel cluster interco[...]

• Adding members to a cluster • Reinstalling cluster members • Performing a rolling upgrade from the previous version of the base operating system and cluster software to the current version • Upgrading to T ruCluster Server software from T ruCluster Production Server software or T ruCluster A vailable Server software V ersion 1.5 or V ersi[...]

• The system management applications to use in setting up services following a Full Installation • An overview of ways to manage software • On overview of the T ru64 UNIX mandatory and optional subsets • The T ru64 UNIX device-naming conventions • An overview of the processes for installing associated products • An overview of the insta[...]

intended for system administrators who are responsible for managing the operating system. T o understand and use the information in this manual, system programmers and administrators should have in-depth knowledge of operating system concepts, commands, and utilities. 3.1.11 Logical Storage Manager (revised) The Logical Storage Manager (LSM) softwa[...]

• High-level considerations — such as environment factors and power requirements — to take into account in order to properly set up and configure system hardware • Component “indictment and deallocation,” which refers to the methodology of identifying system components that have a likelihood of serious failure (indictment) and then auto[...]

• Configuring and managing the Dynamic Host Configuration Protocol (DHCP) • Configuring point-to-point connections using the Serial Line Internet Protocol (SLIP) and the Point-to-Point Protocol (PPP) • The Local Area T ransport (LA T) protocol and how to configure and maintain a LA T environment • T roubleshooting networks and network servi[...]

• T roubleshooting networks and network services using flow charts and other problem-solving tools 3.1.15 Security (revised) The online version of the Security manual is included with the system and network administration information because it contains information of interest to those administrators. However , the printed version is included onl[...]

The LMF software can be used by companies other than Compaq. Those companies can issue Product Authorization Keys (P AKs) or have Compaq issue them on their behalf. Additionally , other companies can include license-checking functions in their software. However , the Software License Management manual addresses only software that is supplied and pr[...]

a UNIX system for high availability . This manual is not intended to train administrators or to plan the installation of a UNIX system. 3.1.19 System Configuration and T uning The System Configuration and T uning manual describes how to plan, set up, and tune high-performance and high-availability systems running the T ru64 UNIX operating system. I[...]

3.2.1 Full Installation Quick Star t (revised) The Full Installation Quick Start card describes the basic steps for performing a Full Installation of the T ru64 UNIX operating system from the installation CD–ROM. It walks you through the process of performing preinstallation tasks, installing the operating system, and setting up services. Users o[...]

Also, you can now selectively use many options that previously applied to all zones. 3.3.2 DECevent T ranslation and Repor ting Utility DECevent provides an interface between a system user and the operating system’s event logger . DECevent can help system administrators to troubleshoot T ru64 UNIX system problems. The DECevent T ranslation and Re[...]

[...]

4 Programming Documentation This chapter describes the documentation designed for software developers who write applications on or for the T ru64 UNIX operating system. The books in this category are generally geared toward advanced users. Each document is individually described. Books that are printed can be purchased from Compaq in the documentat[...]

• Configure A TM software • Understand how the different kernel interfaces operate • W rite a kernel module This manual does not describe the application programming interface (API) that user-level applications would use to access the A TM subsystem. This manual is not an A TM networking tutorial. 4.1.3 Calling Standard for Alpha Systems The [...]

This manual is intended for programmers who need reference information on the Compaq C language. For task-oriented information or platform-specific information, see the cc (1) reference page and the Programmer ’s Guide . 4.1.6 Guide to Preparing Product Kits (re vised) The Guide to Preparing Product Kits describes the procedures for creating, mai[...]

T ransport Interface (XTI) and the sockets and STREAMS programming frameworks, including information about system calls, header files, and libraries. Additionally , it provides information about porting sockets-based applications to XTI. This manual also describes the software bridge ifnet (STREAMS module and DLPI STREAMS pseudodevice driver) that [...]

4.1.11 Programming Support T ools The Programming Support T ools manual describes commands and utilities for text manipulation, macro and program generation, and source file management on T ru64 UNIX. Although the commands and utilities described in this manual are primarily for programmers, some of them (such as grep and sed ) are useful for gener[...]

The W riting Kernel Modules manual provides information for developers who want to augment the kernel with modules tailored to their particular environment. This manual is also included in the T ru64 UNIX Device Drivers Kit ( Chapter 7). 4.1.15 Writing Software for the International Market Internationalization (often called I18N) is the process of [...]

components of the OSF/Motif environment: the T oolkit, window manager , and user interface language. This manual is for programmers who want to create applications in the OSF/Motif environment. 4.2.2 OSF/Motif Style Guide The OSF/Motif Style Guide (produced by the OSF and published by Prentice Hall) provides a framework of behavior specifications t[...]

4.3.2 Common Desktop En vironment: Desktop KornShell User’s Guide The Common Desktop Environment: Desktop KornShell User ’s Guide provides the information needed to create Motif applications with KornShell ( ksh ) scripts. It also provides several example scripts of increasing complexity . This manual is for programmers who want to develop Moti[...]

4.3.6 Common Desktop En vironment: Programmer’s Guide The Common Desktop Environment: Programmer ’s Guide contains the information needed to integrate an existing application into the CDE desktop. It also describes how to write new CDE applications. Readers should be familiar with Motif, X, UNIX, and C programming. 4.3.7 Common Desktop En viron[...]

The Ladebug Debugger Manual is for developers who need to debug multiprocess and multithreaded applications, perform kernel debugging, and perform remote client/server debugging. 4.3.11 Object File and Symbol T able Format Specification The Object File and Symbol T able Format Specification provides technical information for compiler and debugger w[...]

The T oolT alk User ’s Guide is useful to developers who create or maintain applications that use the T oolT alk service to interoperate with other applications; it is also useful to system administrators who set up workstations. The reader should be familiar with operating system commands, system administrator commands, and system terminology . [...]

This manual (written by David Rosenthal) is based on the Release 6 software. • X T oolkit Intrinsics — C Language Interface Intrinsics are a programming library tailored to the special requirements of user-interface construction within a network window system — specifically the X W indow System. The Intrinsics and a widget set make up the X T[...]

5 Supplementary Documentation This chapter describes some of the supplementary documentation that is provided on the T ru64 UNIXOperating System CD–ROM, Associated Products CD–ROMs V olumes 1 and 2, and Compaq’s W eb site. The Printed and Online Documentation sections of the previous chapters describe the supplementary documentation provided [...]

The volume of Best Practice documentation continues to grow , due in part to requests from customers. The Best Practices W eb page provides information for sending your suggestions to Compaq. Y ou might find new Best Practice documentation at this site each time you visit it. 5.2 Operating System CD–ROM The documentation described in the followin[...]

5.2.3 T ext V ersion of the T ru64 UNIX Release Notes As an alternative to the PDF and HTML versions of the T ru64 UNIX Release Notes included on the Documentation CD–ROM, an ASCII text version of this document is included on the Operating System CD–ROM as follows: mount_point /DOCUMENTATION/TEXT/Tru64_UNIX_V5_1A_Release_Notes.txt 5.2.4 X Image[...]

5.3 Associated Products CD–R OMs The Associated Products CD–ROMs contain documentation for various components of T ru64 UNIX. The document called T ru64 UNIX V ersion 5.1A CD–ROMs (a printed sheet packaged with the T ru64 UNIX media kit) provides a list of the applications located on these CD–ROMs, as do the 00README.TXT files located on th[...]

6 T ru64 UNIX Reference P ages The T ru64 UNIX operating system provides an extensive set of reference pages (also called man pages or manual pages), each of which describes one topic, such as a command, function, or file. This chapter discusses the reference pages. 6.1 Reading Ref erence P a g es On Line Y ou can use the webman utility to read the[...]

information about installing and using webman , see the following file on the Documentation CD–ROM: / mount-point /DOCS/HTML/webman/Installing_webman.txt See Section 1.4.1 for information about the Documentation CD–ROM. 6.1.3 Using the xman Command The xman command starts an X Window System reference-page browsing tool. One function of the tool[...]

6.3 Over view of the Reference P age Sections The reference pages are grouped into sections, according to their function, audience, or both. The section numbers appear as numbers in parentheses next to the name of the reference page. For example: lpr (1) automount (8) createlabel (3) The following list describes each section: Reference Pages Sectio[...]

In printed form, this section is divided into two volumes. Reference Pages Section 7 Section 7 describes special files, related device driver functions, databases, and network support. This section is for programmers and system administrators. In printed form, this section is in one volume. Reference Pages Sections 8 and 1m Sections 8 and 1m descri[...]

7 Device Driver Documentation Documentation to aid programmers in writing device drivers for T ru64 UNIX is packaged in a separately orderable Device Driver Kit (DDK). This documentation was produced by Compaq writers working closely with the device driver developers. This kit (V ersion 2.0, part number QA-6ADA V-A8) contains a CD-ROM that includes[...]

Writing Kernel Modules This manual describes topics for all kernel modules such as kernel threads and writing kernel modules in a symmetric multiprocessing (SMP) environment. Read this manual before you use the W riting Device Drivers manual. This is the same manual that is included in the Developer ’s Kit of the T ru64 UNIX documentation set. Wr[...]

A Documentation Listings This appendix lists the core and supplementary components of the T ru64 UNIX documentation. A.1 Components of the T ru64 UNIX and T ruCluster Ser ver Printed Documentation Kits The following sections list the contents of the T ru64 UNIX and T ruCluster Server documentation kits. A.1.1 T ru64 UNIX Documentation Kit The docum[...]

Network Administration: Services Sharing Software on a Local Area Network Software License Management System Administration System Configuration and T uning System Configuration Supplement: OEM Platforms X W indow System Administrator ’s Guide (printed only) X W indow System Environment Developer ’s Kit (QA-6ADAF-GZ) Assembly Language Programme[...]

Ladebug Debugger Manual New and Changed Features from Prior Releases Object File and Symbol T able Format Specification Performance Manager Safety & Comfort Guide sendmail Installation and Operation Guide Common Desktop Environment documentation Common Desktop Environment: Advanced User ’s and System Administrator ’s Guide Common Desktop En[...]

T able A–1: Alphabetical Listing of Core, Supplementary , and T ruCluster Server Documentation Title On Line Printed Advanced Printing Software User Guide Ye s N o AdvFS Administration Ye s Ye s Assembly Language Programmer ’s Guide Ye s Ye s Asynchronous T ransfer Mode Ye s Ye s BIND Configuration File Guide Ye s N o Calling Standard for Alpha[...]

T able A–1: Alphabetical Listing of Core, Supplementary , and T ruCluster Server Documentation (cont.) Title On Line Printed Compaq C Language Reference Manual Ye s Ye s DECevent T ranslation and Reporting Utility Ye s N o Documentation Overview for V ersion 5.1A Ye s Ye s Full Installation Quick Start Card No Y es Guide to Preparing Product Kits[...]

T able A–1: Alphabetical Listing of Core, Supplementary , and T ruCluster Server Documentation (cont.) Title On Line Printed Programming Support T ools Ye s Ye s Programming with ONC RPC Ye s Ye s Quick Reference Card No Y es Release Notes for V ersion 5.1A Ye s Ye s Safety & Comfort Guide Ye s N o Security Ye s Ye s sendmail Installation and[...]

T able A–1: Alphabetical Listing of Core, Supplementary , and T ruCluster Server Documentation (cont.) Title On Line Printed X W indow System Protocol Ye s N o X W indow System: The Complete Reference to Xlib, X Protocol, ICCCM, XFLD Ye s N o Documentation Listings A–7[...]

[...]

Index A Advanced Printing Software books packaged with kit , 2–7 documentation for , 1–12 User Guide , 2–7 Advanced Server for UNIX ( See ASU ) AdvFS administration manual , 3–1 documentation for separately licensed utilities , 1–12 applications ( See layered products ) archives ( See previous versions of T ru64 UNIX manuals ) Asian langu[...]

configuration cloning , 3–5 installation cloning , 3–5 Cluster Administration manual , 3–2 Cluster Application A vailability subsystem ( See CAA ) Cluster Hardware Configuration manual , 3–2 Cluster Highly A vailable Applications manual , 3–3 Cluster Installation manual , 3–3 Cluster LAN Interconnect manual , 3–4 Cluster Release Notes[...]

device driver documentation books in set described , 7–1 kit for , 7–1 viewing documentation on the W eb , 1–8 Device Driver Kit ( See device driver documentation ) Documentation CD-ROM described , 1–7 general user information on , 2–1 mounting , 1–8 programming documentation on , 4–1 search facility for , 1–7 system and network man[...]

( See W riting Software for the International Market ) icon ( See spine icon ) installation of T ru64 UNIX operating system , 3–4, 3–5 of T ruCluster Server systems , 3–3 installation cloning , 3–5 Installation Guide on FIS system , 1–6 overview of , 3–4 Installation Guide – Advanced T opics on FIS system , 1–6 overview of , 3–5 I[...]

on FIS system , 1–6 overview of , 3–7 Network Administration: Services manual , 3–8 ( See also Network Administration: Connections manual ) on FIS system , 1–6 overview of , 3–8 network management ( See system and network management documentation ) Network Programmer ’s Guide , 4–3 new and changes features of operating system ( See op[...]

books in kit , 1–11 category in online Documentation Library , 1–7 defined , 1–1 overview of books , 4–1 Programming Support T ools manual , 4–5 Programming with ONC RPC manual , 4–5 Q Quick Reference Card , 2–6 QuickSpecs , 5–2 R realtime programming ( See Guide to Realtime Programming ) reference pages available as optional subset[...]

for system and network managers , 3–12 for T oolT alk service , 4–10 for X Window System , 4–11 Java documentation , 4–9 New and Changed Features from Previous Releases , 2–7 Object File and Symbol T able Format Specification document , 4–10 on associated products CD–ROMs , 5–4 on Operating System CD–ROM , 5–2 overview of , 5–[...]

U Update Installation Quick Reference Card , 3–12 ( See also Full Installation Quick Start (printed card) ) W We b search facility for , 1–7 viewing T ru64 UNIX documentation on , 1–8 W eb-Based Enterprise Service ( See WEBES ) WEBES , 3–7 webman ( See reference pages ) WLS installing after a Full Installation , 3–5 W orld Wide W eb ( See[...]