cfgabdds
Purpose
Builds and initializes a Define_Device Structure, and
then issues a Define_Device SVC.
Library
Run-time Services Library (librts.a)
Syntax
#include <sys/bioca.h>
int cfgabdds (argc, argv, ptr, len)
int argc;
char *argv[ ];
char *ptr;
int len;
Description
A customize helper program must issue the Define_Device
SVC for each VRM device driver. The cfgabdds subroutine
is provided for use in customize helper programs to sim-
plify the task of building the Define_Device structure
and issuing the SVC. See AIX Operating System Program-
ming Tools and Interfaces for more detailed information
about using this subroutine.
The cfgabdds subroutine takes the following parameters:
argc The number of elements in the argv array passed to
the customize helper by the calling program, which
is normally the vrmconfig command.
argv An array of parameters passed to the customize
helper by the calling program, which is normally
the vrmconfig command.
ptr A pointer to the initialized structure of device-
dependent information for the device being added
to the system. This structure does not include
hardware or block I/O device characteristics. If
the device requires no device-dependent informa-
tion, then set this parameter to NULL.
len The length in bytes of the structure pointed to by
the ptr parameter. If the device requires no
device-dependent information, then set this param-
eter to 0.
The customize helper must pass argc and argv to cfgabdds
without modification.
Return Value
Upon successful completion, the cfgabdds subroutine
returns the value VRCSUCC. If cfgabdds fails, then one
of the following values is returned:
VRCKCORP A configuration file is not in attribute file
format.
VRCKUNXF An error was returned from the SVC that con-
figures the AIX device driver.
VRCKIOPT An invalid option was specified from
vrmconfig.
VRCKNOSP No storage space available. The malloc sub-
routine returned a NULL value.
VRCKIARG One or more parameters are invalid.
VRCKSTNF kaf_file keyword value not found in the argv
passed from vrmconfig.
VRCKASNF kaf_file keyword value not found in the argv
passed from vrmconfig.
VRCKANOP Unable to open kaf file.
VRCKYINF Keyword not found in input file.
VRCKYWNF Keyword not found in kaf file.
VRCKNONE No processing required by library routine.
VRCKNOBY Length of device-dependent information exceeds
the limit of the Define_Device Structure.
(The total space allowed for entire DDS is 500
bytes.)
Related Information
Device Driver Development Guide.
AIX Operating System Programming Tools and Interfaces.