HP-UX Reference (11i v2 03/08) - 5 Miscellaneous Topics, 7 Device (Special) Files, 9 General Information, Index (vol 9)

s
sad(7) sad(7)
SAD_GAP Lets you use the sad driver to obtain
autopush configuration information for a device
by setting the
sap_major and sap_minor fields of the
strapush structure (see the
SAD_SAP command) to the major and minor device numbers of the device being queried.
arg should point to a struct of type
strapush. Upon successful completion, the stra-
push structure contains all of the information used to configure the device. Values of 0
(zero) will appear in any unused entry in the module list.
SAD_VML Enables you to check a list of modules. For example, you can determine if a specific
module has been installed. The arg parameter points to a
str_list structure (defined
in the
<stropts.h> header file), whose members are as follows:
struct str_list {
int sl_nmods;
struct str_mlist *sl_modlist;
};
sl_nmods Specifies the number of entries you have allocated in an array.
sl_modlist Points to the array of module names. The
str_mlist structure (also in
the
<stropts.h> header file) is as follows:
struct str_mlist {
char l_name[FMNAMESZ+1];
};
where l_name specifies the array of module names.
If the
l_name array is valid, the SAD_VML command returns a value
of 0 (zero). If the array contains an invalid module name, the command
returns a value of 1. Upon failure, the command returns a value of -1.
Notes
As a STREAMS driver, sad also supports the normal STREAMS I_STR ioctl():
int ioctl(fildes, I_STR, strp);
int fildes;
struct strioctl *strp;
In this form, specify the ic_cmd field in the strioctl structure to either SAD_SAP,
SAD_GAP,or
SAD_VML. The ic_dp field points to the strapush structure (see the SAD_SAP command in the
DESCRIPTION section). Refer to the streamio (7) reference page for further details.
RETURN VALUE
Unless specified otherwise, upon successful completion, the
sad ioctl() commands return a value of 0
(zero). Otherwise, a value of -1 is returned.
ERRORS
If any of the following conditions occur, the
sad ioctl commands return the corresponding value:
SAD_SAP
[EEXIST] The specified major/minor device number pair
(sad_major/sad_minor) has already been configured.
[EFAULT] The arg parameter points outside the allocated address space.
[EINVAL] The major device number (
sad_major) is invalid, the number of
modules (sap_list[MAXAPUSH][FMNAMESZ+1]) is invalid, or the
list of module names is invalid.
[ENODEV] The device is not configured for
autopush. This value is returned from
a SAD_GAP command.
[ENOSR] A internal
autopush data structure cannot be allocated.
[ENOSTR] The major device does not represent a STREAMS driver.
[ERANGE] The
sap_lastminor field is less than the sap_minor field when the
command is SAP_RANGE, or the minor device specified in a SAP_CLEAR
Section 7−−128 Hewlett-Packard Company − 2 − HP-UX 11i Version 2: August 2003