---
name: "ioctl_xfs_fscounts"
section: "2"
platform: "linux"
package: "xfsprogs"
version: "7.2.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/ioctl_xfs_fscounts"
---

# ioctl\_xfs\_fscounts(2)

query XFS summary counter information

## NAME

ioctl\_xfs\_fscounts - query XFS summary counter information

## SYNOPSIS

**#include \<xfs/xfs\_fs.h\>**

**int ioctl(int** *fd***, XFS\_IOC\_FSCOUNTS, struct xfs\_fsop\_counts \****arg***);**

## DESCRIPTION

Query the raw filesystem summary counters. Unlike [**statvfs**(3)](/statvfs/3.md), the values returned here are the raw values, which do not reflect any alterations or limits set by project quotas. The counter information is conveyed in a structure of the following form:

```
struct xfs_fsop_counts {
	__u64   freedata;
	__u64   freertx;
	__u64   freeino;
	__u64   allocino;
};
```

The fields of this structure are as follows:

*freedata* is the number of free filesystem blocks on the data device.

*freertx* is the number of free extents on the realtime device.

*freeino* is the number of inode records that are not in use within the space that has been allocated for them.

*allocino* is the number of inode records for which space has been allocated.

## 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 allocation 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.

## SEE ALSO

[**ioctl**(2)](/ioctl/2.md)