Home » HP Manuals » Desktops » HP Visualize c160L » Manual Viewer

HP Visualize c160L HP-UX DMI 2.0 Developer's Guide: HP-UX/HP 9000 Computers, - Page 121

Component Interface Skeleton

Get HP Visualize c160L - Workstation PDF manuals and user guides

Add to My Manuals
Save this manual to your list of manuals

Page 121 highlights

B Component Interface Skeleton The HP-UX DMI 2.0 SDK includes a set of skeleton files that can be used to develop DMI Components. Those files and their related directories are as follows: Directory /usr/dmi/examples/ci/skeleton This directory contains the source, headers and Makefile. Files /var/dmi/mif/C/ci_skeleton.mif This is a skeleton MIF file. It has the ComponentID group and some boilerplate information for groups and attributes. /usr/dmi/examples/ci/skeletonCode/Makefile This Makefile builds the source files into an executable named ci_YourCi. It has no function because it is only a skeleton. The executable links against the correct libraries and includes the correct header files. You may want to rename the files for your component implementation. /usr/dmi/examples/ci/skeletonCode/ci_skeletonMain.h This is the header for the main routine file. /usr/dmi/examples/ci/skeletonCode/ci_skeletonCallbac ks.h This header contains prototypes for the developer-defined procedures. 121

