cm_getval(D3) cm_getval(D3)
NAME
cm_getval - retrieve an entry from the resource manager
database
SYNOPSIS
#include <sys/confmgr.h>
#include <sys/ddi.h>
int cm_getval(cm_args_t *args);
Arguments
args Structure containing request arguments.
DESCRIPTION
cm_getval retrieves the n-th value associated with a (key,
param) pair from the resource manager database.
Return Values
cm_getval returns 0 for success. The following errnos are
returned for failure:
EINVAL if args is NULL, cm_param is NULL, or cm_key is
invalid.
ENOSPC if cm_vallen is less than the actual size of the value.
ENOENT if there is no value for the n-th param.
USAGE
The cm_key and cm_param elements of the args structure should
be set to select the (key, param) pair whose value is to be
retrieved. The cm_n args element should be set to select
which instance of the value is to be returned. Value
instances are numbered from 0 consecutively up to the last
instance stored in the resource manager's database. Thus, all
values associated with a (key, param) pair can be retrieved by
looping through cm_getval calls starting with a cm_n of zero
and continuing with incremented cm_n until cm_getval returns
an ENOENT. If ENOSPC or success is returned, cm_vallen will
be updated with the actual length of the stored value.
Level
Initialization or Base.
Copyright 1994 Novell, Inc. Page 1
cm_getval(D3) cm_getval(D3)
Synchronization Constraints
Does not sleep.
Driver-defined basic locks, read/write locks, and sleep locks
may be held across calls to this function.
REFERENCES
cm_args(D4), cm_params(D5), errnos(D5)
NOTICES
Portability
All processors
Applicability
ddi: 6, 6mp, 7, 7mp
Copyright 1994 Novell, Inc. Page 2