Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-97
CONFIG_GETINFO_BYNAME_ Procedure
(G-Series and H-Series RVUs Only)
common-info-maxlen input
INT:value
specifies the length in bytes of the buffer pointed to by
common-info. If the buffer
length is too short for the full set of device attributes, the procedure sets
error to
2D, sets
error-detail to 3D, and does not return any information on the
specified device.
common-info-len output
INT .EXT:ref:1
returns the actual length in bytes of the buffer pointed to by
common-info.
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 I/O Subsystems That Use the
specific_info Parameter on
page 3-103 for a detailed description of the structure 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 bytes 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.