Section	Page
1 Introduction	13
Terminology	13
Component Interface API	13
Component	13
Component Instrumentation (CI)	13
Direct Interface	14
Desktop Management Interface (DMI)	14
Distributed Management Task Force (DMTF)	14
Indication Server	14
Management Interface API	14
Management Interface Client	14
Management Interface Server	14
Management Interface Format (MIF)	15
MIF Database	15
MIF File	15
Overlay Component	15
Row	16
Scalar Group	16
Service Provider (SP)	16
Table Group	16
Overview of the Desktop Management Interface	17
Installing DMI	19
2 SDK Tools	21
The MIF Browser	22
QueryDB	23
DMI Log Viewer	24
3 Component Interface Concepts	25
Static vs. Dynamic Data	26
Direct Interface vs. Overlay Instrumentation	28
Direct-Interface Instrumentation	28
Debugging Direct-Interface Instrumentation	28
Overlay Instrumentation	28
Group-Level Security	30
Modifying Groups to Use Security Tokens	30
Security Token Handling	31
4 Writing Component MIF Files	33
Management Information Format (MIF) Files	33
Example MIF	35
5 Component Interface Data Structures	37
DmiAccessData	38
DmiAccessDataList	39
DmiRegisterInfo	40
6 Component Interface Functions	41
Service Provider Functions for Components	42
DmiMainLoop()	42
DmiOriginateEvent()	42
DmiRegisterCi()	43
DmiUnregisterCi()	43
Component Provider Functions	44
CiGetAttribute()	44
CiGetNextAttribute()	45
CiReleaseAttribute()	45
CiReserveAttribute()	45
CiSetAttribute()	45
CiAddRow()	46
CiDeleteRow()	46
Optional Component Interface Support Functions	47
validateToken()	47
7 Management Interface Concepts	49
DCE/RPC Remotability	50
MI Security	51
Group-Level Security	51
Machine List Protection	52
User Name Check on HP-UX Clients	52
8 Management Interface Data Structures	53
DMI Data Types	54
DMI Enumerated Types	55
DmiAccessMode	55
DmiDataType	56
DmiFileType	57
DmiRequestMode	58
DmiSetMode	58
DmiStorageType	58
DMI Data Structures	59
DmiAttributeData	59
DmiAttributeIds	60
DmiAttributeInfo	61
DmiAttributeList	62
DmiAttributeValues	62
DmiClassNameInfo	62
DmiClassNameList	63
DmiComponentInfo	64
DmiComponentList	65
DmiDataUnion	65
DmiEnumInfo	65
DmiEnumList	66
DmiFileDataInfo	66
DmiFileDataList	66
DmiFileTypeList	67
DmiGroupInfo	68
DmiGroupList	69
DmiMultiRowData	69
DmiMultiRowRequest	69
DmiNodeAddress	70
DmiOctetString	70
DmiRowData	71
DmiRowRequest	72
DmiString	73
DmiStringList	73
DmiTimestamp	74
9 Management Interface Functions	75
Service Provider Functions for Management Applications	76
Initialization Functions	76
DmiGetConfig()	76
DmiGetVersion()	76
DmiMainLoop()	76
DmiRegister()	76
DmiRemoteRegister()	76
DmiRemoteUnregister()	77
DmiSetConfig()	77
DmiUnregister()	77
Listing Functions	77
DmiListAttributes()	77
DmiListClassNames()	77
DmiListComponents()	78
DmiListComponentsByClass()	78
DmiListGroups()	78
DmiListLanguages()	78
Operation Functions	79
DmiAddRow()	79
DmiDeleteRow()	79
DmiGetAttribute()	79
DmiGetMultiple()	79
DmiSetAttribute()	79
DmiSetMultiple()	80
Database Administration Functions	80
DmiAddComponent()	80
DmiAddGroup()	80
DmiAddLanguage()	80
DmiDeleteComponent()	80
DmiDeleteGroup()	81
DmiDeleteLanguage()	81
Management Application Provider Functions	82
Indication Functions	82
DmiComponentAdded()	82
DmiComponentDeleted()	82
DmiDeliverEvent()	82
DmiGroupAdded()	83
DmiGroupDeleted()	83
DmiLanguageAdded()	83
DmiLanguageDeleted()	83
DmiSubscriptionNotice()	83
Optional Management Interface Support Functions (Memory Handling, Security and Message Logging)	85
Memory Handling and Security Functions	85
DmiAlloc()	85
DmiCopyAttributeData()	85
DmiCopyAttributeIds()	85
DmiCopyAttributeList()	85
DmiCopyAttributeValues()	85
DmiCopyClassNameInfo()	86
DmiCopyClassNameList()	86
DmiCopyComponentInfo()	86
DmiCopyComponentList()	86
DmiCopyDataUnion()	86
DmiCopyEnumInfo()	86
DmiCopyEnumList()	87
DmiCopyFileDataInfo()	87
DmiCopyFileDataList()	87
DmiCopyFileTypeList()	87
DmiCopyGroupInfo()	87
DmiCopyGroupList()	87
DmiCopyMultiRowData()	87
DmiCopyMultiRowRequest()	88
DmiCopyNodeAddress()	88
DmiCopyOctetString()	88
DmiCopyRowData()	88
DmiCopyRowRequest()	88
DmiCopyString()	88
DmiCopyStringList()	89
DmiCopyTimestamp()	89
DmiCopyUnicodeString()	89
DmiDupAttributeData()	89
DmiDupAttributeIds()	89
DmiDupAttributeInfo()	89
DmiDupAttributeList()	90
DmiDupAttributeValues()	90
DmiDupClassNameInfo()	90
DmiDupClassNameList()	90
DmiDupComponentInfo()	90
DmiDupComponentList()	90
DmiDupDataUnion()	91
DmiDupEnumInfo()	91
DmiDupEnumList()	91
DmiDupFileDataInfo()	91
DmiDupFileDataList()	91
DmiDupFileTypeList()	91
DmiDupGroupInfo()	91
DmiDupGroupList()	92
DmiDupMultiRowData()	92
DmiDupMultiRowRequest()	92
DmiDupNodeAddress()	92
DmiDupOctetString()	92
DmiDupRowData()	92
DmiDupRowRequest()	93
DmiDupString()	93
DmiDupStringList()	93
DmiDupTimestamp()	93
DmiDupUnicodeString()	93
DmiFree()	93
DmiFreeAttributeData()	94
DmiFreeAttributeIds()	94
DMIFreeAttributeInfo()	94
DmiFreeAttributeList()	94
DmiFreeAttributeValues()	94
DmiFreeClassNameList()	94
DmiFreeComponentList()	94
DmiFreeClassNameInfo()	95
DmiFreeComponentInfo()	95
DmiFreeDataUnion()	95
DmiFreeEnumInfo()	95
DmiFreeEnumList()	95
DmiFreeFileDataInfo()	95
DmiFreeFileDataList()	95
DmiFreeFileTypeList()	96
DmiFreeGroupInfo()	96
DmiFreeGroupList()	96
DmiFreeMultiRowRequest()	96
DmiFreeMultiRowData()	96
DmiFreeNodeAddress()	96
DmiFreeOctetString()	96
DmiFreeRowData()	97
DmiFreeRowRequest()	97
DmiFreeString()	97
DmiFreeStringList()	97
DmiFreeTimestamp()	97
DmiFreeUnicodeString()	97
DmiGetSubscriptionAddress()	97
DmiIndicationListen()	98
DmiListRpcTypes()	98
DmiListTransportTypes()	98
DmiNewAttributeData()	98
DmiNewAttributeIds()	98
DmiNewAttributeInfo()	98
DmiNewAttributeList()	98
DmiNewAttributeValues()	99
DmiNewClassNameInfo()	99
DmiNewClassNameList()	99
DmiNewComponentInfo()	99
DmiNewComponentList()	99
DmiNewDataUnion()	99
DmiNewEnumInfo()	99
DmiNewEnumList()	100
DmiNewFileDataInfo()	100
DmiNewFileDataList()	100
DmiNewFileTypeList	100
DmiNewGroupInfo()	100
DmiNewGroupList()	100
DmiNewMultiRowData()	100
DmiNewMultiRowRequest()	101
DmiNewNodeAddress()	101
DmiNewOctetString()	101
DmiNewRowData()	101
DmiNewRowRequest()	101
DmiNewString()	101
DmiNewStringList()	102
DmiNewTimestamp()	102
DmiNewUnicodeString()	102
DmiSetDefaultNode()	102
DmiSetIndicationCallbacks()	102
DmiStopIndicationListening()	102
generateToken()	103
dmiLogMessage()	103
10 Events and Indications	105
About DMI 2.0 Events and Indications	105
Event Indications	105
DmiComponentAdded()	105
DmiComponentDeleted()	105
DmiDeliverEvent()	105
DmiGroupAdded()	106
DmiGroupDeleted()	106
DmiLanguageAdded()	106
DmiLanguageDeleted()	106
DmiSubscriptionNotice()	107
Monitoring Events	108
Registering With a Host's SP	108
Creating a DCE/RPC Endpoint	108
Adding Rows to the SP Tables	108
Procedural Entry Points	110
11 Error Handling and Messaging	111
A An HP-UX DMI 2.0 Example Code	115
The Example Management Application	116
The Example Component	117
Compiling the Example	119
Running the Example	120
B Component Interface Skeleton	121
Directory	121
/usr/dmi/examples/ci/skeleton	121
Files	121
/var/dmi/mif/C/ci_skeleton.mif	121
/usr/dmi/examples/ci/skeletonCode/Makefile	121
/usr/dmi/examples/ci/skeletonCode/ci_skeletonMain.h	121
/usr/dmi/examples/ci/skeletonCode/ci_skeletonCallbac ks.h	121
/usr/dmi/examples/ci/skeletonCode/ci_skeletonCallbac ks.c	122
/usr/dmi/examples/ci/skeletonCode/ci_skeletonSpecifi c.c	122
/usr/dmi/examples/ci/skeletonCode/ci_skeletonMain.c	122
C HP-UX Systems MIF Groups Quick Reference	123
Component Information Groups	124
System Information Groups	125
Logical Volume Manager Groups	127
Network Configuration Groups	128
D HP-UX Software MIF Groups Quick Reference	129
General Groups	130
Bundle Groups	131
Product and Subproduct Groups	132
Fileset Groups	133