hps_dump Command

Purpose

Dumps contents of Network Terminal Accelerator (NTX) adapter memory to a host file. This command only applies to AIX® 4.2.1 or later.

Syntax

hps_dump [ -f Name ] [ -d Device ]

Description

The hps_dump command uses the loader interface to upload all of the memory from the adapter board into a file. This produces a snapshot of a system for later analysis and debugging. The first 1024 bytes of the file contains the following:

Item Description
80 Identification string, includes version.
80 Time and date of dump from host system.
80 Comments.
268 Log table from the host adapter.
32 System address table.
8 Starting and ending address range of dump.
476 Padding to 1024 bytes total.

Flags

Item Description
-f Name Specifies the name of the dump. Use this option to override the default filename ./hpscore.
-d Device Specifies the raw device file name of the adapter. Use this option to override the default device name /dev/rhp0.

Exit Status

This command returns the following exit values:

Item Description
0 Successful completion.
>0 An error occurred.

Security

Access Control: You must have root authority to run this command.

Auditing Events: N/A

Examples

  1. To get a dump of memory of the default adapter to the file hpscore in the current directory, enter:
    hps_dump
  2. To get a dump of memory of the default adapter to the file hpsdebug in the current directory of the default adapter, enter:
    hps_dump -f hpsdebug
  3. To get a dump of memory of the adapter /dev/rhp1 to the file hpsdebug in the current directory of the default adapter, enter:
    hps_dump -f hpsdebug -d /dev/rhp1

Files

Item Description
/usr/bin/hps_dump Contains the hps_dump command.
/dev/rhp0 Default NTX raw device file name.