2    The Tru64 UNIX Manuals

This chapter provides brief descriptions of the core documentation. For convenience, it is divided into sections that follow the structure of the printed documentation kits. See Section 1.4 for information about the online Documentation Library structure.

2.1    End User Documentation

Manuals for the end user contain the information you need to install and configure a Tru64 UNIX system, bring it up on a network, and use it. The documentation in this category is grouped in three primary areas: startup documentation, general user documentation, and system and network management documentation.

2.1.1    Startup Documentation

The startup documentation is packaged in printed form with your Tru64 UNIX media. It consists of the documents you need to install, configure, and begin using your system.

Documentation Overview

This is the book you are reading.

Installation Guide

This manual describes the procedures for performing an update installation, a basic installation, or an advanced installation of the Tru64 UNIX product on all supported processors. It also discusses system management procedures in a standalone environment.

Quick Reference Card (Available only in printed form)

This foldout card provides fingertip access to the format of common user commands, such as cd, chmod, lpr, and man. The card also describes options that are commonly used with each command.

Additionally, this card provides command summaries for the vi, emacs, Mail, and mail applications, and it summarizes the rules for forming regular expressions. It provides a description of command control symbols (such as |, the pipe symbol) and gives definitions of shell environment variables and metacharacters.

Release Notes for Version 4.0F

The Release Notes for Version 4.0F are for all users of the Tru64 UNIX operating system. This book includes the following information:

Compaq recommends that you read the Release Notes before installing or using the Tru64 UNIX operating system.

Note

Compaq maintains an online Technical Update that contains information about restrictions and problems that have been discovered since Version 4.0F began shipping. To view this document on the Web, go to the following URL:

http://www.unix.digital.com/faqs/publications/updates/V40F/TITLE.HTM Compaq recommends that you visit this site periodically to see if any new information has been added.

Technical Overview

This manual provides a technical overview of the Tru64 UNIX operating system, focusing on the networking subsystem, the file system, virtual memory, and the development environment. In addition, the manual lists all system limits.

Update Installation Quick Reference Card (Available only in printed form)

This foldout card provides easy access to the information needed to upgrade a Tru64 UNIX system to the next version. Update installations preserve disk partitions, file systems, and file customizations.

The information on this card is covered in detail in Chapter 2 of the Installation Guide.

2.1.2    General User Documentation

General user documentation contains important 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.

CDE Companion

This manual 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.

Command and Shell User's Guide

This manual 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.

Common Desktop Environment: Advanced User's and System Administrator's Guide

This manual describes how to customize the appearance and behavior of CDE. It provides information on topics such as the following:

This book is intended for users who want to perform customizations that cannot be accomplished using the desktop user interface. This book is also intended for system administrators; many of the tasks in this book require superuser permission.

Common Desktop Environment: User's Guide

This manual 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 figures of the graphical interface as it is displayed on workstation screens.

DECwindows User's Guide

This manual describes how to log on to a Tru64 UNIX workstation and begin working with the DECwindows Motif interface. It also explains how to customize the DECwindows environment, how to use advanced features of Mail, and how to use AccessX software.

Master Index

This book can help you find the information you need in the core documentation set, as follows:

Security

This manual provides information needed by users and system administrators who are working on Tru64 UNIX systems that have the optional enhanced security subsets installed. It also provides information needed by developers who are writing programs that will run on secure systems. The enhanced security features help protect systems or data from access by unauthorized users.

This manual also provides information about security on systems that do not have the enhanced security subsets installed.

The information is organized as follows:

2.1.3    System and Network Management Documentation

System and network management documentation provides information on topics such as configuring systems and networks, maintaining disks, and using system administration tools.

DECevent Translation and Reporting Utility

DECevent provides an interface between a system user and the operating system's event logger. DECevent can help system administrators to troubleshoot Tru64 UNIX system problems.

This manual describes the DECevent command features related to the translation and reporting of events on Tru64 UNIX operating systems. It contains an overview of the utility, information on how to obtain help for the utility, and information about all the commands necessary to translate event logs on Tru64 UNIX operating systems.

Guide to Prestoserve

Prestoserve speeds up synchronous disk writes, including Network File System (NFS) server access, by reducing the amount of disk I/O.

This manual describes how to manage and maintain a Tru64 UNIX system that includes the optional Prestoserve hardware and software.

Kernel Debugging

The manual describes using the dbx, kdbx, and kdebug debuggers to find problems in kernel code. It also describes how to write a kdbx utility extension and how to create and analyze a crash dump file.

