Museum

dmi(2)                                                                  dmi(2)



NAME
     dmi - DMAPI internal system call

SYNOPSIS
     #include <sys/dmikern.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 Managment (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:

     DMCLEARINHERIT
     DMCREATEBYHANDLE
     DMCREATESESSION
     DMCREATEUSEREVENT
     DMDESTROYSESSION
     DMDOWNGRADERIGHT
     DMFDTOHANDLE
     DMFINDEVENTMSG
     DMGETALLOCINFO
     DMGETBULKALL
     DMGETBULKATTR
     DMGETCONFIG
     DMGETCONFIGEVENTS
     DMGETDIOINFO
     DMGETDIRATTRS
     DMGETDMATTR
     DMGETEVENTLIST
     DMGETEVENTS
     DMGETFILEATTR
     DMGETMOUNTINFO
     DMGETREGION
     DMGETALLDISP
     DMGETALLDMATTR
     DMGETALLINHERIT
     DMGETALLSESSIONS
     DMGETALLTOKENS
     DMINITATTRLOC
     DMMKDIRBYHANDLE
     DMMOVEEVENT
     DMOBJREFHOLD
     DMOBJREFQUERY



                                                                        Page 1

dmi(2)                                                                  dmi(2)



     DMOBJREFRELE
     DMPATHTOFSHANDLE
     DMPATHTOHANDLE
     DMPENDING
     DMPROBEHOLE
     DMPUNCHHOLE
     DMQUERYRIGHT
     DMQUERYSESSION
     DMREADINVIS
     DMRELEASERIGHT
     DMREMOVEDMATTR
     DMREQUESTRIGHT
     DMRESPONDEVENT
     DMSENDMSG
     DMSETDISP
     DMSETDMATTR
     DMSETEVENTLIST
     DMSETFILEATTR
     DMSETINHERIT
     DMSETREGION
     DMSETRETURNONDESTROY
     DMSYMLINKBYHANDLE
     DMSYNCBYHANDLE
     DMUPGRADERIGHT
     DMWRITEINVIS


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.














                                                                        Page 2