Index for Section 3

Alphabetical listing for C

Bottom of page

cfg_subsys_unconfig(3)
NAME
  cfg_subsys_unconfig - Unconfigure a subsystem

LIBRARY
  Configuration Management Library (libcfg.a)

SYNOPSIS
  #include <cfg.h>
  cfg_status_t cfg_subsys_unconfig(
	  cfg_handle_t *handle,
	  caddr_t subsys);

PARAMETERS
  handle    Structure identifying the means of communication between your
	    application and the configuration management server.  For local
	    requests, pass NULL in this parameter.  For remote requests, pass
	    the value returned from the cfg_connect() routine.

  subsys    Names the subsystem to be unconfigured.

DESCRIPTION
  When a subsystem is not needed, you can use the cfg_subsys_unconfig()
  routine to unconfigure the subsystem.	 If the subsystem is loadable, it is
  unloaded from the kernel. When a subsystem is unloaded, the memory it
  occupies becomes available for other uses.

EXAMPLES
  The following example illustrates the use of the cfg_subsys_unconfig()
  library routine:

       cfg_status_t	       retval;
       cfg_handle_t	       handle;

       retval = cfg_subsys_unconfig(&handle, "presto");

       if (retval != CFG_SUCCESS)
	  print_error(retval);

  In this example, the cfg_subsys_unconfig() routine attempts to unconfigure
  the presto subsystem.	 If an error is returned, the application displays an
  error message.

RETURN VALUES
  Upon successful completion, cfg_subsys_unconfig() returns CFG_SUCCESS.
  Other return values indicate that an error has occurred.  For information
  about handling return values from routines in the configuration management
  library, see libcfg(3).

RELATED INFORMATION
  Commands: cfgmgr(8), sysconfig(8)

  Routines: cfg_subsys_config(3), libcfg(3)

Index for Section 3

Alphabetical listing for C

Top of page