ioctl_xfs_health_fd_on_monitored_fs(2) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | CONFORMING TO | SEE ALSO | COLOPHON

IOCTL-XFS...NITORED-FS(2)  System Calls Manual  IOCTL-XFS...NITORED-FS(2)

NAME         top

       ioctl_xfs_health_fd_on_monitored_fs - check if the given fd
       belongs to the same fs being monitored

SYNOPSIS         top

       #include <xfs/xfs_fs.h>

       int ioctl(int healthmon_fd, XFS_IOC_HEALTH_FD_ON_MONITORED_FS,
       struct xfs_health_file_on_monitored_fs *arg);

DESCRIPTION         top

       This XFS healthmon fd ioctl asks the kernel driver if the file
       descriptor passed in via arg points to a file on the same
       filesystem that is being monitored by healthmon_fd.  The file
       descriptor is conveyed in a structure of the following form:

           struct xfs_health_file_on_monitored_fs {
                __s32 fd;
                __u32 flags;
           };

       The field flags must be zero.

       The field fd is a descriptor of an open file.

       The argument healthmon_fd must be a file opened via the
       XFS_IOC_HEALTH_MONITOR ioctl.

RETURN VALUE         top

       On error, -1 is returned, and errno is set to indicate the error.
       If the file descriptor points to a file on the same filesystem
       that is being monitored, 0 is returned.

ERRORS         top

       Error codes can be one of, but are not limited to, the following:

       ESTALE The open file is not on the same filesystem that is being
              monitored.

       EINVAL One or more of the arguments specified is invalid.

       EBADF  arg.fd does not refer to an open file.

       EFAULT The arg structure could not be copied into the kernel.

       ENOTTY healthmon_fd is not a XFS health monitoring file.

CONFORMING TO         top

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

SEE ALSO         top

       ioctl_xfs_health_monitor(2)

COLOPHON         top

       This page is part of the xfsprogs (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
       2026-05-24.  (At that time, the date of the most recent commit
       that was found in the repository was 2026-05-19.)  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 is not part of the original manual page), send a
       mail to man-pages@man7.org

XFS                             2026-01-04      IOCTL-XFS...NITORED-FS(2)

Pages that refer to this page: ioctl_xfs_health_monitor(2)