Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

cfg_subsys_attr_t(9s) [osf1 man page]

cfg_subsys_attr_t(9s)													     cfg_subsys_attr_t(9s)

NAME
cfg_subsys_attr_t - General: Contains attribute information for kernel modules SYNOPSIS
typedef struct { char name[CFG_ATTR_NAME_SZ]; uchar type; uchar operation; caddr_t addr; ulong min_val; ulong max_val; ulong val_size; } cfg_subsys_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. Specifies the address of the data value associated with the attribute. The cfgmgr framework obtains the data value for this attribute from the /etc/sysconfigtab database and stores it at this address. The cfgmgr framework performs this storage operation if the following occurs: The attribute appears in the cfg_subsys_attr_t table (declared and initialized in the kernel module) with an operation code of CFG_OP_CONFIGURE. The kernel module writer passes the CFG_OP_CONFIGURE constant to the optype argument of the kernel module's configure routine. This is the kernel module's configuration entry point for handling static or dynamic configuration requests. Although the configure routine can initialize attributes that appear in the array with an operation code of CFG_OP_CONFIGURE, the cfgmgr framework overrides this initialization with the value specified in the /etc/sysconfigtab database. Specifies the minimum length of a string data value. If the data type for the attribute is numeric, specifies the minimum range. Specifies the maximum length of a string data value. If the data type for the attribute is numeric, specifies the maximum range. Specifies the binary data size. DESCRIPTION
The cfg_subsys_attr_t data structure contains information that kernel modules use to describe a variety of attributes. Kernel module writ- ers declare and initialize an array of cfg_subsys_attr_t data structures in their kernel modules. The cfg_subsys_attr_t data structure is a simplified version of the cfg_attr_t data structure and is designed to save space in the kernel. 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 kernel module's configure routine at its CFG_OP_CONFIGURE entry point. (That is, the optype argument of theconfigure rou- tine evaluates to the CFG_OP_CONFIGURE constant.) The cfgmgr framework queries (reads) the attribute. This means the kernel module cooper- ates with the cfgmgr 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 kernel mod- ule's 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 operation occurs when the cfgmgr framework calls the kernel module's configure routine at its CFG_OP_RECONFIG- URE entry point. (That is, the optype argument of the configure routine evaluates to the CFG_OP_RECONFIGURE constant.) FILES
SEE ALSO
Data Structures: cfg_attr_t(9s) cfg_subsys_attr_t(9s)
Man Page