NAME

       ioctl_xfs_goingdown - shut down an XFS filesystem

SYNOPSIS

       #include <xfs/xfs_fs.h>

       int ioctl(int fd, XFS_IOC_GOINGDOWN, uint32_t flags);

DESCRIPTION

       Shuts  down  a  live  XFS  filesystem.   This is a software initiated hard shutdown and should be avoided
       whenever possible.  After this  call  completes,  the  filesystem  ill  be  totally  unusable  until  the
       filesystem has been unmounted and remounted.

       flags can be one of the following:

           XFS_FSOP_GOING_FLAGS_DEFAULT
                  Flush  all  dirty  data  and metadata to disk, flush pending transactions to the log, and shut
                  down.

           XFS_FSOP_GOING_FLAGS_LOGFLUSH
                  Flush all pending metadata transactions to the log and  shut  down,  leaving  all  dirty  data
                  unwritten.

           XFS_FSOP_GOING_FLAGS_NOLOGFLUSH
                  Shut down immediately, without writing pending transactions or dirty data to disk.

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.

       EIO    An I/O error was encountered while performing the query.

       EPERM  Caller did not have permission to shut down the filesystem.

CONFORMING TO

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

SEE ALSO

       ioctl(2)

XFS                                                2019-06-17                             IOCTL-XFS-GOINGDOWN(2)