IOCTL-XFS-GOINGDOWN(2) System Calls Manual IOCTL-XFS-GOINGDOWN(2)

# [NAME](#NAME)

ioctl\_xfs\_goingdown - shut down an XFS filesystem

# [SYNOPSIS](#SYNOPSIS)

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

**int ioctl(int fd, XFS\_IOC\_GOINGDOWN, uint32\_t flags);**

# [DESCRIPTION](#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**](#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**](#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**](#XFS_FSOP_GOING_FLAGS_NOLOGFLUSH)

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

# [RETURN VALUE](#RETURN_VALUE)

On error, -1 is returned, and *errno* is set to indicate the error.

# [ERRORS](#ERRORS)

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

[**EFSBADCRC**](#EFSBADCRC)

Metadata checksum validation failed while performing the query.

[**EFSCORRUPTED**](#EFSCORRUPTED)

Metadata corruption was encountered while performing the query.

[**EIO**](#EIO)

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

[**EPERM**](#EPERM)

Caller did not have permission to shut down the filesystem.

# [CONFORMING TO](#CONFORMING_TO)

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

# [SEE ALSO](#SEE_ALSO)

[**ioctl**(2)](/man/enterprise-packages/xfsprogs-5.10/ioctl.2)

2019-06-17 XFS

---

Document: ioctl_xfs_goingdown(2) from xfsprogs-5.10 5.10.0-r48 (Chainguard OS)
Source: https://kernel.googlesource.com/pub/scm/fs/xfs/xfsprogs-dev