root/include/linux/fserror.h
/* SPDX-License-Identifier: GPL-2.0-or-later */
/*
 * Copyright (c) 2025 Oracle.  All Rights Reserved.
 * Author: Darrick J. Wong <djwong@kernel.org>
 */
#ifndef _LINUX_FSERROR_H__
#define _LINUX_FSERROR_H__

void fserror_mount(struct super_block *sb);
void fserror_unmount(struct super_block *sb);

enum fserror_type {
        /* pagecache I/O failed */
        FSERR_BUFFERED_READ,
        FSERR_BUFFERED_WRITE,

        /* direct I/O failed */
        FSERR_DIRECTIO_READ,
        FSERR_DIRECTIO_WRITE,

        /* out of band media error reported */
        FSERR_DATA_LOST,

        /* filesystem metadata */
        FSERR_METADATA,
};

struct fserror_event {
        struct work_struct work;
        struct super_block *sb;
        struct inode *inode;
        loff_t pos;
        u64 len;
        enum fserror_type type;

        /* negative error number */
        int error;
};

void fserror_report(struct super_block *sb, struct inode *inode,
                    enum fserror_type type, loff_t pos, u64 len, int error,
                    gfp_t gfp);

static inline void fserror_report_io(struct inode *inode,
                                     enum fserror_type type, loff_t pos,
                                     u64 len, int error, gfp_t gfp)
{
        fserror_report(inode->i_sb, inode, type, pos, len, error, gfp);
}

static inline void fserror_report_data_lost(struct inode *inode, loff_t pos,
                                            u64 len, gfp_t gfp)
{
        fserror_report(inode->i_sb, inode, FSERR_DATA_LOST, pos, len, -EIO,
                       gfp);
}

static inline void fserror_report_file_metadata(struct inode *inode, int error,
                                                gfp_t gfp)
{
        fserror_report(inode->i_sb, inode, FSERR_METADATA, 0, 0, error, gfp);
}

static inline void fserror_report_metadata(struct super_block *sb, int error,
                                           gfp_t gfp)
{
        fserror_report(sb, NULL, FSERR_METADATA, 0, 0, error, gfp);
}

static inline void fserror_report_shutdown(struct super_block *sb, gfp_t gfp)
{
        fserror_report(sb, NULL, FSERR_METADATA, 0, 0, -ESHUTDOWN, gfp);
}

#endif /* _LINUX_FSERROR_H__ */