diff options
author | Darrick J. Wong <darrick.wong@oracle.com> | 2019-09-09 15:37:08 -0400 |
---|---|---|
committer | Eric Sandeen <sandeen@redhat.com> | 2019-09-09 15:37:08 -0400 |
commit | e2fd97fcb673b07a86ab1a745ceecd6cf1ffa602 (patch) | |
tree | 0d65969457e242e971be6599dc548e1caf40e6b4 | |
parent | 88537f078f8b1f5f22799896ea8dc7f1a09fdb22 (diff) | |
download | xfsprogs-dev-e2fd97fcb673b07a86ab1a745ceecd6cf1ffa602.tar.gz |
man: document the new allocation group geometry ioctl
Document the new ioctl to describe an allocation group's geometry.
Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
Reviewed-by: Eric Sandeen <sandeen@redhat.com>
Signed-off-by: Eric Sandeen <sandeen@sandeen.net>
-rw-r--r-- | man/man2/ioctl_xfs_ag_geometry.2 | 82 | ||||
-rw-r--r-- | man/man3/xfsctl.3 | 6 |
2 files changed, 88 insertions, 0 deletions
diff --git a/man/man2/ioctl_xfs_ag_geometry.2 b/man/man2/ioctl_xfs_ag_geometry.2 new file mode 100644 index 0000000000..ddd5426507 --- /dev/null +++ b/man/man2/ioctl_xfs_ag_geometry.2 @@ -0,0 +1,82 @@ +.\" Copyright (c) 2019, Oracle. All rights reserved. +.\" +.\" %%%LICENSE_START(GPLv2+_DOC_FULL) +.\" SPDX-License-Identifier: GPL-2.0+ +.\" %%%LICENSE_END +.TH IOCTL-XFS-AG-GEOMETRY 2 2019-08-30 "XFS" +.SH NAME +ioctl_xfs_ag_geometry \- query XFS allocation group geometry information +.SH SYNOPSIS +.br +.B #include <xfs/xfs_fs.h> +.PP +.BI "int ioctl(int " fd ", XFS_IOC_AG_GEOMETRY, struct xfs_ag_geometry *" arg ); +.SH DESCRIPTION +This XFS ioctl retrieves the geometry information for a given allocation group. +The geometry information is conveyed in a structure of the following form: +.PP +.in +4n +.nf +struct xfs_ag_geometry { + uint32_t ag_number; + uint32_t ag_length; + uint32_t ag_freeblks; + uint32_t ag_icount; + uint32_t ag_ifree; + uint32_t ag_sick; + uint32_t ag_checked; + uint32_t ag_flags; + uint64_t ag_reserved[12]; +}; +.fi +.in +.TP +.I ag_number +The caller must set this field to the index of the allocation group that the +caller wishes to learn about. +.TP +.I ag_length +The length of the allocation group is returned in this field, in units of +filesystem blocks. +.TP +.I ag_freeblks +The number of free blocks in the allocation group is returned in this field, in +units of filesystem blocks. +.TP +.I ag_icount +The number of inode records allocated in this allocation group is returned in +this field. +.TP +.I ag_ifree +The number of unused inode records (of the space allocated) in this allocation +group is returned in this field. +.TP +.I ag_flags +The caller can set this field to change the operational behavior of the ioctl. +Currently no flags are defined, so this field must be zero. +.TP +.IR ag_reserved +All reserved fields will be set to zero on return. +.SH RETURN VALUE +On error, \-1 is returned, and +.I errno +is set to indicate the error. +.PP +.SH ERRORS +Error codes can be one of, but are not limited to, the following: +.TP +.B EFSBADCRC +Metadata checksum validation failed while performing the query. +.TP +.B EFSCORRUPTED +Metadata corruption was encountered while performing the query. +.TP +.B EINVAL +The specified allocation group number is not valid for this filesystem. +.TP +.B EIO +An I/O error was encountered while performing the query. +.SH CONFORMING TO +This API is specific to XFS filesystem on the Linux kernel. +.SH SEE ALSO +.BR ioctl (2) diff --git a/man/man3/xfsctl.3 b/man/man3/xfsctl.3 index 7e6588b8f9..dfebd12d9b 100644 --- a/man/man3/xfsctl.3 +++ b/man/man3/xfsctl.3 @@ -337,6 +337,12 @@ See for more information. .TP +.B XFS_IOC_AG_GEOMETRY +See +.BR ioctl_xfs_ag_geometry (2) +for more information. + +.TP .BR XFS_IOC_FSBULKSTAT " or " XFS_IOC_FSBULKSTAT_SINGLE See .BR ioctl_xfs_fsbulkstat (2) |