HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH. |  |
NAME |SYNOPSIS |DESCRIPTION |RETURN VALUE |ERRORS |CONFORMING TO |SEE ALSO |COLOPHON | |
IOCTL-XFS-...P-GEOMETRY(2) System Calls ManualIOCTL-XFS-...P-GEOMETRY(2)ioctl_xfs_rtgroup_geometry - query XFS realtime group geometry information
#include <xfs/xfs_fs.h>int ioctl(intfd, XFS_IOC_RTGROUP_GEOMETRY, structxfs_rtgroup_geometry *arg);
This XFS ioctl retrieves the geometry information for a given realtime group. The geometry information is conveyed in a structure of the following form: struct xfs_rtgroup_geometry { __u32 rg_number; __u32 rg_length; __u32 rg_sick; __u32 rg_checked; __u32 rg_flags; __u32 rg_reserved[27]; };rg_number The caller must set this field to the index of the realtime group that the caller wishes to learn about.rg_length The length of the realtime group is returned in this field, in units of filesystem blocks.rg_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.rg_reserved andrg_pad All reserved fields will be set to zero on return. The fieldsrg_sick andrg_checked indicate the relative health of various realtime group metadata: • If a given sick flag is set inrg_sick, then that piece of metadata has been observed to be damaged. The same bit will be set inrg_checked. • If a given sick flag is set inrg_checked and is not set inrg_sick, then that piece of metadata has been checked and is not faulty. • If a given sick flag is not set inrg_checked, then no conclusion can be made. The following flags apply to these fields:XFS_RTGROUP_GEOM_SICK_SUPER Realtime group superblock.XFS_RTGROUP_GEOM_SICK_BITMAP Realtime bitmap for this group.XFS_RTGROUP_GEOM_SICK_SUMMARY Realtime summary for this group.XFS_RTGROUP_GEOM_SICK_RTRMAPBT Reverse mapping btree for this group.On error, -1 is returned, anderrno is set to indicate the error.
Error codes can be one of, but are not limited to, the following:EFSBADCRC Metadata checksum validation failed while performing the query.EFSCORRUPTED Metadata corruption was encountered while performing the query.EINVALThe specified realtime group number is not valid for this filesystem.EIOAn I/O error was encountered while performing the query.
This API is specific to XFS filesystem on the Linux kernel.
ioctl(2)
This page is part of thexfsprogs (utilities for XFS filesystems) project. Information about the project can be found at ⟨http://xfs.org/⟩. If you have a bug report for this manual page, send it to linux-xfs@vger.kernel.org. This page was obtained from the project's upstream Git repository ⟨https://git.kernel.org/pub/scm/fs/xfs/xfsprogs-dev.git⟩ on 2025-08-11. (At that time, the date of the most recent commit that was found in the repository was 2025-06-23.) If you discover any rendering problems in this HTML version of the page, or you believe there is a better or more up-to-date source for the page, or you have corrections or improvements to the information in this COLOPHON (which isnot part of the original manual page), send a mail to man-pages@man7.orgXFS 2022-08-18IOCTL-XFS-...P-GEOMETRY(2)Copyright and license for this manual page
HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH. | |