[BACK]Return to dmapi.html CVS log [TXT][DIR] Up to [Development] / xfs-website.orig / manpages

File: [Development] / xfs-website.orig / manpages / dmapi.html (download) (as text)

Revision 1.1, Thu Jan 25 19:55:30 2001 UTC (16 years, 9 months ago) by xfs
Branch: MAIN
CVS Tags: HEAD

Man pages update.

<html>
<head>
<meta name="Content-Style" content="text/css">
</head>
<body>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="##include &lt;dmapi/dmapi.h&gt;">#include &lt;dmapi/dmapi.h&gt;</a><br>
<a href="##include &lt;dmapi/dmapi_kern.h&gt;">#include &lt;dmapi/dmapi_kern.h&gt;</a><br>
<a href="##include &lt;dmapi/dmapi_lib.h&gt;">#include &lt;dmapi/dmapi_lib.h&gt;</a><br>
<a href="#int dmi (int opcode, ...);">int dmi (int opcode, ...);</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#DM_CLEAR_INHERIT">DM_CLEAR_INHERIT</a><br>
<a href="#DM_CREATE_BY_HANDLE">DM_CREATE_BY_HANDLE</a><br>
<a href="#DM_CREATE_SESSION">DM_CREATE_SESSION</a><br>
<a href="#DM_CREATE_USEREVENT">DM_CREATE_USEREVENT</a><br>
<a href="#DM_DESTROY_SESSION">DM_DESTROY_SESSION</a><br>
<a href="#DM_DOWNGRADE_RIGHT">DM_DOWNGRADE_RIGHT</a><br>
<a href="#DM_FD_TO_HANDLE">DM_FD_TO_HANDLE</a><br>
<a href="#DM_FIND_EVENTMSG">DM_FIND_EVENTMSG</a><br>
<a href="#DM_GET_ALLOCINFO">DM_GET_ALLOCINFO</a><br>
<a href="#DM_GET_BULKALL">DM_GET_BULKALL</a><br>
<a href="#DM_GET_BULKATTR">DM_GET_BULKATTR</a><br>
<a href="#DM_GET_CONFIG">DM_GET_CONFIG</a><br>
<a href="#DM_GET_CONFIG_EVENTS">DM_GET_CONFIG_EVENTS</a><br>
<a href="#DM_GET_DIOINFO">DM_GET_DIOINFO</a><br>
<a href="#DM_GET_DIRATTRS">DM_GET_DIRATTRS</a><br>
<a href="#DM_GET_DMATTR">DM_GET_DMATTR</a><br>
<a href="#DM_GET_EVENTLIST">DM_GET_EVENTLIST</a><br>
<a href="#DM_GET_EVENTS">DM_GET_EVENTS</a><br>
<a href="#DM_GET_FILEATTR">DM_GET_FILEATTR</a><br>
<a href="#DM_GET_MOUNTINFO">DM_GET_MOUNTINFO</a><br>
<a href="#DM_GET_REGION">DM_GET_REGION</a><br>
<a href="#DM_GETALL_DISP">DM_GETALL_DISP</a><br>
<a href="#DM_GETALL_DMATTR">DM_GETALL_DMATTR</a><br>
<a href="#DM_GETALL_INHERIT">DM_GETALL_INHERIT</a><br>
<a href="#DM_GETALL_SESSIONS">DM_GETALL_SESSIONS</a><br>
<a href="#DM_GETALL_TOKENS">DM_GETALL_TOKENS</a><br>
<a href="#DM_INIT_ATTRLOC">DM_INIT_ATTRLOC</a><br>
<a href="#DM_MKDIR_BY_HANDLE">DM_MKDIR_BY_HANDLE</a><br>
<a href="#DM_MOVE_EVENT">DM_MOVE_EVENT</a><br>
<a href="#DM_OBJ_REF_HOLD">DM_OBJ_REF_HOLD</a><br>
<a href="#DM_OBJ_REF_QUERY">DM_OBJ_REF_QUERY</a><br>
<a href="#DM_OBJ_REF_RELE">DM_OBJ_REF_RELE</a><br>
<a href="#DM_PATH_TO_FSHANDLE">DM_PATH_TO_FSHANDLE</a><br>
<a href="#DM_PATH_TO_HANDLE">DM_PATH_TO_HANDLE</a><br>
<a href="#DM_PENDING">DM_PENDING</a><br>
<a href="#DM_PROBE_HOLE">DM_PROBE_HOLE</a><br>
<a href="#DM_PUNCH_HOLE">DM_PUNCH_HOLE</a><br>
<a href="#DM_QUERY_RIGHT">DM_QUERY_RIGHT</a><br>
<a href="#DM_QUERY_SESSION">DM_QUERY_SESSION</a><br>
<a href="#DM_READ_INVIS">DM_READ_INVIS</a><br>
<a href="#DM_RELEASE_RIGHT">DM_RELEASE_RIGHT</a><br>
<a href="#DM_REMOVE_DMATTR">DM_REMOVE_DMATTR</a><br>
<a href="#DM_REQUEST_RIGHT">DM_REQUEST_RIGHT</a><br>
<a href="#DM_RESPOND_EVENT">DM_RESPOND_EVENT</a><br>
<a href="#DM_SEND_MSG">DM_SEND_MSG</a><br>
<a href="#DM_SET_DISP">DM_SET_DISP</a><br>
<a href="#DM_SET_DMATTR">DM_SET_DMATTR</a><br>
<a href="#DM_SET_EVENTLIST">DM_SET_EVENTLIST</a><br>
<a href="#DM_SET_FILEATTR">DM_SET_FILEATTR</a><br>
<a href="#DM_SET_INHERIT">DM_SET_INHERIT</a><br>
<a href="#DM_SET_REGION">DM_SET_REGION</a><br>
<a href="#DM_SET_RETURN_ON_DESTROY">DM_SET_RETURN_ON_DESTROY</a><br>
<a href="#DM_SYMLINK_BY_HANDLE">DM_SYMLINK_BY_HANDLE</a><br>
<a href="#DM_SYNC_BY_HANDLE">DM_SYNC_BY_HANDLE</a><br>
<a href="#DM_UPGRADE_RIGHT">DM_UPGRADE_RIGHT</a><br>
<a href="#DM_WRITE_INVIS">DM_WRITE_INVIS</a><br>
<a href="#ERRORS">ERRORS</a><br>
<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
<!-- Creator     : groff version 1.16.1  -->
<!-- CreationDate: Wed Jan 24 01:42:54 2001
 -->