This manual is for system administrators responsible for modifying, rebuilding, and debugging the kernel configuration. It is also for system programmers who need to debug their kernel-space programs.

Logical Storage Manager

The Logical Storage Manager (LSM) provides help to more effectively manage disk resources, gain high data availability, and increase I/O performance. It provides the ability to divide disks into subdisks, concatenate disks, stripe data across disks, and mirror data for duplication of data.

This manual provides system administrators with a thorough knowledge of LSM concepts and procedures involved with disk and volume management. It also describes in detail the three LSM interfaces used to perform LSM disk management operations: the graphical user interface (dxlsm), the character-cell menu interface (voldiskadm), and the command line interface.

Network Administration

This manual provides information on establishing a Tru64 UNIX system on a network and configuring network software such as NFS and BIND. It also explains how to manage a network and network applications and how to solve problems that might arise.

This manual is for experienced system and network administrators who have knowledge of TCP/IP networking concepts and network configuration. Readers should also have knowledge of operating system concepts, commands, and configuration.

Performance Manager

Performance Manager is an SNMP-based, user-extensible, real-time performance monitoring and management tool that provides system managers with the ability to detect and correct performance problems from a central location.

Performance Manager is an optional subset of Tru64 UNIX but requires a license for use in a distributed fashion. Without the license, this product acts only on the node running the graphical user interface. With the distributed license, it can act on any number of nodes in your network.

The Performance Manager manual explains the concepts of the product, and describes how to monitor the state of one or more managed nodes in real-time. It also describes tasks such as thresholding, archiving, and distributed command execution.

Note

The online versions of this manual were revised with the Version 4.0F release of Tru64 UNIX. These online versions (in HTML and PDF formats) are available on the Documentation CD-ROM and on the Internet.

This book has been removed from the System and Network Management Documentation Kit and is no longer available in its printed format.

Sharing Software on a Local Area Network

This manual describes Remote Installation Services (RIS) and Dataless Management Services (DMS). The RIS utility is used for installing software across a network, instead of using locally mounted media. DMS allows a server system to maintain the root, /usr, and /var file systems for client systems. Each client system has its own root file system on the server, but clients share the /usr and /var file systems.

Software License Management

This manual describes how to use the License Management Facility (LMF) to manage software licenses from Compaq.

Although intended primarily for system administrators responsible for managing software licenses on Tru64 UNIX systems, this manual also provides information for anyone who uses licensed software on Tru64 UNIX systems.

System Administration

This manual describes how to configure, use, and maintain the Tru64 UNIX operating system. It includes information on general day-to-day activities and tasks, changing system configurations, and locating and eliminating sources of trouble.

This manual is for system administrators responsible for managing the operating system. It assumes a knowledge of operating system concepts, commands, and configurations.

System Configuration and Tuning

This manual describes how to set up and tune high-performance and high-availability systems running the Tru64 UNIX operating system. It can help system administrators to accomplish many system tasks, including the following:

This manual replaced the System Tuning and Performance Management manual in the DIGITAL UNIX Version 4.0D release.

ULTRIX to DIGITAL UNIX Migration Guide

This manual describes how to upgrade a system from an ULTRIX and ULTRIX Worksystem Software system to Tru64 UNIX, focusing on the following migration paths:

This manual provides answers to migration issues for ULTRIX users, system and network administrators, and programmers.

X Window System Administrator's Guide (Available only in printed form)

This manual, published by O'Reilly & Associates, describes how to customize a wide range of X Window System environments, from an individual workstation to groups of workstations and X terminals connected on a network. Major topics include security, the X display manager (xdm), fonts, color, X terminals, and X client applications.

X Window System Environment

This manual describes various aspects of the X Window System environment as it is implemented on Tru64 UNIX. It provides information on how to perform system administration tasks for the Tru64 UNIX X Window System environment, and describes how to customize X Window System resources and key mappings. It also provides information about programming within the Tru64 UNIX X Window System environment.

2.2    Documentation for Program Developers

The programming documentation consists of manuals designed for software developers who write software applications on or for the Tru64 UNIX operating system. The documentation in this category is grouped in two primary areas: general programming and windows programming.

2.2.1    General Programming Documentation

The manuals in the general programming category describe the Tru64 UNIX programming environment.

Assembly Language Programmer's Guide

This manual describes the Alpha hardware architecture's assembly language, which is supported by the Tru64 UNIX compiler system. The manual describes the assembly language syntax rules, and how to write assembly language programs.

