ioctl_xfs_goingdown(2)

ioctl_xfs_goingdown2

Shut down an xfs filesystem

Usage

#include <xfs/xfs_fs.h>

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

Overview

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.

Releases

Unchanged in 4 releases since Debian 11 (Bullseye).

  1. 11–Arch

Conforming to

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

From xfsprogs 7.2.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.