Mandatory functions implemented in DMAPI for GPFS
These mandatory functions, as defined in the System Management: Data Storage Management (XDSM) API Common Applications Environment (CAE) Specification C429, The Open Group, ISBN 1-85912-190-X, are implemented in DMAPI for GPFS.
For C declarations of all the mandatory functions implemented in DMAPI for GPFS, refer to the dmapi.h file located in the /usr/lpp/mmfs/include directory. However, for a quick description of the mandatory functions and their applications, refer to the following set of functions:
- dm_create_session
- Create a new session.
- dm_create_userevent
- Create a pseudo-event message for a user.
- dm_destroy_session
- Destroy an existing session.
- dm_fd_to_handle
- Create a file handle using a file descriptor.
- dm_find_eventmsg
- Return the message for an event.
- dm_get_allocinfo
- Get a file's current allocation information.
- dm_get_bulkattr
- Get bulk attributes of a file system.
- dm_get_config
- Get specific data on DMAPI implementation.
- dm_get_config_events
- List all events supported by the DMAPI implementation.
- dm_get_dirattrs
- Return a directory's bulk attributes.
- dm_get_eventlist
- Return a list of an object's enabled events.
- dm_get_events
- Return the next available event messages.
- dm_get_fileattr
- Get file attributes.
- dm_get_mountinfo
- Return details from a mount event.
- dm_get_region
- Get a file's managed regions.
- dm_getall_disp
- For a given session, return the disposition of all file system's events.
- dm_getall_sessions
- Return all extant sessions.
- dm_getall_tokens
- Return a session's outstanding tokens.
- dm_handle_cmp
- Compare file handles.
- dm_handle_free
- Free a handle's storage.
- dm_handle_hash
- Hash the contents of a handle.
- dm_handle_is_valid
- Check a handle's validity.
- dm_handle_to_fshandle
- Return the file system handle associated with an object handle.
- dm_handle_to_path
- Return a path name from a file system handle.
- dm_init_attrloc
- Initialize a bulk attribute location offset.
- dm_init_service
- Initialization processing that is implementation-specific.
- dm_move_event
- Move an event from one session to another.
- dm_path_to_fshandle
- Create a file system handle using a path name.
- dm_path_to_handle
- Create a file handle using a path name.
- dm_query_right
- Determine an object's access rights.
- dm_query_session
- Query a session.
- dm_read_invis
- Read a file without using DMAPI events.
- dm_release_right
- Release an object's access rights.
- dm_request_right
- Request an object's access rights.
- dm_respond_event
- Issue a response to an event.
- dm_send_msg
- Send a message to a session.
- dm_set_disp
- For a given session, set the disposition of all file system's events.
- dm_set_eventlist
- For a given object, set the list of events to be enabled.
- dm_set_fileattr
- Set a file's time stamps, ownership and mode.
- dm_set_region
- Set a file's managed regions.
- dm_write_invis
- Write to a file without using DMAPI events.