Intro(3dmi)
Intro --
DMI 2.0 Service Provider API
Description
The Desktop Management Interface (DMI) package enables UnixWare 7
systems to be managed locally or remotely through the use of ONC
RPC.
The pages in this section detail the APIs that allow Service
Providers and management applications to interact, and Service Providers
and components to interact.
DMI is provided in package data stream format. ( See
``Installing the DMI package'' in Desktop Management Interface programming
for details of how to install it.) The package consists of
the following files.
Binary objects
These are all installed in /usr/sbin.
dmispd-
DMI 2.0 Service Provider daemon
oncsp-
DMI 2.0 ONC RPC Client/Server daemon
Shared libraries
These are all installed in /usr/lib.
libdmiapi.so-
DMI API functions
libdmi2api.so-
DMI 2.0 server interface functions
libdmiutil.so-
DMI 2.0 utility functions
libdmionc.so-
DMI 2.0 client ONC RPC functions
Include files
These are all installed in /usr/include/dmi.
clidmi.h-
DMI client front-end interface
dmi2ci.h-
DMI 2.0 component interface
dmi2com.h-
DMI 2.0 type definitions
dmi2err.h-
DMI 2.0 error codes
dmi2ind.h-
DMI 2.0 indications
dmi2mem.h-
DMI 2.0 memory management definitions
dmi2os.h-
DMI 2.0 operating system-specific definitions
dmi2srv.h-
DMI 2.0 management interface definitions
Scripts
/etc/init.d/dmi-
Start/stop script.
/etc/rc2.d/S89dmi-
Symbolic link to /etc/init.d/dmi; causes DMI-SP
to be started automatically on reboot.
/etc/rc0.d/K30dmi (also /etc/rc1.d/K30dmi)-
Symbolic link to /etc/init.d/dmi; causes DMI-SP
to be stopped automatically on shutdown.
/usr/bin/dmi-
Symbolic link to /etc/init.d/dmi - for starting and stopping DMI
daemons manually.
/etc/dmi/mifs/uxsp.mif-
UnixWare DMI-SP MIF file.
DMI APIs
In the DMI framework, there are several classes of APIs.
These classes are:
-
Management application support functions
-
Management application provider functions
-
DMI Service provider functions for management applications
-
DMI Service provider functions for components
-
Component provider functions
-
Memory handling functions
Management application support functions
These are functions implemented by the Management Application client
front end. These
functions, defined in clidmi.h, are:
Management application provider functions
These are functions implemented by the Management Application (MA)
Provider that may be invoked by the DMI Service Provider. These
functions enable a management application to receive indications.
These functions, defined in dmi2ind.h
are:
DMI Service provider functions for management applications
These are functions implemented by the DMI Service Provider
that can be invoked by Management Applications. The functions,
defined in dmi2srv.h, are:
DMI Service provider functions for components
These functions are implemented by the DMI Service Provider
that may be invoked by Component Providers.
Component provider functions
These functions are implemented by Component Providers and can be
invoked by DMI Service Providers.
These functions, defined in dmi/dmi2ci.h, are:
Memory handling functions
The MI Support Functions provide the client writer with
convenient memory allocation routines, in order to ease memory handling
and allocation. DMI associates allocated memory to pools,
being a convenient way of grouping allocated memory. Users may create
pools, allocate memory and associate it to a specific pool or free pool
memory. Pools can also be destroyed; this would cause all allocated
memory belonging to that pool to be released. The memory handling
functions, defined in dmi/dmi2mem.h are:
Return values
For a list and description of return values, see
``DMI error codes'' in Desktop Management Interface programming.
References
-
Desktop Management Interface programming in Desktop Management Interface programming
-
dmi(1M)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004