hps_dump Command

AIX Version 4.3 Commands Reference, Volume 2

hps_dump Command

Purpose

Dumps contents of Network Terminal Accelerator (NTX) adapter memory to a host file. This command only applies to AIX Version 4.2 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:

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

-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:

0	Successful completion.
>0	An error occurred.

Security

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

Auditing Events: N/A

Examples

To get a dump of memory of the default adapter to the file hpscore in the current directory, enter:
```
hps_dump
```
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
```
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

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

Related Information

The /dev/rhp file.

Network Terminal Accelerator Overview in AIX Versions 3.2 and 4 Asynchronous Communications Guide.