# ioctl_xfs_rtgroup_geometry

## NAME



           ioctl_xfs_rtgroup_geometry - query XFS realtime group geometry
           information
    


## SYNOPSIS



           **#include <xfs/xfs_fs.h>**
    
           **int ioctl(int** _fd_**, XFS_IOC_RTGROUP_GEOMETRY, struct**
           **xfs_rtgroup_geometry ***_arg_**);**
    


## DESCRIPTION



           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_ and _rg_pad_
                  All reserved fields will be set to zero on return.
    
           The fields _rg_sick_ and _rg_checked_ indicate the relative health of
           various realtime group metadata:
    
           • If a given sick flag is set in _rg_sick_ , then that piece of
             metadata has been observed to be damaged.  The same bit will be
             set in _rg_checked_.
    
           • If a given sick flag is set in _rg_checked_ and is not set in
             _rg_sick_ , then that piece of metadata has been checked and is not
             faulty.
    
           • If a given sick flag is not set in _rg_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.
    


## RETURN VALUE



           On error, -1 is returned, and _errno_ is set to indicate the error.
    


## ERRORS



           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.
    
           **EINVAL** The specified realtime group number is not valid for this
                  filesystem.
    
           **EIO** An I/O error was encountered while performing the query.
    


## CONFORMING TO



           This API is specific to XFS filesystem on the Linux kernel.
    


* * *