This manual is for system software developers who are writing assembly language programs on or for Tru64 UNIX.

Asynchronous Transfer Mode

This manual describes the Tru64 UNIX Asynchronous Transfer Mode (ATM) subsystem, how to configure the subsystem, and how to use the ATM kernel interfaces. It is written for experienced UNIX kernel programmers who are responsible for writing ATM device drivers and kernel modules. After reading this manual, a kernel programmer should be able to do the following:

This manual does not describe the application programming interface (API) that user-level applications would use to access the ATM subsystem. This manual is not an ATM networking tutorial.

Calling Standard for Alpha Systems

This manual defines the requirements, mechanisms, and conventions used in the interface that supports procedure calls on Tru64 UNIX for Alpha systems. The standard defines data structures, constants, algorithms, conventions, methods, and functional interfaces, which enable a native, user-mode procedure to operate correctly in the multilanguage and multithreaded Tru64 UNIX environment on Alpha hardware.

Although this manual primarily defines requirements for compiler and debugger writers, the information applies to procedure calling for all programmers at all levels of programming.

DEC C Language Reference Manual

This manual provides reference information for using the DEC C language on Compaq systems. DEC C is an ISO/ANSI-compliant C compiler for Tru64 UNIX and OpenVMS VAX and Alpha systems.

This manual is based on the ISO C Standard (ISO 9899:1990[1992]), formerly the ANSI X3J11 committee's standard for the C programming language (commonly called ANSI C). All library functions and language extensions to the ANSI C standard are also described.

This manual is intended for programmers who need reference information on the DEC C language. For task-oriented information or platform-specific information see the cc(1) reference page and the Programmer's Guide.

Digital Portable Mathematics Library

This manual provides reference and exception information for the Digital Portable Mathematics Library (DPML) software. This manual documents the DPML routines and, in particular, how they behave when given an exception input argument. It also documents operating system entry points and supported floating-point data types.

This manual is for compiler writers and system and application programmers who do not have high-level language support of DPML routines in their language of choice, but instead need to access DPML routines directly from application programs.

Guide to DECthreads

This manual provides usage and reference information on DECthreads routines. It provides information on the three DECthreads interfaces used to perform multithreaded operations: cma, pthread, and pthread exception-returning.

This manual is for programmers writing multithreaded applications. It assumes experience with a high-level programming language (such as C), with UNIX operating systems, and with UNIX software development tools.

Guide to Preparing Product Kits

This manual describes the procedures for creating, maintaining, and installing the collections of files and directories that make up a layered products kit. A kit is the standard mechanism by which layered product modifications are delivered and maintained on a Tru64 UNIX system. Kits are distributed on CD-ROM, diskettes, or tape for installation on customer's systems.

This is the same manual that is included in the Tru64 UNIX Device Drivers Kit (DDK).

Guide to Realtime Programming

This manual is for programmers who are developing realtime applications on Tru64 UNIX systems. It provides information on writing new realtime applications and porting existing realtime applications from other systems.

This manual does not present function syntax or reference information; the online reference pages provide that information.

This manual is for application programmers or system engineers who are already familiar with the C programming language. It assumes experience with UNIX operating systems and with UNIX software development tools.

Ladebug Debugger Manual

The Ladebug Debugger is a tool for debugging executable programs at the source-code and machine-code levels. It can debug programs written in C and C++, Ada, COBOL, and Fortran.

This manual is for developers who need to debug multiprocess and multithreaded applications, perform kernel debugging, and perform remote client/server debugging. It is organized in two parts:

Network Programmer's Guide

This manual describes the Tru64 UNIX network programming environment. It describes in depth the X/Open Transport 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 the Tru64 UNIX operating system supports. This bridge allows programs that use sockets-based protocol stacks to access STREAMS drivers, and programs that use STREAMS-based protocol stacks to access BSD-based drivers.

This manual is for experienced UNIX programmers.

Programmer's Guide

This manual describes the programming environment of the Tru64 UNIX operating system, with an emphasis on the C programming language.

This manual is for all programmers who use the Tru64 UNIX operating system to create or maintain programs in any supported language.

Programmer's Guide: STREAMS (Available only in printed form)

This manual (developed by AT&T and published by Prentice Hall) provides information on the use of the STREAMS mechanism at the user and kernel levels. It contains introductory information for those who are unfamiliar with the STREAMS mechanism.

