dmi(2)

NAME
     dmi - DMAPI internal system call

SYNOPSIS
     #include <sys/dmi_kern.h>

     int dmi (int opcode, ...);

DESCRIPTION
     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
     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
     DM_OBJ_REF_RELE
     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
     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
     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.