---
name: "ioctl_xfs_goingdown"
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_goingdown"
---

# ioctl\_xfs\_goingdown(2)

shut down an XFS filesystem

## 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)](/ioctl/2.md)