PTrace Reference Manual

PTrace Reference Manual—526393-001
3-1
3 PTrace Commands
This section describes all PTrace commands in a general way, independent of
subsystem-specific features. Appendix A, Subsystem-Specific Information, describes
each subsystem's implementation of those features. The information in Appendix A,
Subsystem-Specific Information, is based on the syntax and other general information
presented in this section.
PTrace Command Components
Integers
The variable integer is used for parameters that are 8-bit, 16-bit, or 32-bit signed or
unsigned integer values. The syntax of integer is as follows:
Values entered without a percent sign (%) are interpreted as decimal numbers. Values
entered with % are interpreted as octal numbers; those with %B as binary numbers;
and those with %H as hexadecimal numbers.
The range of integer is 0 to 1,073,741,823 unless otherwise specified. If a 32-bit
number is required, but a smaller number is provided, the value is extended to 32 bits
by appending leading zeros.
File Names
Each disk file in the NonStop Kernel operating system is identified by a unique,
symbolic file name. In the syntax descriptions for PTrace commands, the variable
file-name is used to denote a partially or fully qualified NonStop Kernel file name.
A fully qualified file name has all four parts explicitly specified.
A partially qualified file name has one or more optional parts missing; PTrace uses
appropriate default values to expand the file name to four parts.
The syntax of file-name is as follows:
•
\system-name identifies a specific system within a network, for example, \WASH.
•
$volume-name identifies a physical disk pack mounted on a disk unit, for
example, $DATA.
•
subvolume-name identifies a related set of files defined by the user, for example,
RESDEV.
Decimal { { 0|1|2|3|4|5|6|7|8|9 }... }
Octal { % { 0|1|2|3|4|5|6|7 }... }
Binary { %B { 0|1 }... }
Hex { %H { 0|1|2|3|4|5|6|7|8|9|A|B|C|D|E|F }... }
[\system-name.] [$volume-name.] [subvolume-name.] file-id