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)