Release lu3.7 Patch 1

Release Date: Jan 2005

Before installing this patch you must already have nmake release lu3.7 installed. If you already have a valid license for lu3.7 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.7 Patch 1 Notes

Table of Contents

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

Introduction

This patch is to be applied to an existing nmake lu3.7 based installation. All current lu3.7 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.7 installed then you should not install this patch.

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

The JavaDeps package has also been updated to JavaDeps lu2.2.1 and is distributed as a separate package. The JavaDeps update is not required for this patch but is recommended for those using JavaDeps. For details and downloads see our JavaDeps web site.

Contents

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

• bin/nmake
• bin/logfilter (Solaris only)
• bin/taglines (Solaris only)
• lib/acpp
• lib/cpp
• lib/make/Scanrules.mk
• lib/make/Makerules.mk
• lib/make/makerules.mo
• lib/probe/C/make/probe
• README.nmake

Plus the following patch support files:

• README
• install.sh

Description

The following fixes are provided in this patch:

040075 - non-prefixed header gets .PREFIXED attribute

• This problem caused a false-positive when using the quoteinclude prefix feature. The false-positive has been corrected.

040084 - stuck in prefixinclude loop

• Fixed a problem where, under certain conditions nmake would hang in an infinite loop scanning the include files.

040085 - scan engine support for Sun SUNWCCh include rule

• Improved support for Sun's SUNWCCh header rewriting rule when using Sun's C++ compiler so proper dependencies are tracked for the .SUNWCCh suffix header files. A new probe variable, CC.SUFFIX.LINKHEADER, has been added to support this.

040087 - cpp 'recursion too deep' error with no recursion

• Over 1000 instances of a macro would trigger the 'recursion too deep' error from nmake cpp even when no recursion was present. This has been fixed by incrementing the recursion counter only when it happens on the same line. The counter limit was also raised to LINE_MAX which is usually 2048 but may vary by platform.

040089 - resolve lu3.7 gcc library dependencies

• The taglines and logfilter commands on Solaris no longer depend on the libstdc++.so and libgcc_s.so shared libraries.

040095 - bad -I list on second run

• Under certain conditions a C/C++ source file would be needlessly recompiled with a different -I list, which could lead to an unexpected compile error during incremental builds. This has been fixed.

Installation Instructions

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

SFU/Interix Platforms

The SFU/Interix patch package is distributed as a BSD-style pkg_add package. The installation is the same as the base package described in the lu3.7 installation instructions. The patch will update the current lu3.7 installation.

    $ pkg_add nmake-lu3.7-p01-sfu.3.5-bin.tgz 

    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
		     Welcome to the Lucent(R) nmake Product Builder
      
      This script will update Lucent(R) nmake at /opt/nmake.lu3.7
      to patch 01.  The files and directories will be owned by richb.

      Do you want to proceed [y/n]? y
      Unpacking files...
      Creating directories...
      Setting permissions...
      Installation complete!

      See /opt/nmake.lu3.7/README.nmake for information.

      For support, updates and documentation:
	http://www.bell-labs.com/project/nmake/
	nmake@alcatel-lucent.com

All Other Platforms

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.7 node to its previous state.

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

   $ cd <nmake_lu3.7_root>

2. Unbundle the patch package. Existing lu3.7 files will NOT be over written. A new directory named "patch01" 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 "patch01" directory.

   $ cd patch01

4. Execute the install.sh script. If the script finds any problems, such as you are trying to patch a non-lu3.7 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

SFU/Interix Platforms

Uninstall the patch on SFU/Interix platforms using the pkg_delete command. This will remove the patch and restore the previous version. Note that the patch must be uninstalled before the base release can be uninstalled.

    $ pkg_delete nmake-lu3.7-p01-sfu.3.5-bin.tgz 

    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

      This script will uninstall Lucent(R) nmake patch 01 from
      /opt/nmake.lu3.7, and restore the previous version.

      Do you want to proceed [y/n]? y

All Other Platforms

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.7_root>/patch01

2. Execute the install.sh script. If the 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.