NAME

dmi - DMAPI internal system call wrapper

SYNOPSIS

#include <dmapi/dmapi.h>

#include <dmapi/dmapi_kern.h>

#include <dmapi/dmapi_lib.h>

int dmi (int opcode, ...);

DESCRIPTION

dmi is a system interface used to implement the interface defined in the X/Open document: Systems Management: Data Storage Management (XDSM) API dated February 1997. This interface is 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.