AUX RELEASE DOCUMENT
SOFTWARE RELEASE 8.1
Part No. 005295
Revision 00
This document describes changes made
to AUX in Release 8.1. It includes
an overview of the enhancements made
at this release, a description of
how to install AUX SR8.1, a list of
the bugs that that have been
corrected, and a list of new
features and enhancements.
The release notes for standard DOMAIN
software are located online in the
system /doc directory. The release
notes for optional DOMAIN software
will be placed in the /doc directory
during the software installation
process. Hard-copy Release Notes
are also supplied with some software
products.
APOLLO COMPUTER INC.
330 Billerica Road
Chelmsford, Massachusetts 01824
c 1984 Apollo Computer Inc.
All rights reserved.
Printed in U.S.A.
Printed: October, 1984
This document was formatted using the FMT text
formatting tool distributed with the DOMAIN
Computer system.
Apollo Computer Inc. reserves the right to make changes in specifications and
other information contained in this publication without prior notice, and the
reader should, in all cases, consult Apollo Computer Inc. to determine
whether any such changes have been made.
THE TERMS AND CONDITIONS GOVERNING THE SALE OF APOLLO COMPUTER INC. HARDWARE
PRODUCTS AND THE LICENSING OF APOLLO COMPUTER INC. SOFTWARE CONSIST SOLELY OF
THOSE SET FORTH IN THE WRITTEN CONTRACTS BETWEEN APOLLO COMPUTER INC. AND ITS
CUSTOMERS. NO REPRESENTATION OR OTHER AFFIRMATION OF FACT CONTAINED IN THIS
PUBLICATION, INCLUDING BUT NOT LIMITED TO STATEMENTS REGARDING CAPACITY,
RESPONSE-TIME PERFORMANCE, SUITABILITY FOR USE OR PERFORMANCE OF PRODUCTS
DESCRIBED HEREIN SHALL BE DEEMED TO BE A WARRANTY BY APOLLO COMPUTER INC. FOR
ANY PURPOSE, OR GIVE RISE TO ANY LIABILITY BY APOLLO COMPUTER INC.
WHATSOEVER.
IN NO EVENT SHALL APOLLO COMPUTER INC. BE LIABLE FOR ANY INCIDENTAL,
INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT
LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATING TO THIS PUBLICATION OR
THE INFORMATION CONTAINED IN IT, EVEN IF APOLLO COMPUTER INC. HAS BEEN
ADVISED, KNEW OR SHOULD HAVE KNOWN OF THE POSSIBILITY OF SUCH DAMAGES.
THE SOFTWARE PROGRAMS DESCRIBED IN THIS DOCUMENT ARE CONFIDENTIAL INFORMATION
AND PROPRIETARY PRODUCTS OF APOLLO COMPUTER INC. OR ITS LICENSORS.
APOLLO and DOMAIN are registered trademarks of Apollo Computer Inc.
Reader_Notice
This document resides on-line in a file named /doc/aux.release_notes.sr8.1.
To view this file on your node's screen, type the following DM command.
Command: cv /doc/aux.releasenotes.sr8.1 <RETURN>
To print a copy of this document on the Spinwriter letter-quality printer,
type the following AEGIS Shell command.
$ prf /doc/aux.releasenotes.sr8.1 -npag -pr Spinwritername <RETURN>
To print a copy on a Printronix line printer, first convert the file using
the OS (overstrike) command
$ os /doc/aux.releasenotes.sr8.1 >filename <RETURN>
then print the overstruck file, as shown below.
$ prf filename -npag -pr lineprintername <RETURN>
iii
CONTENTS
Section Page
CHAPTER 1 OVERVIEW OF AUX FOR RELEASE 8.1 ............................. 1-1
CHAPTER 2 INSTALLING AUX .............................................. 2-1
CHAPTER 3 ENHANCEMENTS ................................................ 3-1
3.1 FIXED BUGS ................................................ 3-1
3.2 ENHANCEMENTS ............................................... 3-2
CHAPTER 4 KNOWN ERRORS, LIMITATIONS, AND RESTRICTIONS ................. 4-1
Contents iv
CHAPTER 1
OVERVIEW OF AUX FOR RELEASE 8.1
AUX 8.1 is an update release that offers improved functionality in the ex and
vi editors. It also fixes bugs associated with
csh (1)
mv (1)
rm (1)
rmdir (1)
sh (1)
signal (2)
and corrects a problem involving output of an AUX command piped to the input
of an AEGIS command.
AUX 1-1 Software Release 8.1
CHAPTER 2
INSTALLING AUX VERSION 8.1 SOFTWARE
This chapter describes how to install AUX Version 8.1 software on a DOMAIN
node or system server. This installation, or update, procedure will only
work if the node or server on which you are installing the software is
running the SR8 version of AEGIS and includes the following SR8 AUX
directories.
/bin
/usr
/etc
If the node you plan to update does not meet these conditions, follow the
standard SR8 update procedures that are described in Chapter 2 of the
Standard Software Release Document.
We use the following terms when describing the update procedure.
o "Work node" is the node you are using to enter the commands to do
the software installation. The work node must be running SR8
software.
o "Target node" or target volume is the disked node whose software you
are installing or updating. The target node must be running SR8
software.
o "Source node" or source volume is a disked node that has already
been updated with the new software, which you are copying onto the
target node.
Execute the following procedure to install the AUX software from the
distribution (floppy) disk.
1. Use the WORKING_DIRECTORY (WD) command to set your work node's
working directory to the entry directory of the target node.
$ WD //targetnode <RETURN>
2. Use the READ_BACK (RBAK) command to get the install file from the
floppy.
AUX 2-1 Installing Software
$ RBAK -DEV F0 -F 1 INSTALL -AS INSTALL -MS -L <RETURN>
3. Use the WORKING_DIRECTORY (WD) command to set your work node's
working directory to the /INSTALL directory on the target node.
$ WD //targetnode/INSTALL <RETURN>
4. Execute the INSTALL_AUX.SR8.1 Shell script to install the software.
Be sure to include the name of the target node's entry directory.
$ INSTALLAUX.SR8.1 //targetnode <RETURN>
5. After the installation is complete, the following message will
appear.
AUX SR8.1 INSTALLATION COMPLETE
** PLEASE SHUTDOWN, RESET, AND RESTART THE TARGET NODE **
Before shutting down the target node, examine the transcript pad for
error messages. If any errors occurred during the installation,
repeat the installation procedure. If no errors occurred, shut
down, reset, and restart the target node.
To install the software via the network from another node that has already
been updated, execute the following procedure.
1. Use the WORKING_DIRECTORY (WD) command to set your work node's
working directory to the /INSTALL directory of the source node.
$ WD //sourcenode/INSTALL <RETURN>
2. Execute the INSTALL_AUX.SR8.1 Shell script to install the software.
Be sure to include the name of the target node's entry directory.
$ INSTALLAUX.SR8.1 //targetnode <RETURN>
3. After the installation is complete, the following message will
appear.
AUX SR8.1 INSTALLATION COMPLETE
** PLEASE SHUTDOWN, RESET, AND RESTART THE TARGET NODE **
Before shutting down the target node, examine the transcript pad for
error messages. If any errors occurred during the installation,
repeat the installation procedure. If no errors occurred, shut
down, reset, and restart the target node.
Installing Software 2-2 AUX
CHAPTER 3
FEATURES AND ENHANCEMENTS
3.1 FIXED BUGS
SIGNAL (2)
SIGCLD is now being sent. If there is a handler for SIGCLD, it gets all
child death faults. If there is a handler for SIGCHLD, it gets all child
state change faults. If there are handlers for both, the SIGCLD handler
gets child death faults, while the SIGCHLD handler gets all other child
state change faults.
RM (1)
The rm command can now find and remove "object not found" files. The
commands mv and rmdir have also been given the same ability.
CSH (1)
The C-Shell now handles digits in variable names (and the expansion of
variables) properly.
SH (1)
The Bourne Shell now handles attempts to execute newgrp (a command that is
not part of AUX) by printing an error message rather than crashing the
shell.
PIPES INVOLVING BOTH AUX AND AEGIS COMMANDS
A problem involving mismatches between buffer size and record length has
been corrected. It is now possible to pipe the output of an AUX command to
the input of an AEGIS command without fear of system-induced errors.
AUX 3-1 Software Release 8.0
3.2 ENHANCEMENTS
EX (1)
The crash recovery facilities of ex and vi are now available due to the
addition of the programs /usr/lib/ex3.6recover and /usr/lib/ex3.6preserve,
and the addition of the directory /usr/preserve.
These additions allow the -r option of ex and vi to work. If you want
automatic recovery of your ex or vi files after a node crash, add the
following line to your node startup file:
cpo /usr/lib/ex3.6preserve -a
Software Release 8.0 3-2 AUX
CHAPTER 4
KNOWN ERRORS, LIMITATIONS, AND RESTRICTIONS
This chapter describes all currently known errors, limitations, and
restrictions that apply to the SR8.1 version of AUX.
4.1 KNOWN ERRORS
There are no known errors, limitations, or restrictions unique to this
version of AUX.
AUX 4-1 Software Release 8.0