« SORT Documents < Previous  | TOC | Index | Next  >

vxfs_ap_query_fs_pat

NAME

vxfs_ap_query_fs_pat - list the file system-wide pattern table

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/sparcv9
-l vxfsutil -ldl

For both applications:

#include <sys/types.h>

#include <vxfsutil.h>

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

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_ap_query_fs_pat() returns the file system-wide pattern tables.

The fd field is the file descriptor of the directory.

The output of the pat_query field is freed by the caller. 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/VRTSvxfs/lib directory for 32-bit executables, or the /opt/VRTSvxfs/lib/sparcv9 directory for 64-bit executables.

NOTES

This API supports file system versions 6.0 and above.

FLAGS

The flags argument is currently unused.

RETURN VALUES

vxfs_ap_query_fs_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 by calling the LIBC free() function. vxfs_ap_query_fs_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.

ENOTSYS

No appropriate licenses are installed.

SEE ALSO

vxfs_ap_assign_fs_pat(3)