Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_VOL_ENUMERATE (3)

Library Functions

Table of contents


NAME

vxfs_vol_enumerate - return information about the volumes within a multi-volume file system

SYNOPSIS

cc -I /opt/VRTS/include -L /opt/VRTS/lib
-l vxfsutil -ldl

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_vol_enumerate(int fd, int *countp, struct fsdev_info *infop);


AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_vol_enumerate() fills in the array of fsdev_info structures with information on the component volumes in a file system.

The file descriptor fd must be the mount point of the file system. Upon entry, *countp must contain the number of structures in the array pointed to by infop. On return, *countp is updated with the number of records that were filled in. If the error E2BIG is returned, *countp contains the minimum number of records necessary for the call to succeed.


RETURN VALUES

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

ERRORS

E2BIG
The amount of data to return is too large to fit in the specified array.
EINVAL
The number of structures specified by fname is not correct.
ENOENT
The specified array does not exist.
ENOMEM
Memory could not be allocated to support the API.
ENOTSUP
This operation is not supported by the disk layout version of the specified file system. Use vxupgrade(1M) to enable this operation.
ERANGE
The result was too large.

SEE ALSO

vxfs_ap_assign_ckpt(3), vxfs_ap_assign_file(3), vxfs_ap_assign_fs(3), vxfs_ap_define(3), vxfs_ap_remove(3), vxfs_ap_enforce_ckpt(3), .. vxfs_ap_enforce_file(3), vxfs_ap_enumerate(3), vxfs_ap_query(3), vxfs_ap_query_ckpt(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_remove(3), vxfs_vol_resize(3), vxfs_vol_stat(3)

Last updated: 7 May 2007
Copyright ©2009 Symantec Corporation
All rights reserved.