Guardian Procedure Calls Reference Manual (G06.25+)

File Names and Process Identifiers
Guardian Procedure Calls Reference Manual—522629-013
D-7
Process Handles
whether the system interprets the file-name pattern according to the rules of the
second or third form. As a result, the file-name pattern “$*.*” cannot match a
permanent disk file name, but “*.*” can match a permanent disk file name (in the form
subvol.file-id).
Examples
*z* matches all files in the current subvolume that have names (file IDs)
containing the letter "z."
$TERM?? matches all devices on the current node that have 7-character names
starting with “$TERM,” such as “$TERM12.”
P*.* matches all disk files on the current volume that are in subvolumes whose
names begin with the letter “P.”
Process Handles
A process handle is a 10-word structure that identifies a single named or unnamed
process.
A process handle contains the following information about a process:
•
The PIN, which identifies the process within a processor.
•
The processor number, which identifies the processor in which the process is
running.
•
The node number, which identifies the node within a network.
•
The sequence (or verifier) number, which allows the system to uniquely identify a
process over its lifetime.
•
The process pair index, which allows the system to locate the other member of a
named process pair and to look up the process’s name.
•
The type field, which indicates characteristics of the process (for example, whether
the process is named or unnamed).
A process handle that contains -1 in each word is called a
null process handle.
Caution. The format of a process handle is defined by HP and is subject to change in future
RVUs. Applications should not try to extract information (such as processor or PIN) from a
process handle except by using a system procedure such as
PROCESSHANDLE_DECOMPOSE_.