common/rc: factor out _scratch_xfs_[get|set]_sb_field
[xfstests-dev.git] / dmapi / src / suite2 / README_for_check_dmapi
1 ###  README for check_dmapi  ###
2
3 check_dmapi tests the version of DMAPI library & kernel code.
4
5 command line:  check_dmapi [-v] 
6 (v is a verbose-output flag)
7
8 Functionality:
9
10 1) Ensures that the user is running as root, using getuid().  
11
12 2) Tries to stat() /usr/include/sys/dmi.h to verify its
13    presence and its size.
14
15 3) Verifies the presence of the DMAPI kernel, using a 
16    direct call to dmi().  The call is invalid, so it should
17    return EINVAL if the kernel code is in place, ENOPKG if not.
18
19 4) Determines the status of the kernel (if it is present) using
20    a direct call to dmi().  The call is invalid, and uses an opcode
21    not present in the old kernel.  So ENOSYS means old kernel;
22    EINVAL means new kernel.
23
24 5) Determines the status of the library by calling dm_init_service().
25    If this fails, libraries are missing.  In the old library, this call
26    did not change its "name" parameter, but in the new library it does.
27    Same name means old library; changed name means new library. 
28
29 6) Outputs its findings.