Guardian Procedure Calls Reference Manual

specific-info:specific-info-maxlen
output:input
STRING .EXT:ref:*, INT:value
if present and if specific-info-maxlen is not 0, points to a buffer that returns a set of
physical device attributes obtained from the I/O subsystem that supports the specified device.
The attribute values are returned in a structure that is defined by the I/O subsystem. See Structure
Definitions for specificinfo (page 191) for a detailed description of the structure and values of
this buffer.
specific-info-maxlen specifies the length (in bytes) of the buffer pointed to by
specific-info. If the buffer length is too short for the full set of device attributes, the
procedure returns as many values as will fit in the buffer.
If this parameter pair is present, specific-info-len must also be present.
specific-info-len
output
INT .EXT:ref:1
returns the actual length (in byte)s of the buffer pointed to by specific-info. If
specific-info-len is greater than specific-info-maxlen, then specific-info
does not contain all the available data from the I/O subsystem.
This parameter must be present if specific-info is present.
timeout
input
INT(32):value
specifies how many hundredths of a second the procedure waits for a response from the I/O
subsystem. The maximum value is 2147483647. The default value is 6000D (one minute). A
value of -1D causes the procedure to wait indefinitely.
error-detail
output
INT(32) .EXT:ref:1
for some returned errors, contains additional information. See Returned Value.
Returned Value
INT(32)
Outcome of the call:
Information was successfully returned.0D
Either the device or the process simulating a device detected a file-system error; error-detail contains a
file-system error number. If error-detail is 14D, the device was not found. If error-detail is 40D,
the I/O subsystem did not respond within the timeout specified.
1D
Parameter error; error-detail contains the number of the first parameter found to be in error, where 1D
designates the first parameter on the left.
2D
Bounds error; error-detail contains the number of the first parameter found to be in error, where 1D
designates the first parameter on the left.
3D
Either the device or the process simulating a device detected an error; error-detail contains the error
number returned by the device. If error-detail is -1D, the returned information is invalid.
4D
CONFIG_GETINFO_BYNAME_ Procedure 187