3    Supplementary Documentation

To help meet specific needs when working with the Tru64 UNIX operating system, Compaq makes available documentation that supplements the core Tru64 UNIX documentation set. This chapter describes this supplementary documentation.

3.1    Overview

Supplementary documentation is provided only on line and comes from various sources. Some of this material, including all of the Best Practice documentation, is produced by Compaq writers working closely with Tru64 UNIX developers. Other documentation is produced by UNIX professionals both within Compaq and outside of the corporation. Supplementary documentation tends to be less formal in structure than the core documentation.

The Documentation CD-ROM, Operating System CD-ROM, Associated Products CD-ROMs Volumes 1 and 2 and the Compaq World Wide Web environment all contain supplementary documentation.

For example, the Associated Products CD-ROMs contain installation guides for the Multimedia Services for Tru64 UNIX run-time environment, DECevent, and the Porting Assistant. Other component-specific information includes release notes, Software Product Descriptions (SPDs), and user information.

This Documentation Overview does not list all of the supplementary documentation on the CD-ROMs, but it does provide some guidance in the following sections.

3.2    Web-Based Best Practices Documentation

Best Practices documentation offers a recommended method for performing a task, rather than presenting all of the options available. This type of documentation walks you step-by-step through the process.

The recommend procedure might depend on your configuration environment. For example, the Best Practice for performing a particular task on a Web server might differ from the one for peforming the same task on a file server. The Best Practice documentation cannot meet the needs of all users, but it is aimed at the most common tasks and system configurations in order to meet the demands of most users.

The Best Practices documentation currently resides only on the Web at the following site:

http://www.unix.digital.com/faqs/publications/best_practices/

The volume of Best Practice documentation continues to grow, due in part to requests from customers. The Best Practices Web page provides information for sending your suggestions to Compaq. You might find new Best Practice documentation at this site each time you visit it.

3.3    Documentation CD-ROM

The supplementary documentation described in the following sections is included on the Documentation CD-ROM.

Much of this documentation is provided in both HTML and PDF formats; some is provided only in one of the two formats. If your system is configured as suggested, you can click on the HTML link to view the document in your Web browser or click on the PDF link to view the document using Adobe Acrobat Reader.

3.3.1    Advanced Printing Software User Guide

This manual provides information about using the Advanced Printing Software, which is included as an optional component of the Tru64 UNIX operating system. The User Guide describes how to submit jobs to your printer using the command-line interface. It also shows you how to set up your local print environment and monitor jobs you have submitted.

This manual is also packaged with the software kit, as is the following companion documentation:

3.3.2    CD-ROM Contents Listing

This is an online version of the document called Tru64 UNIX Version 5.0A CD-ROMs, which is included in the Tru64 UNIX media kit. It provides brief listings of the software components on the CD-ROMs in the media kit.

3.3.3    Common Desktop Environment and TookTalk Documentation

Prior to the Version 5.0 release, the Common Desktop Environment documentation was provided in printed format. It is now available only on line.

3.3.3.1    Documentation for Users and System Administrators

The following books were previously included in the General User Documentation Kit:

3.3.3.2    Documentation for Windows Developers

The following books were previously included in the Windows Programming Documentation Kit:

3.3.3.3    ToolTalk Service Documentation

ToolTalk is an interapplication communication service that is included as part of the Common Desktop Environment. ToolTalk provides a way for applications and desktop components to request services of each other and to announce events. The following books provide information about the ToolTalk service:

3.3.4    BIND Configuration File Guide

The BIND Configuration File Guide describes the Berkeley Internet Name Domain (BIND) Version 8 and its implementation as an Internet name server for BSD-derived operating systems.

Version 8 is more configurable than previous releases of BIND; there are entirely new areas of configuration, such as access control lists and categorized logging. Also, you can now selectively use many options that previously applied to all zones. These features, plus a consideration of future configuration needs, led to the creation of a new configuration file format.

3.3.5    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.

3.3.6    How to Order Tru64 UNIX Documentation

The file titled How to Order Tru64 UNIX Documentation duplicates the information in Chapter 6. It provides a convenient way to move to the information and the Web links you need to order Tru64 UNIX documentation.

3.3.7    Java Documentation

The Tru64 UNIX operating system includes a Java Development Kit (JDK), which provides tools to develop and run Java applets and programs on the Tru64 UNIX operating system.

Access to the Java documentation depends upon whether the Java Development Kit is installed on your system and how your system administrator has set up your system. Clicking on Java Overview takes you to a page that provides information about viewing the Java documentation. This page also provides a Web link to the JavaSoft JDK documentation at the Sun Microsystems Java site.

3.3.8    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.

3.3.9    New and Changed Features from Prior Releases

The New and Changed Features from Prior Releases document lists the major features that were introduced and changes that were made to the Tru64 UNIX operating system since Version 4.0. The information in this document was originally presented in the New and Changed Features chapter of the operating system Release Notes of each of those versions.

3.3.10    Object File / Symbol Table Specification

The Object File / Symbol Table Specification fills a need for technical information for compiler and debugger writers and other developers who must access or manipulate object files on the Tru64 UNIX operating system. It supplements or replaces information that has been previously available in the Assembly Language Programmer's Guide. A familiarity with basic program development and symbol table concepts is assumed.

