cfg_attr_t(9s)															    cfg_attr_t(9s)

NAME

       cfg_attr_t - General: Contains information for managing the loading and unloading of kernel modules

SYNOPSIS

       typedef struct cfg_attr {
	 char		   name[CFG_ATTR_NAME_SZ];
	 uchar		   type;
	 uchar		   operation;
	 uint		   status;
	 long		   index;
	 union {
	     struct {
		 caddr_t   val;
		 ulong	   min_size;
		 ulong	   max_size;
		 void	   (*disposal)();
		 ulong	   val_size;
	     } bin;

	     struct {
		 caddr_t   val;
		 ulong	   min_len;
		 ulong	   max_len;
		 void	   (*disposal)();
	     } str;

	     struct {
		 ulong	   val;
		 ulong	   min_val;
		 ulong	   max_val;
	     } num;
	 } attr; } cfg_attr_t;

MEMBERS

       Specifies  the ASCII name of the attribute. The name must be between 2 and CFG_ATTR_NAME_SZ characters in length, including the terminating
       null character. Do not begin the ASCII name of the attribute with the Method_ or Device_ characters.  The cfgmgr framework reserves certain
       names  that begin with the Method_ and Device_ characters.  Specifies the data type associated with the name attribute. See the DESCRIPTION
       section for the constants you can pass to the type member.  Specifies  the  operations  that  the  cfgmgr  framework  can  perform  on  the
       attribute.  See	the  DESCRIPTION  section  for the constants you can pass to the operation member.  Stores the return code from operations
       (configure, unconfigure, query) that the cfgmgr framework performs. See the DESCRIPTION section for the operation  codes  that  the  cfgmgr
       framework  can return to the status member.  Stores a value that scopes the target for indexed attributes.  Specifies a union of the possi-
       ble attribute types used for storing values, kernel locations, validation criteria, and disposal routines.  The cfgmgr framework  uses  the
       appropriate union element according to the attribute type. For example, attributes of type CFG_ATTR_ULONGTYPE use the union element num.

DESCRIPTION

       The  cfg_attr_t	data structure contains information for managing the configuring and unconfiguring of kernel modules. The cfgmgr framework
       passes a pointer to this data structure to the kernel module's configure routine.  The kernel module can parse this  structure  pointer	to
       check the validity of the values associated with the module's associated sysconfigtab file fragment and the /etc/sysconfigtab database.

       You  must set the type member to one of the following constants: Data type is a null-terminated array of characters.  Data type is a 32-bit
       signed integer.	Data type is a 32-bit unsigned integer.  Data type is a 64-bit signed integer.	Data type is a	64-bit	unsigned  integer.
       Data type is an array of bytes.	Data type is an 8-bit unsigned character.  Data type is a 16-bit unsigned short integer.

       You  can  set the operation member to one of the following constants: The cfgmgr framework configures the attribute.  This means the cfgmgr
       framework obtains a data value for the attribute from the /etc/sysconfigtab database. The configure operation occurs when the cfgmgr frame-
       work  calls the configure routine at its CFG_OP_CONFIGURE entry point.  (That is, the optype argument of the configure routine evaluates to
       the CFG_OP_CONFIGURE constant.)	The cfgmgr framework queries (reads) the attribute. This means the kernel module cooperates with the  cfg-
       mgr framework to provide the value associated with the attribute as a result of user-initiated query requests. These requests are typically
       the result of the sysconfig -q command. The query  operation  occurs  when  the	cfgmgr	framework  calls  the  configure  routine  at  its
       CFG_OP_QUERY  entry  point.  (That  is,	the  optype argument of the configure routine evaluates to the CFG_OP_QUERY constant.)	The cfgmgr
       framework reconfigures the attribute.  This means the cfgmgr framework reconfigures the data value for the attribute.   This  functionality
       allows  a  user to modify the attribute.  A reconfigure request is typically the result of the sysconfig -r command. The reconfigure opera-
       tion occurs when the cfgmgr framework calls the configure routine at its CFG_OP_RECONFIGURE entry point. (That is, the optype  argument	of
       the configure routine evaluates to the CFG_OP_RECONFIGURE constant.)

       The cfgmgr framework can return one of the following operation codes: Successful operation.  The attribute you specified in the name member
       does not exist.	The attribute you specified in the name member does not support the operation.	The subsystem failed.  The value  or  size
       of the attribute you specified in the name member is too small.	The value or size of the attribute you specified in the name member is too
       large.  The data type that you specified for the attribute you specified in the name member is invalid or is a mismatch.  The index associ-
       ated with the attribute that you specified in the name member is invalid.  The cfgmgr framework could not allocate memory for the specified
       attribute.  The attribute that you specified in the name member cannot be converted to a number.

FILES

SEE ALSO

       Data Structures: cfg_subsys_attr_t(9s)

																    cfg_attr_t(9s)