================================================================================
PowerUX NightProbe*
Version 2.2
Release Notes
Harris Computer Systems Corporation
1. Introduction
NightProbeTM is a real-time program monitoring tool that is part of
the NightStarTM development environment. It provides a graphical user
interface that permits real-time recording, viewing, and modification
of program data within one or more executing programs. It can be used
during development and operation of applications, including
simulations, data acquisition, and system control.
The features and capabilities of NightProbe include:
o An X Window SystemTM and OSF/MotifTM graphical user interface
provides data sampling control and a spreadsheet interface for
data recording, monitoring, and modification.
o Several timing sources, including the system clock and the
frequency-based scheduler, are provided for controlling the
sampling rate. The user may explicitly start, suspend, and stop
sampling using the graphical user interface.
o Any static memory location of any Ada, C, or Fortran process on
any processor may be sampled by NightProbe. The symbol table
browsing facilities support all scalar data types in those
programming languages.
o Sampled data can be monitored interactively or written to a file
or shared memory area in real time. It can also be passed to the
NightTraceTM daemon for later analysis.
__________
* These release notes cover the following products: nprobe
- 1 -
PowerUX NightProbe 2.2 Release Notes
o NightProbe can be run on a different processor from the target
program, which minimizes NightProbe's impact on the target
program's performance.
o NightProbe allows data locations to be specified using logical
addresses or the symbolic names that appear in the program source
code. The data addresses and data types are then located by
searching the symbol table in the executable program file.
NightProbe can present lists of the static variables in programs,
and the user may select the variables of interest using the
graphical user interface.
o Configuration files can be created, edited, and saved to retain
target selections and display layout, allowing for fast start-up.
o No modifications to source code or recompilations are required
for use with NightProbe.
NOTE: NightProbe is supported on Series 4000 and Series 5000 systems
running CX/UX and on Series 6000 and Power HawkTM systems running
PowerUX. This version of the release notes is for PowerUX.
2. Documentation
The following table lists the documentation available with this
release:
___________________________________________
| Manual Name Pub. Number |
|___________________________|______________|
| NightProbe Quick Reference| 0890465-020 |
| NightProbe Release Notes | 0890465-2.2P|
|___________________________|______________|
Copies of the Harris documentation can be ordered by contacting the
Harris Software Support Center. The toll-free number for calls within
the continental United States is 1-800-245-6453. For calls outside
the continental United States, the number is 1-954-971-6248.
- 2 -
Release Notes 2.2 PowerUX NightProbe
3. Prerequisites
Prerequisites for PowerUX NightProbe Version 2.2 are as follows:
3.1 Software Prerequisites
o The PowerUX operating system, Release 2.2 or later.
o The X Window System, Version 11, Release 4.0 or later.
o The Elan License ManagerTM.
3.2 Hardware Prerequisites
o Any Series 6000 or Power Hawk system.
o An X Window System display device (e.g., X terminal).
4. Installation
The NightProbe product is installed as the nprobe software package
using the Software Packaging Tools. Please refer to the chapter
"Installing Add-On Software" in the PowerUX System Administration
Manual, Volume 1 (Pub. No. 0890429), the PowerUX Release Notes (Pub.
No. 0890454-2.2), and the pkgadd(1M) man page for instructions on
software installation.
4.1 File List
The installation tape for the NightProbe product includes these files:
/usr/bin/nprobe
the application program
/usr/lib/NightProbe/np-fbs
the frequency-based scheduler timing program
/usr/lib/X11/app-defaults/Nprobe
basic application default resources file
/usr/lib/X11/app-defaults/Nprobe-color
application default resources file for color displays
- 3 -
PowerUX NightProbe 2.2 Release Notes
/usr/lib/X11/app-defaults/Nprobe-mono
application default resources file for monochrome displays
/usr/lib/locale/C/LC_MESSAGES/NightProbe-help
English language help message texts
/usr/lib/locale/C/LC_MESSAGES/NightProbe-text
English language message texts
/usr/share/man/cat1/nprobe.1
pre-formatted manual page
/usr/share/man/man1/nprobe.1
nroff source for manual page
The nprobe executable of the NightProbe product must be run with the
Elan License Manager. Follow the steps in the "Obtaining Licenses"
section of the Elan License Manager Release Notes (0891055); the
feature alias for NightProbe is "NightProbe". If you are not already
running the Elan License Manager, if you do not have a copy of the
Elan License Manager Release Notes, or if you need a license key,
contact Harris Software Distribution at 1-800-666-5405.
5. Cautions
Target programs must be compiled and linked with debugging information
(the -g compiler and linker option) in order to obtain the full
functionality of NightProbe, specifically identification of memory
locations by name and browsing the symbol table.
Only static variables can be sampled (i.e., variables that are not on
the stack or in registers).
Currently NightProbe does not handle indirection, literal enumeration
values, Fortran character types, or Fortran datapools. It does handle
enumeration position numbers.
Additional information about NightProbe can be obtained from the
nprobe(1) system manual page and the NightProbe Quick Reference.
- 4 -
Release Notes 2.2 PowerUX NightProbe
6. Release Description
Release 2.2 of NightProbe supports Release 2.2 of the PowerUX
operating system. There are no functional changes introduced in this
NightProbe release.
6.1 Operation on a Secure System
Certain privileges are required to run license-managed applications on
a Secure/Power UX system using the LPM (Least Privileged Mode)
security model. Applications initially have an appropriate set of
privileges to allow their use in this environment. However, the
system administrator of a secure system may wish to adjust these
privileges to meet special needs of the site's security policy. This
section provides background information to assist in that task.
Information about privileges and administration of secure systems can
be found in System Administration Volumes 1 and 2 (Pub. Numbers
0890429 and 0890430) and in intro(2). The following table shows the
initial assignment of privileges to commands.
_____________________________________________
Privilege |Reason | |
____________________|__________________|_____ |
____________________|__________________|_____ |
P_DEV |Allows connection |o |
(fixed) |the license manage| |
|server | |
____________________|__________________|_____ |
P_DACREAD |Allows privileged |sers |
P_MACREAD |access to locate a|d |
(all inherited) |read the process t|ble |
|entries and addres| |
|space of program f|les |
|that might not | |
|otherwise be acces|ible |
____________________|__________________|_____ |
P_DACREAD |Allows privileged |sers |
P_DACWRITE |to modify the addr|ss |
P_MACREAD |space of program f|les |
P_MACWRITE |that might not | |
(all inherited) |otherwise be acces|ible |
____________________|__________________|_____ |
P_CPUBIAS |Allows scheduling |f |
P_RTIME |the FBS timing sou|ce, |
(all inherited) |required if and on|y if |
|using the FBS | |
|__________________|_________________________|
- 5 -
PowerUX NightProbe 2.2 Release Notes
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
|__________________|_________________________|
- 6 -
Release Notes 2.2 PowerUX NightProbe
|__________________|_________________________|
7. Direct Software Support
Software support is available from a central source. If you need
assistance or information about your system, please contact the Harris
Software Support Center at our toll free number (1-800-245-6453). Our
customers outside the continental United States can contact us
directly at 1-305-971-6248. The Software Support Center operates
Monday through Friday from 8 a.m. to 7 p.m., Eastern Standard time.
Calling the Software Support Center gives you immediate access to a
broad range of skilled personnel and guarantees you a prompt response
from the person most qualified to assist you. If you have a question
requiring on-site assistance or consultation, the Software Support
Center staff will arrange for a field analyst to return your call and
schedule a visit.
Harris provides a Software Action Request (SAR) form which our
customers can fill out and submit to their local field analyst or the
Software Support Center. This procedure ensures that your request is
entered into our SAR database for follow-up and action.
To obtain copies of SAR forms, call the Software Support Center and
request form number CSD1833B.
- 7 -
Contents
1. Introduction................................................... 1
2. Documentation.................................................. 2
3. Prerequisites.................................................. 3
3.1 Software Prerequisites.................................... 3
3.2 Hardware Prerequisites.................................... 3
4. Installation................................................... 3
4.1 File List................................................. 3
5. Cautions....................................................... 4
6. Release Description............................................ 5
6.1 Operation on a Secure System.............................. 5
7. Direct Software Support........................................ 7
- i -
_________________________________________________________________
HARRIS
COMPUTER SYSTEMS
_________________________________________________________________
PowerUX NightProbe
Version 2.2
Release Notes
0890465-2.2P
January 1996
_________________________________________________________________
Trademark Acknowledgments
Elan License Manager
is a trademark of Elan Computer Group, Inc.
NightProbe is a trademark of Harris Computer Systems
Corporation.
NightStar is a trademark of Harris Computer Systems
Corporation.
NightTrace is a trademark of Harris Computer Systems
Corporation.
OSF/Motif is a trademark of the Open Software Foundation, Inc.
Power Hawk is a trademark of Harris Computer Systems
Corporation.
PowerUX is a trademark of Harris Computer Systems
Corporation.
X Window System is a trademark of X Consortium, Inc.
return to index
================================================================================
================================================================================
PowerUX NightProbe*
Version 2.2.1
Release Notes
Harris Computer Systems Corporation
1. Introduction
NightProbeTM is a real-time program monitoring tool that is part of
the NightStarTM development environment. It provides a graphical user
interface that permits real-time recording, viewing, and modification
of program data within one or more executing programs. It can be used
during development and operation of applications, including
simulations, data acquisition, and system control.
The features and capabilities of NightProbe include:
o An X Window SystemTM and OSF/MotifTM graphical user interface
provides data sampling control and a spreadsheet interface for
data recording, monitoring, and modification.
o Several timing sources, including the system clock and the
frequency-based scheduler, are provided for controlling the
sampling rate. The user may explicitly start, suspend, and stop
sampling using the graphical user interface.
o Any static memory location of any Ada, C, or Fortran process on
any processor may be sampled by NightProbe. The symbol table
browsing facilities support all scalar data types in those
programming languages.
o Sampled data can be monitored interactively or written to a file
or shared memory area in real time. It can also be passed to the
NightTraceTM daemon for later analysis.
__________
* These release notes cover the following products: nprobe
- 1 -
PowerUX NightProbe 2.2.1 Release Notes
o NightProbe can be run on a different processor from the target
program, which minimizes NightProbe's impact on the target
program's performance.
o NightProbe allows data locations to be specified using logical
addresses or the symbolic names that appear in the program source
code. The data addresses and data types are then located by
searching the symbol table in the executable program file.
NightProbe can present lists of the static variables in programs,
and the user may select the variables of interest using the
graphical user interface.
o Configuration files can be created, edited, and saved to retain
target selections and display layout, allowing for fast start-up.
o No modifications to source code or recompilations are required
for use with NightProbe.
NOTE: NightProbe is supported on Series 4000 and Series 5000 systems
running CX/UX and on Series 6000, Power HawkTM, and Power MAXIONTM
systems running PowerUX. This version of the release notes is for
PowerUX.
2. Documentation
The following table lists the documentation available with this
release:
_____________________________________________
| Manual Name Pub. Number |
|___________________________|________________|
| NightProbe Quick Reference| 0890465-020 |
| NightProbe Release Notes | 0890465-2.2.1P|
|___________________________|________________|
Copies of the Concurrent documentation can be ordered by contacting
the Concurrent Software Support Center. The toll-free number for
calls within the continental United States is 1-800-245-6453. For
calls outside the continental United States, the number is 1-954-971-
6248.
- 2 -
Release Notes 2.2.1 PowerUX NightProbe
3. Prerequisites
Prerequisites for PowerUX NightProbe Version 2.2.1 are as follows:
3.1 Software Prerequisites
o The PowerUX operating system, Release 2.2 or later.
o The X Window System, Version 11, Release 4.0 or later.
o The Elan License ManagerTM.
3.2 Hardware Prerequisites
o Any Series 6000, Power Hawk, or Power MAXION system.
o An X Window System display device (e.g., X terminal).
4. Installation
The NightProbe product is installed as the nprobe software package
using the Software Packaging Tools. Please refer to the chapter
"Installing Add-On Software" in the PowerUX System Administration
Manual, Volume 1 (Pub. No. 0890429), the PowerUX Release Notes (Pub.
No. 0890454-2.2), and the pkgadd(1M) man page for instructions on
software installation.
4.1 File List
The installation tape for the NightProbe product includes these files:
/usr/bin/nprobe
the application program
/usr/lib/NightProbe/np-fbs
the frequency-based scheduler timing program
/usr/lib/X11/app-defaults/Nprobe
basic application default resources file
/usr/lib/X11/app-defaults/Nprobe-color
application default resources file for color displays
- 3 -
PowerUX NightProbe 2.2.1 Release Notes
/usr/lib/X11/app-defaults/Nprobe-mono
application default resources file for monochrome displays
/usr/lib/locale/C/LC_MESSAGES/NightProbe-help
English language help message texts
/usr/lib/locale/C/LC_MESSAGES/NightProbe-text
English language message texts
/usr/share/man/cat1/nprobe.1
pre-formatted manual page
/usr/share/man/man1/nprobe.1
nroff source for manual page
The nprobe executable of the NightProbe product must be run with the
Elan License Manager. Follow the steps in the "Obtaining Licenses"
section of the Elan License Manager Release Notes (0891055); the
feature alias for NightProbe is "NightProbe". If you are not already
running the Elan License Manager, if you do not have a copy of the
Elan License Manager Release Notes, or if you need a license key,
contact Concurrent Software Distribution at 1-800-666-5405.
5. Cautions
Target programs must be compiled and linked with debugging information
(the -g compiler and linker option) in order to obtain the full
functionality of NightProbe, specifically identification of memory
locations by name and browsing the symbol table.
Only static variables can be sampled (i.e., variables that are not on
the stack or in registers).
Currently NightProbe does not handle indirection, literal enumeration
values, Fortran character types, or Fortran datapools. It does handle
enumeration position numbers.
Additional information about NightProbe can be obtained from the
nprobe(1) system manual page and the NightProbe Quick Reference.
- 4 -
Release Notes 2.2.1 PowerUX NightProbe
6. Release Description
There are no new features introduced in release 2.2.1 of NightProbe.
This release fixes two bugs that were present in the 2.2 release of
NightProbe:
o Use of the Frequency-Based Scheduler as a timing source now works
properly.
o Package installation now works properly if the current working
directory at the time of installation is not the root directory.
6.1 Operation on a Secure System
Certain privileges are required to run license-managed applications on
a Secure/Power UX system using the LPM (Least Privileged Mode)
security model. Applications initially have an appropriate set of
privileges to allow their use in this environment. However, the
system administrator of a secure system may wish to adjust these
privileges to meet special needs of the site's security policy. This
section provides background information to assist in that task.
Information about privileges and administration of secure systems can
be found in System Administration Volumes 1 and 2 (Pub. Numbers
0890429 and 0890430) and in intro(2). The following table shows the
initial assignment of privileges to commands.
_____________________________________________
| Privilege | Reason |
|__________________|_________________________|
|__________________|_________________________|
| P_DEV | Allows connection to |
| (fixed) | the license manager |
| | server |
|__________________|_________________________|
| P_DACREAD | Allows privileged users|
| P_MACREAD | access to locate and |
| (all inherited)| read the process table |
| | entries and address |
| | space of program files |
| | that might not |
| | otherwise be accessible|
|__________________|_________________________|
| P_DACREAD | Allows privileged users|
| P_DACWRITE | to modify the address |
| P_MACREAD | space of program files |
| P_MACWRITE | that might not |
|__________________|_________________________|
- 5 -
PowerUX NightProbe 2.2.1 Release Notes
| (al| inherited) otherwise b| accessible
|__________________|_________________________|
| P_CPUBIAS | Allows scheduling of |
| P_RTIME | the FBS timing source, |
| (all inherited)| required if and only if|
| | using the FBS |
|__________________|_________________________|
7. Direct Software Support
Software support is available from a central source. If you need
assistance or information about your system, please contact the Harris
Software Support Center at our toll free number (1-800-245-6453). Our
customers outside the continental United States can contact us
directly at 1-305-971-6248. The Software Support Center operates
Monday through Friday from 8 a.m. to 7 p.m., Eastern Standard time.
Calling the Software Support Center gives you immediate access to a
broad range of skilled personnel and guarantees you a prompt response
from the person most qualified to assist you. If you have a question
requiring on-site assistance or consultation, the Software Support
Center staff will arrange for a field analyst to return your call and
schedule a visit.
Harris provides a Software Action Request (SAR) form which our
customers can fill out and submit to their local field analyst or the
Software Support Center. This procedure ensures that your request is
entered into our SAR database for follow-up and action.
To obtain copies of SAR forms, call the Software Support Center and
request form number CSD1833B.
- 6 -
Contents
1. Introduction................................................... 1
2. Documentation.................................................. 2
3. Prerequisites.................................................. 3
3.1 Software Prerequisites.................................... 3
3.2 Hardware Prerequisites.................................... 3
4. Installation................................................... 3
4.1 File List................................................. 3
5. Cautions....................................................... 4
6. Release Description............................................ 5
6.1 Operation on a Secure System.............................. 5
7. Direct Software Support........................................ 6
- i -
_________________________________________________________________
HARRIS
COMPUTER SYSTEMS
_________________________________________________________________
PowerUX NightProbe
Version 2.2.1
Release Notes
0890465-2.2.1P
October 1996
_________________________________________________________________
Trademark Acknowledgments
Elan License Manager
is a trademark of Elan Computer Group, Inc.
NightProbe is a trademark of Concurrent Computer Corporation.
NightStar is a trademark of Concurrent Computer Corporation.
NightTrace is a trademark of Concurrent Computer Corporation.
OSF/Motif is a trademark of the Open Software Foundation, Inc.
Power Hawk is a registered trademark of Concurrent Computer
Corporation.
Power MAXION is a registered trademark of Concurrent Computer
Corporation.
PowerUX is a registered trademark of Concurrent Computer
Corporation.
X Window System is a trademark of X Consortium, Inc.
return to index
================================================================================
================================================================================
NightProbe*
Version 2.2.2
Release Notes
Harris Computer Systems Corporation
1. Introduction
NightProbe is a real-time program monitoring tool that is part of the
NightStar(TM) development environment. It provides a graphical user
interface that permits real-time recording, viewing, and modification
of program data within one or more executing programs. It can be used
during development and operation of applications, including
simulations, data acquisition, and system control.
The features and capabilities of NightProbe include:
o An X Window System(TM) and OSF/Motif(TM) graphical user interface
that provides data sampling control and a spreadsheet interface
for data recording, monitoring, and modification.
o Several timing sources, including the system clock and the
frequency-based scheduler, are provided for controlling the
sampling rate. The user may explicitly start, suspend, and stop
sampling using the graphical user interface.
o Any static memory location of any Ada, C, or Fortran process on
any processor may be sampled by NightProbe. The symbol table
browsing facilities support all scalar data types in those
programming languages.
o Sampled data can be monitored interactively or written to a file
or shared memory area in real time. It can also be passed to the
NightTrace(TM) daemon for later analysis.
__________
* These release notes cover the following products: NightProbe
- 1 -
NightProbe 2.2.2 Release Notes
o NightProbe can be run on a different processor from the target
program, which minimizes NightProbe's impact on the target
program's performance.
o NightProbe allows data locations to be specified using logical
addresses or the symbolic names that appear in the program source
code. The data addresses and data types are then located by
searching the symbol table in the executable program file.
NightProbe can present lists of the static variables in programs,
and you may select the variables that interest you by using the
graphical user interface.
o You can create, edit, and save configuration files to retain
target selections and display layout, allowing for fast start-up.
o No modifications to source code or recompilations are required
for use with NightProbe.
2. Documentation
The following table lists the documentation available with release
2.2.2 of NightProbe.
___________________________
| Manual Name Pub. Number|
|____________|_____________|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
|____________|_____________|
- 2 -
return to index
================================================================================
================================================================================
NightProbe*
Version 2.2.3
Release Notes
Harris Computer Systems Corporation
1. Introduction
NightProbe(TM) is a real-time program monitoring tool that is part of
the NightStar(TM) development environment. It provides a graphical
user interface that permits real-time recording, viewing, and
modification of program data within one or more executing programs.
It can be used during development and operation of applications,
including simulations, data acquisition, and system control.
The features and capabilities of NightProbe include:
o An X Window System(TM) and OSF/Motif(TM) graphical user interface
provides data sampling control and a spreadsheet interface for
data recording, monitoring, and modification.
o Several timing sources, including the system clock and the
frequency-based scheduler, are provided for controlling the
sampling rate. The user may explicitly start, suspend, and stop
sampling using the graphical user interface.
o Any static memory location of any Ada, C, or Fortran process on
any processor may be sampled by NightProbe. The symbol table
browsing facilities support all scalar data types in those
programming languages.
o Sampled data can be monitored interactively or written to a file
or shared memory area in real time. It can also be passed to the
NightTrace(TM) daemon for later analysis.
__________
* These release notes cover the following products: NightProbe
- 1 -
NightProbe 2.2.3 Release Notes
o NightProbe can be run on a different processor from the target
program, which minimizes NightProbe's impact on the target
program's performance.
o NightProbe allows data locations to be specified using logical
addresses or the symbolic names that appear in the program source
code. The data addresses and data types are then located by
searching the symbol table in the executable program file.
NightProbe can present lists of the static variables in programs,
and the user may select the variables of interest using the
graphical user interface.
o Configuration files can be created, edited, and saved to retain
target selections and display layout, allowing for fast start-up.
o No modifications to source code or recompilations are required
for use with NightProbe.
2. Documentation
The following table lists the documentation available with this
release:
___________________________
| Manual Name Pub. Number|
|____________|_____________|
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
|____________|_____________|
- 2 -
return to index
================================================================================