HP-UX Reference (11i v1 00/12) - 5 Miscellaneous Topics, 7 Device (Special) Files, 9 General Information, Index (vol 9)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man7/!!!intro.7
________________________________________________________________
___ ___
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
HP-UX Release 11i: December 2000 − 2 − Section 7−−109
___
___