Release lu3.6 Patch 4

Release Date: February 2005

Before installing this patch you must already have nmake release lu3.6 installed. If you already have a valid license for lu3.6 you do not need a new license to use this patch. For any license requests please contact the Bell Labs Licensing Team.

Download Software

lu3.6 Patch 4 Notes

Table of Contents

• Introduction
• Contents
• Description
• Installation Instructions
• Rollback Instructions

Introduction

This is a cumulative patch and includes patch levels 04, 03, 02 and 01. If patch 01, 02 and/or 03 is already installed, the same files from patch 04 will not be re-installed, only the new or modified patch 04 files will be installed. If patch 01, 02 or 03 is not installed then all files from patch 03 will be installed.

This patch is to be applied to an existing nmake lu3.6 based installation (lu3.6, lu3.6-p01, lu3.6-p02 or lu3.6-p03). All current lu3.6 nmake users are entitled to download and install this patch -- a new license is not needed to use the patch. If you do not have version lu3.6 installed then you should not install this patch.

This patch will replace several files in your lu3.6 node (details are below). Any file to be replaced will first be backed up so it may be recovered if necessary.

Contents

This patch contains the following components (found under the update/ subdirectory):

• bin/nmake (patch 04, 03, 02)
• doc/jman.html (patch 01)
• lib/make/JAVA.mk (patch 01)
• lib/make/Makerules.mk (patch 01)
• lib/make/makerules.mo (patch 01)
• README.java (patch 03)
• README.nmake (patch 04)

Plus the following patch support files:

• README
• install.sh

Description

The following fixes are provided in this patch:

040084 - stuck in prefixinclude loop

• Under certain conditions nmake would enter an infinite loop while scanning include files. The problem was caused by the engine re-processing some rules, which also contributed to other problems such as attempting to install a file in the wrong vpath node. Restrictions have been put on the rule re-processing to eliminate the problems.

For changes introduced in patch 03 see the lu3.6-p03 release notes.

For changes introduced in patch 02 see the lu3.6-p02 release notes.

For changes introduced in patch 01 see the lu3.6-p01 release notes.

Installation Instructions

An install script is used to apply the patch. All actions performed by the install script are logged to file install.log. If the install script is executed more than once each instance will be recorded in the log file. The install script also provides a rollback feature to uninstall the patch and return the lu3.6 node to its previous state.

We recommend installing this patch while no one is running the nmake command. Use the following steps to install the patch.

1. Change directory to the lu3.6 root directory. You should see directories bin, fun, lib, man, and share here.

   $ cd <nmake_root>

2. Unbundle the patch package. Existing lu3.6 files will NOT be over written. A new directory named "patch04" will be created which contains the patch files.
   • For tar.Z files:

     $ zcat downloaded_file | tar xvf -

   • For Linux® tar.gz files:

     $ tar xzvf downloaded_file

   • For UWIN tar.gz files:

     $ gunzip -c downloaded_file | tar xvf -

3. Change directory to the new "patch04" directory.

   $ cd patch04

4. Execute the install.sh script. If the script finds any problems, such as you are trying to patch a non-lu3.6 release, it will exit with an error message. Otherwise you will be given a summary of what the script will do and will be asked if you would like to proceed with the installation or not.

   $ ./install.sh

   If you are happy with the summary then press 'y' and 'enter' (or 'return') to start the update. Any other key will abort the update before any changes are made.

   * Do you want to start the install? (y/n) y

   As the install script executes it will show you what files are being backed up and installed. A file named install.log will be created or appended to containing the actions taken by the installation script.

Rollback Instructions

To back-out the patch and restore the original files run the install.sh script again. If the patch has already been installed the script will ask if you would like to restore the original files or reinstall the patch. The restore option is only available after the patch has been successfully installed.

1. Change directory to the patch root directory. You should see files install.sh and README and the directory update.

   $ cd <nmake_lu3.6_root>/patch04

2. Execute the install.sh script. If that patch has already been installed you will be asked if you want to restore or reinstall the software. To back-out the patch chose the restore option, number 1.

   $ ./install.sh
   
   * You have the following options:
      1) Restore - backout the patch and restore original files.
      2) Install - attempt to install the patch again.
   Select 1 or 2 --> 1

   You will then be given a summary of the files to be restored. If you are happy with the summary then press 'y' and 'enter' (or 'return') to start the restore. Any other key will abort the restore before any changes are made.

   * Do you want to start the restore? (y/n) y

   As the script executes you will be shown what files are being restored. The install.log file will be appended with the actions taken by the restore.