sad.7 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

sad(7) sad(7)

NAME

sad - STREAMS Administrative Driver

SYNOPSIS

#include <sys/types.h>

#include <sys/conf.h>

#include <sys/sad.h>

#include <stropts.h>

int ioctl(

int ﬁldes,

int command,

...

/* arg */

);

DESCRIPTION

The sad driver provides an interface to the

autopush facility using the ioctl() function. As an

interface, the

sad driver enables administrative tasks to be performed on STREAMS modules and

drivers. By specifying the command parameter to the

ioctl() function, an administrator can conﬁgure

autopush information for a device, get information on a device, or check a list of modules.

ﬁldes is a ﬁle descriptor obtained by opening

/dev/sad using open(). command speciﬁes the adminis-

trative function to be performed. arg points to a data structure. If command is SAD_SAP or SAD_GAP

arg points to a struct of type

strapush.Ifcommand is SAD_VML, arg points to a struct of type

str_list.

Security Restrictions

The

SAD_SAP ioctl() is restricted to superusers or users with the NETADMIN privilege. See

privileges (5) for more information about privileged access on systems that support ﬁne-grained privileges.

ioctl Commands

The commands used to perform administrative functions on a STREAMS module or driver are speciﬁed

by the following

ioctl() commands:

SAD_SAP Allows you to conﬁgure autopush information for a device. The arg parameter points to a

strapush structure (deﬁned in the <sys/sad.h> header ﬁle), whose members are as fol-

lows:

struct strapush {

uint sap_cmd;

long sap_major;

long sap_minor;

long sap_lastminor;

long sap_npush;

char sap_list[MAXAPUSH][FMNAMESZ+1];

};

sap_cmd Allows you to specify the type of conﬁguration to perform. This ﬁeld can have the

following values:

SAP_ALL Conﬁgures all minor devices.

SAP_RANGE

Conﬁgures a range of minor devices.

SAP_ONE Conﬁgures a single minor device.

SAP_CLEAR

Clears the previous settings. Specify only the sap_major and

sap_minor ﬁelds when using this command. If a previous entry

speciﬁed SAP_ALL, set the sap_minor ﬁeld to 0 (zero). If a previous

entry was speciﬁed as SAP_RANGE, set the sap_minor ﬁeld to the

lowest minor device number in the range.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
sad(7) sad(7) NAME sad - STREAMS Administrative Driver SYNOPSIS #include #include #include #include int ioctl( int fildes , int command , ... /* arg */ ); DESCRIPTION The sad driver provides an interface to the autopush facility using the ioctl() function. As an interface, the sad driver enables administrative tasks to be performed on STREAMS modules and drivers.
PAGE 2
sad(7) sad(7) sap_major Specifies the major device number. sap_minor Specifies the minor device number. sap_lastminor Specifies the range of minor devices. sap_npush Specifies the number of modules to push. This number must be no more than MAXAPUSH, which is defined in . Additionally, this number must not exceed NSTRPUSH. sap_list Specifies, in order, the array of modules to push.
PAGE 3
sad(7) sad(7) 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.
PAGE 4
(Notes) A (Notes) sA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010