DmiGetVersion man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

DmiGetConfig(3DMI)	     DMI Library Functions	    DmiGetConfig(3DMI)

NAME
       DmiGetConfig, DmiGetVersion, DmiRegister, DmiSetConfig, DmiUnregister -
       Management Interface initialization functions

SYNOPSIS
       cc [ flag ... ] file ... -ldmimi	 -ldmi	 -lnsl	 -lrwtool  [ library ... ]
       #include <server.h>
       #include <miapi.h>

       bool_t DmiGetConfig(DmiGetConfigIN argin, DmiGetConfigOUT *result,
	    DmiRpcHandle *dmi_rpc_handle);

       bool_t DmiGetVersion(DmiGetVersionIN argin, DmiGetVersionOUT *result,
	    DmiRpcHandle *dmi_rpc_handle);

       bool_t DmiRegister(DmiRegisterIN argin, DmiRegisterOUT *result, DmiRpcHandle *dmi_rpc_handle);

       bool_t DmiSetConfig(DmiSetConfigIN argin, DmiSetConfigOUT *result,
	    DmiRpcHandle *dmi_rpc_handle);

       bool_t DmiUnregister(DmiUnregisterIN argin, DmiUnregisterOUT *result,
	    DmiRpcHandle  *dmi_rpc_handle);

DESCRIPTION
       The Management Interface initialization functions enable you to	regis‐
       ter   management	 applications  to  the	Service Provider. You may also
       retrieve	 information about the Service Provider, get and set   session
       configuration information for your session.

       The  DmiGetConfig()  function  retrieves	 the per-session configuration
       information.   The  configuration  information  consists	 of  a	string
       describing  the	current language being used for the session. The argin
       parameter is an instance of a DmiGetConfigIN structure  containing  the
       following member:

	 DmiHandle_t	    handle;	     /* an open session handle */

       The  result  parameter is a pointer to a DmiGetConfigOUT structure con‐
       taining the following members:

	 DmiErrorStatus_t   error_status;
	 DmiString_t	    *language;	     /* current session language */

       The DmiGetVersion() function retrieves information  about  the  Service
       Provider.   The	management application uses the DmiGetVersion() proce‐
       dure to determine the DMI specification level supported by the  Service
       Provider.  This procedure also returns the service provided description
       string, and may contain version information about the Service  Provider
       implementation. The argin parameter is an instance of a DmiGetVersionIN
       structure containing the following member:

	 DmiHandle_t	    handle;	     /* an open session handle */

       The result parameter is a pointer to a DmiGetVersionOUT structure  con‐
       taining	the following members:

	 DmiErrorStatus_t   error_status;
	 DmiString_t	    *dmiSpecLevel;   /* DMI specification version */
	 DmiString_t	    *description;    /* OS specific DMI SP version */
	 DmiFileTypeList_t  *fileTypes;	     /* file types for MIF installation */

       The   DmiRegister() function provides the management application with a
       unique per-session handle.  The Service Provider uses this procedure to
       initialize to an internal state for  subsequent procedure calls made by
       the application.	 This procedure must be the first command executed  by
       the  management	application.  argin  is an instance of a DmiRegisterIN
       structure containing the following member:

	 DmiHandle_t	    handle;	     /* an open session handle */

       The result parameter is a pointer to a  DmiRegisterOUT  structure  con‐
       taining the following members:

	 DmiErrorStatus_t   error_status;
	 DmiHandle_t	    *handle;	     /* an open session handle */

       The DmiSetConfig() function sets the per-session configuration informa‐
       tion.  The configuration information consists of	 a  string  describing
       the  language required by the management application. The argin parame‐
       ter is an instance of a DmiSetConfigIN structure containing the follow‐
       ing member:

	 DmiHandle_t	    handle;	     /* an open session handle */
	 DmiString_t	    *language;	     /* current language required */

       The  result  parameter is a pointer to a DmiSetConfigOUT structure con‐
       taining the following member:

	 DmiErrorStatus_t   error_status;

       The DmiUnregister() function is used by the Service Provider to perform
       end-of-session	cleanup	 actions.   On	return from this function, the
       session handle is  no longer valid. This function must be the last  DMI
       command executed by the management  application. The argin parameter is
       an instance of a	 DmiUnregisterIN structure  containing	the  following
       member:

	 DmiHandle_t	    handle;	     /* an open session handle */

       The  result parameter is a pointer to a DmiUnregisterOUT structure con‐
       taining the following members:

	 DmiErrorStatus_t   error_status;

RETURN VALUES
       The DmiGetConfig() function returns the following possible values:

	 DMIERR_NO_ERROR
	 DMIERR_ILLEGAL_RPC_HANDLE
	 DMIERR_OUT_OF_MEMORY
	 DMIERR_ILLEGAL_PARAMETER
	 DMIERR_SP_INACTIVE

       The DmiGetVersion() function returns the following possible values:

	 DMIERR_NO_ERROR
	 DMIERR_ILLEGAL_RPC_HANDLE
	 DMIERR_OUT_OF_MEMORY
	 DMIERR_SP_INACTIVE

       The DmiRegister() function returns the following possible values:

	 DMIERR_NO_ERROR
	 DMIERR_ILLEGAL_RPC_HANDLE
	 DMIERR_OUT_OF_MEMORY
	 DMIERR_SP_INACTIVE

       The DmiSetConfig() function returns the following possible values:

	 DMIERR_NO_ERROR
	 DMIERR_ILLEGAL_RPC_HANDLE
	 DMIERR_OUT_OF_MEMORY
	 DMIERR_ILLEGAL_PARAMETER
	 DMIERR_SP_INACTIVE
	 DMIERR_ILLEGAL_TO_SET

       The DmiUnRegister() function returns the following possible values:

	 DMIERR_NO_ERROR
	 DMIERR_ILLEGAL_RPC_HANDLE
	 DMIERR_OUT_OF_MEMORY
	 DMIERR_ILLEGAL_PARAMETER
	 DMIERR_SP_INACTIVE

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Obsolete			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-level		     │Unsafe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       attributes(5)

SunOS 5.10			  30 May 2012		    DmiGetConfig(3DMI)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net