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

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