Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_AP_QUERY_CKPT (3)

Library Functions

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
NOTES
RETURN VALUES
ERRORS
EXAMPLES
SEE ALSO

NAME

vxfs_ap_query_ckpt - return information about allocation policies assigned to a Storage Checkpoint

SYNOPSIS

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

-l vxfsutil -ldl

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_ap_query_ckpt(int fd, char *ckptname, char *datapol, char *metapol);

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_ap_query_ckpt() retrieves information about the Storage Checkpoint allocation policies assigned to the given Storage Checkpoint. The datapol and metapol arguments must point to buffers of (FSAP_NAMESZ + 1) bytes, which are filled in with the name of the policy (if any) and NULL-terminated. If no policy is assigned, the string "NONE" is returned. datapol is the name of the data policy that can be created with fsapadm(1M) or through the vxfs_ap_defined() API. metapol is the name of the metadata policy that can be created with fsapadm(1M) or through the vxfs_ap_define() API. The file descriptor fd specifies a file within the Storage Checkpoint.

To use this function, specify -l vxfsutil while linking.

NOTES

This function is supported only on Version 6 and later disk layouts. This API supports file system versions 6.0 and above.

RETURN VALUES

vxfs_ap_query_ckpt() returns zero on success, non-zero on failure.

ERRORS

EAGAIN: The file system is not currently frozen.
EFAULT: One or more of the specified pointer arguments points to an illegal address.
EFBIG: An was made to reserve space larger than the maximum file size for this process.
EINVAL: The command or argument is invalid.
EIO: An I/O error occurred during the operation.
ENOENT: One or more of the named policies does not exist.
ENOSYS: There is no license installed to allow this operation.
ENOTSUP: This operation is not supported by the disk layout version of the specified file system. Use vxupgrade(1M) to enable this operation.
ENXIO: There is no such device or address.
EPERM: The effective user ID of the calling process does not have appropriate privileges to perform this operation.

EXAMPLES

To query a Storage Checkpoint for its assigned policies:

# vxfs_ap_query_ckpt(fd, checkpoint_name data_policy, meta_policy);

vxfs_ap_assign_ckpt(3), vxfs_ap_assign_file(3), vxfs_ap_assign_fs(3), vxfs_ap_define(3), vxfs_ap_define2(3), vxfs_ap_remove(3), vxfs_ap_enforce_ckpt(3), .. vxfs_ap_enforce_file(3), vxfs_ap_enforce_file2(3), vxfs_ap_enumerate(3), vxfs_ap_query(3), vxfs_ap_query2(3), vxfs_ap_query_file(3), vxfs_ap_query_fs(3), vxfs_vol_add(3), vxfs_vol_deencapsulate(3), vxfs_vol_encapsulate(3), vxfs_vol_enumerate(3), vxfs_vol_remove(3), vxfs_vol_resize(3), vxfs_vol_stat(3)

VXFS_AP_QUERY_CKPT (3)

Table of contents