BOOTSTRAP (kcms) functions


LIBRARY ROUTINE

kcms_open_toolbox - open an existing toolbox

LIBRARY CALL

kobject
kcms_open_toolbox(
   kstring  tbname)

INPUT

OUTPUT

none

RETURN VALUE

An object reference (kobject) for the opened toolbox, or NULL if the toolbox was not successfully opened, or the toolbox does not exist. In the latter case, errno will be set to KCMS_ENOTFOUND.

DESCRIPTION

This function is used to access an existing toolbox. If the specified toolbox exists, then the toolbox's configuration database is opened, and the information within used to initialize a toolbox object. This object can then be used to reference the toolbox in other kcms operations.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$BOOTSTRAP/objects/library/kcms/src/toolbox.c

SEE ALSO

kcms(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.