dmi(2)									dmi(2)

NAME    [Toc]    [Back]

     dmi - DMAPI internal system call

SYNOPSIS    [Toc]    [Back]

     #include <sys/dmi_kern.h>

     int dmi (int opcode, ...);

DESCRIPTION    [Toc]    [Back]

     dmi is a system interface specific	to Silicon Graphics systems.  It is
     used to implement the interface defined in	the X/Open document:  Systems
     Management: Data Storage Management (XDSM)	API dated February 1997.  This
     interface is available made available on Silicon Graphics systems by
     means of the libdm	library.

     The value of the opcode parameter determines the meaning of the remaining
     arguments.	 These are all interfaces that are used	to implement various
     libdm functions.  The only	filesystem that	supports these operations is
     XFS.  They	are all	subject	to change, should not be called	directly by
     applications, and are not described further.  The valid opcodes are:

     DM_CLEAR_INHERIT    [Toc]    [Back]
     DM_CREATE_BY_HANDLE
     DM_CREATE_SESSION
     DM_CREATE_USEREVENT
     DM_DESTROY_SESSION
     DM_DOWNGRADE_RIGHT
     DM_FD_TO_HANDLE
     DM_FIND_EVENTMSG
     DM_GET_ALLOCINFO
     DM_GET_BULKALL
     DM_GET_BULKATTR
     DM_GET_CONFIG
     DM_GET_CONFIG_EVENTS
     DM_GET_DIOINFO
     DM_GET_DIRATTRS
     DM_GET_DMATTR
     DM_GET_EVENTLIST
     DM_GET_EVENTS
     DM_GET_FILEATTR
     DM_GET_MOUNTINFO
     DM_GET_REGION
     DM_GETALL_DISP
     DM_GETALL_DMATTR
     DM_GETALL_INHERIT
     DM_GETALL_SESSIONS
     DM_GETALL_TOKENS
     DM_INIT_ATTRLOC
     DM_MKDIR_BY_HANDLE
     DM_MOVE_EVENT
     DM_OBJ_REF_HOLD
     DM_OBJ_REF_QUERY



									Page 1






dmi(2)									dmi(2)



     DM_OBJ_REF_RELE    [Toc]    [Back]
     DM_PATH_TO_FSHANDLE
     DM_PATH_TO_HANDLE
     DM_PENDING
     DM_PROBE_HOLE
     DM_PUNCH_HOLE
     DM_QUERY_RIGHT
     DM_QUERY_SESSION
     DM_READ_INVIS
     DM_RELEASE_RIGHT
     DM_REMOVE_DMATTR
     DM_REQUEST_RIGHT
     DM_RESPOND_EVENT
     DM_SEND_MSG
     DM_SET_DISP
     DM_SET_DMATTR
     DM_SET_EVENTLIST
     DM_SET_FILEATTR
     DM_SET_INHERIT
     DM_SET_REGION
     DM_SET_RETURN_ON_DESTROY
     DM_SYMLINK_BY_HANDLE
     DM_SYNC_BY_HANDLE
     DM_UPGRADE_RIGHT
     DM_WRITE_INVIS

ERRORS    [Toc]    [Back]

     The following error codes may be returned by dmi:

     [EFAULT]	 A buffer is referenced	which is not in	a valid	part of	the
		 calling program's address space.

     [EPERM]	 The effective user ID is not superuser.

     [EINVAL]	 An invalid parameter or parameter combination was specified.

DIAGNOSTICS    [Toc]    [Back]

     Upon successful completion, a command dependent value (default of zero)
     is	returned.  Otherwise, a	value of -1 is returned	and errno is set to
     indicate the error.


									PPPPaaaaggggeeee 2222