devswmgr(8) [osf1 man page]

devswmgr(8)						      System Manager's Manual						       devswmgr(8)

NAME

       devswmgr - utility to manage the device switch database

SYNOPSIS

       /sbin/devswmgr [-option [parameter]]

OPTIONS

       Displays the following information about the device switch database:

	      Whether a device switch database was read from the primary file or from a backup file

	      The number of entries that are in the device switch table Displays the major numbers that have been reserved by all drivers, a named
	      driver, or an instance of a named driver.

	      A driver that requires more than one entry in the device switch table uses a unique instance number to reference each of its  device
	      switch  table  entries.	Displays  help	for  the devswmgr command.  Releases all the major numbers for a device driver if just the
	      driver name is specified.  Releases one major number for a device driver if the NAME and the INSTANCENUM of the  driver  are  speci-
	      fied.

DESCRIPTION

       The devswmgr command helps you manage the device switch table by displaying information about the devices drivers in the table.

       You  can  also  use  the  command  to  release device switch table entries.  Typically, you release the entries for a driver after you have
       unloaded the driver and do not plan to reload it later.	Releasing the entries frees them for use by other device drivers.

EXAMPLES

       The following example shows that a device switch table was loaded from the  primary  device  and  that  there  are  70  entries	in  it:  %
       /sbin/devswmgr -display Device switch information
	 device switch database read from primary file
	 device  switch  table has 70 entries The following example shows the major numbers in the device switch table that have been reserved for
       the driver named cam_disk: % /sbin/devswmgr -getnum driver=cam_disk

       Device switch reservation list

						 (*=entry in use)
		   driver name		   instance   major
	 -------------------------------   --------   -----
				cam_disk	  1	 8*

FILES

       The file that manages the device switch databases The primary device switch database file The backup device switch database file

SEE ALSO

       Commands: scsimgr(8)

																       devswmgr(8)

cfgmgr_get_state(9r)													      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

       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  (fol-
       lowed  by  a  colon)  in  the  sysconfigtab  file fragment, which gets appended to the /etc/sysconfigtab database during the driver product
       installation.  Returns one of the following state value bits to the driver_cfg_state argument:  The  specified  device  driver  is  in  the
       dynamic	configuration  state.  This  means  the  driver was dynamically configured into the kernel.  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 follow-
       ing error constants defined in /usr/sys/include/sys/sysconfig.h and /usr/sys/include/sys/errno.h: 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.  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)

															      cfgmgr_get_state(9r)