This manual addresses topics such as using STREAMS to monitor, control, and poll STREAMS; designing and implementing STREAMS modules and drivers; and using STREAMS-based pipes and FIFOs. It also describes the STREAMS multiplexing facility and the STREAMS-based terminal and pseudo-terminal subsystems.

Programming Support Tools

This manual describes commands and utilities for text manipulation, macro and program generation, and source file management on Tru64 UNIX.

Although the commands and utilities described in this manual are primarily for programmers, some of them (such as grep, awk, sed, and the Source Code Control System (SCCS)) are useful for general users.

This manual assumes that the reader is a moderately experienced user of UNIX systems.

Programming with ONC RPC

This manual provides an overview of high-level programming with remote procedure calls (RPC) in the Open-Network Computing Environment (ONC). It describes how to use the rpcgen protocol compiler to create RPC applications and describes the RPC programming interface.

This manual is for programmers who want to write network applications without knowledge of the underlying network.

Writing Software for the International Market

This manual provides an overview of writing international programs and provides details about using the tools included on the Tru64 UNIX operating system.

An international program interacts with users in their own language and reflects the culture of the users' region. Internationalization is the process of designing or adapting programs to meet international requirements, such as those of multiple local languages and the specific character sets associated with them.

This manual is for programmers developing international applications for Tru64 UNIX.

2.2.2    Windows Programming Documentation

Windows programming documentation contains information specifically for programmers developing Common Desktop Environment (CDE) applications or X window applications on or for Tru64 UNIX. This kit contains the following manuals:

Common Desktop Environment: Application Builder User's Guide

This manual introduces the Application Builder and explains how to use it to build CDE applications. Because the Application Builder helps to easily create and modify user interfaces, it is a powerful tool for programmers, user interface designers, and project managers.

Common Desktop Environment: Desktop KornShell User's Guide

This manual 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 Motif applications using KornShell scripts rather than the C programming language. This manual assumes knowledge of KornShell programming, Motif, and the Xt Intrinsics. Familiarity with the X programming library (Xlib) is also assumed.

Common Desktop Environment: Help System Author's and Programmer's Guide

This manual describes how to develop online help for CDE applications. It describes how to create help topics and how to integrate online help into a CDE application.

This manual is for application programmers who want to do the following:

Common Desktop Environment: Internationalization Programmer's Guide

This manual provides information for internationalizing the desktop and enabling applications to support various languages and cultural conventions in a consistent user interface.

This manual is for CDE application programmers whose products are available worldwide.

Common Desktop Environment: Programmer's Guide

This manual contains the information needed to integrate an existing application into the CDE desktop. It also describes how to write new CDE applications.

This manual assumes a familiarity with Motif, X, UNIX, and C programming.

Common Desktop Environment: Programmer's Overview

This manual provides a high-level view of the development environment and the developer documentation set for CDE. It is for the following audiences:

Common Desktop Environment: Style Guide and Certification Checklist

This manual provides style guidelines for CDE application design and lists the requirements for CDE application-level certification. CDE requirements consist of the OSF/Motif Version 1.2 requirements with CDE-specific additions.

Common Desktop Environment: ToolTalk Messaging Overview

This manual describes how the ToolTalk service works and how it uses information that applications supply to deliver messages. It also describes how applications use the ToolTalk service and ToolTalk components.

This manual assumes familiarity with the ToolTalk service, UNIX operating system commands, system administrator commands, and system terminology.

Common Desktop Environment: Product Glossary

This glossary provides a comprehensive list of terms used in the Common Desktop Environment.

This manual is for all CDE users.

OSF/Motif Programmer's Guide (Available in printed form only)

This manual (developed by the OSF and published by Prentice Hall) provides programming information on how to use the various components of the OSF/Motif environment: the Toolkit, window manager, and user interface language.

This manual is for programmers who want to create applications in the OSF/Motif environment.

OSF/Motif Style Guide (Available in printed form only)

This manual (developed by the OSF and published by Prentice Hall) provides a framework of behavior specifications to guide application developers, widget developers, and window manager developers in the design and implementation of products consistent with the Presentation Manager and the OSF/Motif user interface.

This manual establishes consistent behavior among new products by drawing out common elements from a variety of current behavioral models. It anticipates the evolution of graphical user interfaces as new technology becomes available and as the use of the OSF/Motif user interface spreads.

This manual is for programmers and interface designers developing OSF/Motif applications who want to present a uniform and usable software interface consistent with other OSF/Motif applications.