3.3.11    Performance Manager

Performance Manager is a real-time performance management tool that allows system administrators to detect and correct performance problems in Tru64 UNIX systems. The three primary components of the Performance Manager are a graphical user interface, the Performance Manager daemon, and an activity daemon. An additional daemon monitors systems running the TruCluster software.

This manual explains the concepts of the Performance Manager software, and describes tasks such as monitoring, thresholding, archiving, and distributed command execution.

3.3.12    Safety & Comfort Guide

The Safety & Comfort Guide describes how to set up your workstation environment to minimize the possibility of injury and provide you with the maximum of comfort. This guide focuses on posture and on other health and work habits for computer users. Additionally, it provides product safety information applicable to all Compaq products.

3.3.13    sendmail Installation and Operation Guide

The sendmail Installation and Operation Guide describes the configuration file for Version 8.9 of the sendmail utility, which implements a general-purpose internetwork mail routing facility under the Tru64 UNIX operating system.

The sendmail utility is not tied to any one transport protocol -- its function can be likened to a crossbar switch, relaying messages from one domain into another. In the process, it can do a limited amount of message header editing to put the message into a format that is appropriate for the receiving domain. All of this is done under the control of a configuration file.

3.3.14    Technical References for Asian Languages

The following guides provide language-specific information and describe the features of several Asian languages supported on the Tru64 UNIX system:

3.3.15    X Window System Documentation

The documentation described in this section pertains to X Windows System, Version 11, Release 6. These documents are provided by the X Consortium.

3.4    Operating System CD-ROM

The documentation described in the following sections is included on the Tru64 UNIX Operating System CD-ROM. Some of this documentation is available only when you install the software it describes.

3.4.1    Software Product Descriptions

A Software Product Description (SPD) is the legal description of the Tru64 UNIX product. It describes the software and gives information about its capabilities and about the hardware it supports. With this release, the SPD for the operating system provides a listing of system limits.

PostScript versions of the SPDs are located on the CD-ROM in the mount_point/DOCUMENTATION/POSTSCRIPT directory. The files are named as follows: 

Tru64_UNIX_Operating_System_SPD.ps
Tru64_UNIX_Developers_Extensions_SPD.ps
Tru64_UNIX_Server_Extensions_SPD.ps
Tru64_UNIX_Logical_Storage_Manager_SPD.ps

PDF versions of the SPDs are located on the CD-ROM in the mount_point/DOCUMENTATION/ACRO directory. You view PDF files using the Adobe Acrobat Reader. The files are named as follows: 

Tru64_UNIX_Operating_System_SPD.pdf
Tru64_UNIX_Developers_Extensions_SPD.pdf
Tru64_UNIX_Server_Extensions_SPD.pdf
Tru64_UNIX_Logical_Storage_Manager_SPD.pdf

3.4.2    Listings of Patches to the Operating System

Listings of fixes (usually called patches) that Compaq has made to each version of the Tru64 UNIX operating system are provided in text files on the CD-ROM in the mount_point/DOCUMENTATION/TEXT directory. The files are named as follows: 

Digital_UNIX_V3_2C_CLD_Fixes.txt
Digital_UNIX_V3_2D_CLD_Fixes.txt
Digital_UNIX_V3_2G_CLD_Fixes.txt
Digital_UNIX_V4_0_CLD_Fixes.txt
Digital_UNIX_V4_0A_CLD_Fixes.txt
Digital_UNIX_V4_0B_CLD_Fixes.txt
DIGITAL_UNIX_V4_0D_CLD_Fixes.txt
DIGITAL_UNIX_V4_0E_CLD_Fixes.txt
Tru64_UNIX_V4_0F_CLD_Fixes.txt
Tru64_UNIX_V5_0_CLD_Fixes.txt
 
 

To obtain Tru64 UNIX patch kits from Compaq, visit the following Web site:

http://www.service.digital.com/patches/

3.4.3    X Image Extension Documentation

The X Image Extension (XIE) code provides a powerful mechanism for the transfer and display of virtually any image on X-capable hardware. Documentation for XIE is provided in the /usr/share/doclib/xie directory on an installed Tru64 UNIX system.

Before you can view or print an XIE document, you must uncompress it using the gzip -d command. For more information, see the gzip(1) reference page.

The following list describes the XIE documentation. The names of the individual files are listed after the titles.

3.5    Associated Products CD-ROMs

The Associated Products CD-ROMs contain documentation for various components of Tru64 UNIX. The document called Tru64 UNIX Version 5.0A CD-ROMs (a printed sheet packaged with the Tru64 UNIX media kit and included on the Documentation CD-ROM) provides a list of the applications located on these CD-ROMs, as do the 00README.TXT files located on the CD-ROMs.

Both CD-ROMs provide a graphical user interface that you can use to access documentation and to install product software. To use this interface, invoke Netscape and go to the following location: 

file://<mount_point>/index.html
 

A list of products on the CD-ROM will be displayed. When you click on a product name you will be given the option to install the product or access the documentation, if applicable.

Beginning with this release, the Associated Products CD-ROMs comply with the ISO 9660 Level 1 CD-ROM standard, which means you can view the contents of these CD-ROMs on a Windows PC or Macintosh or on any other system that uses that ISO standard.