Index for Section 9r

Alphabetical listing for C

Bottom of page

cfgmgr_get_state(9r)
NAME
  cfgmgr_get_state - General: Determines the configuration state

SYNOPSIS
  int cfgmgr_get_state(
	  char *driver_name,
	  int *driver_cfg_state );

ARGUMENTS
  driver_name
      Specifies the name of the device driver whose configuration state you
      want to obtain. This name is a string that matches the string you
      specified for the entry_name item in the /etc/sysconfigtab database.
      Typically, third-party driver writers specify the driver name (followed
      by a colon) in the sysconfigtab file fragment, which gets appended to
      the /etc/sysconfigtab database during the driver product installation.

  driver_cfg_state
      Returns one of the following state value bits to the driver_cfg_state
      argument:

      SUBSYSTEM_DYNAMICALLY_CONFIGURED
	  The specified device driver is in the dynamic configuration state.
	  This means the driver was dynamically configured into the kernel.

      SUBSYSTEM_STATICALLY_CONFIGURED
	  The specified device driver is in the static configuration state.
	  This means the driver was statically configured into the kernel.

DESCRIPTION
  The cfgmgr_get_state routine obtains the configuration state of the
  specified device driver. The specified device driver is in either the
  static configuration state or the dynamic configuration state.

  The cfgmgr_get_state routine returns the state value in the
  driver_cfg_state argument. Driver writers should store this state value in
  an xx_is_dynamic variable or some similarly named variable.

  You typically call the cfgmgr_get_state routine in the CFG_OP_CONFIGURE
  entry point of the device driver's configure routine.

RETURN VALUES
  Upon successful completion, cfgmgr_get_state returns the value ESUCCESS.
  This success value indicates that cfgmgr_get_state returned the
  configuration state of the specified device driver in the driver_cfg_state
  argument. Otherwise, cfgmgr_get_state returns one of the following error
  constants defined in /usr/sys/include/sys/sysconfig.h and
  /usr/sys/include/sys/errno.h:

  CFG_FRAME_EEXISTS
      The device driver that you specified in the driver_name argument does
      not exist. In this case, cfgmgr_get_state cannot return the
      configuration state of the specified device driver in the
      driver_cfg_state argument.

  EINVAL
      The device driver that you specified in the driver_name argument is not
      a valid name.

EXAMPLES
  See Writing Device Drivers: Tutorial for a code example of the
  cfgmgr_get_state interface.

SEE ALSO
  Routines: cfgmgr_set_status(9r)

Index for Section 9r

Alphabetical listing for C

Top of page