vxfs_ap_query_file_pat (3)

NAME

vxfs_ap_query_file_pat - list the pattern table of a directory

SYNOPSIS

For 32-bit applications:

cc -I /opt/VRTS/include -L /opt/VRTS/lib

-l vxfsutil -ldl

For 64-bit applications:

cc -I /opt/VRTS/include -L /opt/VRTS/lib/64

-l vxfsutil -ldld

For both applications:

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_ap_query_file_pat(int fd, struct fsap_pattern_table **pat_query, uint32_t flags);

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_ap_query_file_pat() returns the pattern tables of a directory specified by fd.

The fd field is the file descriptor of the mount point’s directory.

On a successful return, the following fields are filled:
pt_flags Contains the flags of the pattern table.
pt_num Contains the number of pattern entries.
pt_data Points to an array of fsap_pattern_entry structures.
To use this function, specify -l vxfsutil while linking. Specify the /opt/VRTSfssdk/5.0/lib directory for 32-bit executables, or the /opt/VRTSfssdk/5.0/lib/64 directory for 64-bit executables.

If the LIBVXFSUTIL_DLL_PATH environment variable is defined, it should be set to the name of the vxfsutil.so file, such as ~/mylib/vxfsutil.so. If undefined, this variable is assumed to point to the 32-bit and 64-bit vxfsutil.so files, /opt/VRTSvxfs/lib/vxfsutil.so and /opt/VRTSvxfs/lib/64/vxfsutil.so, respectively.

NOTES

This API supports file system versions 6.0 and above.

FLAGS

The flags argument is currently unused.

RETURN VALUES

vxfs_ap_query_file_pat() returns zero on success, and pat_query points to a newly allocated structure that is filled with pattern information. The caller must free the pat_query field by calling the LIBC free() function. vxfs_ap_query_file_pat() returns non-zero on failure.

ERRORS

ENXIO An I/O error occurred during the operation.
ENOTDIR The fd field does not point to a directory.
ENOSYS No appropriate licenses are installed.

SEE ALSO

vxfs_ap_assign_file_pat(3)


VxFS 5.1 SP1 vxfs_ap_query_file_pat (3)