Following are usage restrictions on DMAPI functions in the GPFS implementation. For additional semantic changes to DMAPI functions in GPFS, see "Semantic changes to DMAPI functions".
If a token is presented, these functions fail with the EINVAL error code.
If a file system handle is presented, these functions fail with the EINVAL error code.
For dm_get_bulkattr and dm_get_bulkall, the system file must be mounted on the node that is making the call. For the other functions, the file system must be mounted on some node, but not necessarily on the node that is making the call. As specified previously, all such function calls must use DM_NO_TOKEN. The function fails with the EBADF error code if the file system is not mounted as required.