<!-- Total number of pages: 2 -->
<!-- Page: 1 -->
<!-- left  margin: 220 -->
<!-- right margin: 750 -->
<a name="NAME"></a><h2>NAME</h2><p style="margin-left: 18%"><font size=3>dmi - DMAPI internal system call wrapper</font></p>
<a name="SYNOPSIS"></a><h2>SYNOPSIS</h2><a name="#include &lt;dmapi/dmapi.h&gt;"></a><h2>#include &lt;dmapi/dmapi.h&gt;</h2><a name="#include &lt;dmapi/dmapi_kern.h&gt;"></a><h2>#include &lt;dmapi/dmapi_kern.h&gt;</h2><a name="#include &lt;dmapi/dmapi_lib.h&gt;"></a><h2>#include &lt;dmapi/dmapi_lib.h&gt;</h2><a name="int dmi (int opcode, ...);"></a><h2>int dmi (int opcode, ...);</h2><a name="DESCRIPTION"></a><h2>DESCRIPTION</h2><p style="margin-left: 18%"><font size=3><I>dmi</I></font> <font size=3>is a system interface used to implement the interface defined in the X/Open document:</font> <font size=3><B>Systems Management: Data Storage Management (XDSM) API</B></font> <font size=3>dated February 1997. This interface is made available on Silicon Graphics systems by means of the</font> <font size=3><B>libdm</B></font> <font size=3>library.</font></p>
<p style="margin-left: 18%"><font size=3>The value of the</font> <font size=3><I>opcode</I></font> <font size=3>parameter determines the meaning of the remaining arguments. These are all interfaces that are used to implement various</font> <font size=3><I>libdm</I></font> <font size=3>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:</font></p>
<a name="DM_CLEAR_INHERIT"></a><h2>DM_CLEAR_INHERIT</h2><a name="DM_CREATE_BY_HANDLE"></a><h2>DM_CREATE_BY_HANDLE</h2><a name="DM_CREATE_SESSION"></a><h2>DM_CREATE_SESSION</h2><a name="DM_CREATE_USEREVENT"></a><h2>DM_CREATE_USEREVENT</h2><a name="DM_DESTROY_SESSION"></a><h2>DM_DESTROY_SESSION</h2><a name="DM_DOWNGRADE_RIGHT"></a><h2>DM_DOWNGRADE_RIGHT</h2><a name="DM_FD_TO_HANDLE"></a><h2>DM_FD_TO_HANDLE</h2><a name="DM_FIND_EVENTMSG"></a><h2>DM_FIND_EVENTMSG</h2><a name="DM_GET_ALLOCINFO"></a><h2>DM_GET_ALLOCINFO</h2><a name="DM_GET_BULKALL"></a><h2>DM_GET_BULKALL</h2><a name="DM_GET_BULKATTR"></a><h2>DM_GET_BULKATTR</h2><a name="DM_GET_CONFIG"></a><h2>DM_GET_CONFIG</h2><a name="DM_GET_CONFIG_EVENTS"></a><h2>DM_GET_CONFIG_EVENTS</h2><a name="DM_GET_DIOINFO"></a><h2>DM_GET_DIOINFO</h2><a name="DM_GET_DIRATTRS"></a><h2>DM_GET_DIRATTRS</h2><a name="DM_GET_DMATTR"></a><h2>DM_GET_DMATTR</h2><a name="DM_GET_EVENTLIST"></a><h2>DM_GET_EVENTLIST</h2><a name="DM_GET_EVENTS"></a><h2>DM_GET_EVENTS</h2><a name="DM_GET_FILEATTR"></a><h2>DM_GET_FILEATTR</h2><a name="DM_GET_MOUNTINFO"></a><h2>DM_GET_MOUNTINFO</h2><a name="DM_GET_REGION"></a><h2>DM_GET_REGION</h2><a name="DM_GETALL_DISP"></a><h2>DM_GETALL_DISP</h2><a name="DM_GETALL_DMATTR"></a><h2>DM_GETALL_DMATTR</h2><a name="DM_GETALL_INHERIT"></a><h2>DM_GETALL_INHERIT</h2><a name="DM_GETALL_SESSIONS"></a><h2>DM_GETALL_SESSIONS</h2><a name="DM_GETALL_TOKENS"></a><h2>DM_GETALL_TOKENS</h2><a name="DM_INIT_ATTRLOC"></a><h2>DM_INIT_ATTRLOC</h2><a name="DM_MKDIR_BY_HANDLE"></a><h2>DM_MKDIR_BY_HANDLE</h2><a name="DM_MOVE_EVENT"></a><h2>DM_MOVE_EVENT</h2><a name="DM_OBJ_REF_HOLD"></a><h2>DM_OBJ_REF_HOLD</h2><a name="DM_OBJ_REF_QUERY"></a><h2>DM_OBJ_REF_QUERY</h2><a name="DM_OBJ_REF_RELE"></a><h2>DM_OBJ_REF_RELE</h2><a name="DM_PATH_TO_FSHANDLE"></a><h2>DM_PATH_TO_FSHANDLE</h2><a name="DM_PATH_TO_HANDLE"></a><h2>DM_PATH_TO_HANDLE</h2><a name="DM_PENDING"></a><h2>DM_PENDING</h2><a name="DM_PROBE_HOLE"></a><h2>DM_PROBE_HOLE</h2><a name="DM_PUNCH_HOLE"></a><h2>DM_PUNCH_HOLE</h2><a name="DM_QUERY_RIGHT"></a><h2>DM_QUERY_RIGHT</h2><a name="DM_QUERY_SESSION"></a><h2>DM_QUERY_SESSION</h2><a name="DM_READ_INVIS"></a><h2>DM_READ_INVIS</h2><a name="DM_RELEASE_RIGHT"></a><h2>DM_RELEASE_RIGHT</h2><a name="DM_REMOVE_DMATTR"></a><h2>DM_REMOVE_DMATTR</h2><a name="DM_REQUEST_RIGHT"></a><h2>DM_REQUEST_RIGHT</h2><a name="DM_RESPOND_EVENT"></a><h2>DM_RESPOND_EVENT</h2><a name="DM_SEND_MSG"></a><h2>DM_SEND_MSG</h2>
<!-- Page: 2  -->
<!-- left  margin: 220 -->
<!-- right margin: 750 -->
<a name="DM_SET_DISP"></a><h2>DM_SET_DISP</h2><a name="DM_SET_DMATTR"></a><h2>DM_SET_DMATTR</h2><a name="DM_SET_EVENTLIST"></a><h2>DM_SET_EVENTLIST</h2><a name="DM_SET_FILEATTR"></a><h2>DM_SET_FILEATTR</h2><a name="DM_SET_INHERIT"></a><h2>DM_SET_INHERIT</h2><a name="DM_SET_REGION"></a><h2>DM_SET_REGION</h2><a name="DM_SET_RETURN_ON_DESTROY"></a><h2>DM_SET_RETURN_ON_DESTROY</h2><a name="DM_SYMLINK_BY_HANDLE"></a><h2>DM_SYMLINK_BY_HANDLE</h2><a name="DM_SYNC_BY_HANDLE"></a><h2>DM_SYNC_BY_HANDLE</h2><a name="DM_UPGRADE_RIGHT"></a><h2>DM_UPGRADE_RIGHT</h2><a name="DM_WRITE_INVIS"></a><h2>DM_WRITE_INVIS</h2><a name="ERRORS"></a><h2>ERRORS</h2><p style="margin-left: 18%"><font size=3>The following error codes may be returned by</font> <font size=3><I>dmi</I></font><font size=3>:</font></p>
<p style="margin-left: 18%"><font size=3>[EFAULT] A buffer is referenced which is not in a valid part of the calling program's<br>
<span style=" text-indent: 11%;"></span>address space.</font></p>
<p style="margin-left: 18%"><font size=3>[EPERM] The effective user ID is not superuser.</font></p>
<p style="margin-left: 18%"><font size=3>[EINVAL] An invalid parameter or parameter combination was specified.</font></p>
<a name="DIAGNOSTICS"></a><h2>DIAGNOSTICS</h2><p style="margin-left: 18%"><font size=3>Upon successful completion, a command dependent value (default of zero) is returned. Otherwise, a value of -1 is returned and</font> <font size=3><I>errno</I></font> <font size=3>is set to indicate the error.</font><br>
</p>
</body>
</html>