| ============================== |
| AUXILIARY PROGRAMS FOR TESTING |
| ============================== |
| |
| Not everything a test script can do is easily done within a test script; |
| sometimes it makes a lot more sense to write auxiliary program in C and have |
| the test script call them. Auxiliary commands can be found in the src/ |
| directory and in other packages. |
| |
| Tests wanting to use an auxiliary program found in the src/ directory should |
| note the dependency with: |
| |
| _require_test_program "<program-name>" |
| |
| |
| Contents: |
| |
| - af_unix -- Create an AF_UNIX socket |
| - open_by_handle -- open_by_handle_at syscall exercise |
| - stat_test -- statx syscall exercise |
| - t_dir_type -- print directory entries and their file type |
| - xfs_io -- General I/O operation exercise |
| |
| |
| ================== |
| QUICK DESCRIPTIONS |
| ================== |
| |
| af_unix |
| |
| The af_unix program creates an AF_UNIX socket at the given location. |
| |
| open_by_handle |
| |
| The open_by_handle program exercises the open_by_handle_at() system |
| call. It can check if file handles are valid or stale after certain |
| filesystem operations. |
| |
| See also: |
| _require_exportfs |
| |
| stat_test |
| |
| The stat_test program is primarily designed to exercise the statx() |
| system call. It can check statx() against fstatat() and it can |
| compare and check various file attributes. |
| |
| See also: |
| _require_statx |
| |
| |
| t_dir_type |
| |
| The t_dir_type program exercises the getdents64() system call. |
| It prints directory entry names returned from getdents64() and |
| thier d_type, optionally filtered by type or by inode number. |
| |
| xfs_io |
| |
| The xfs_io program can be found in the xfsprogs package and can be used |
| to perform sequences of I/O commands, though it is limited to what it |
| can do on open files. |
| |
| xfs_io is a debugging tool that is aimed at examining regular file I/O |
| paths rather than a raw XFS volume itself. These code paths include |
| not only the obvious read/write/mmap interfaces for manipulating files, |
| but also cover all of the XFS extensions (such as space preallocation, |
| additional inode flags, etc). |
| |
| Most of its commands can also be used with other filesystems. |
| |
| See also: |
| _require_xfs_io_command |