/*
 * SPDX-License-Identifier: BSD-2-Clause
 *
 * Copyright (c) 2025-2026 The FreeBSD Foundation
 * Copyright (c) 2025-2026 Jean-Sébastien Pédron <dumbbell@FreeBSD.org>
 *
 * This software was developed by Jean-Sébastien Pédron under sponsorship
 * from the FreeBSD Foundation.
 */

#ifndef _LINUXKPI_LINUX_KMSG_DUMP_H_
#define _LINUXKPI_LINUX_KMSG_DUMP_H_

#include <linux/errno.h>
#include <linux/list.h>

#include <linux/kernel.h> /* For pr_debug() */

enum kmsg_dump_reason {
        KMSG_DUMP_UNDEF,
        KMSG_DUMP_PANIC,
        KMSG_DUMP_OOPS,
        KMSG_DUMP_EMERG,
        KMSG_DUMP_SHUTDOWN,
        KMSG_DUMP_MAX
};

struct kmsg_dump_iter {
        uint64_t        cur_seq;
        uint64_t        next_seq;
};

struct kmsg_dumper {
        struct list_head list;
        void (*dump)(struct kmsg_dumper *dumper, enum kmsg_dump_reason reason);
        enum kmsg_dump_reason max_reason;
        bool registered;
};

static inline void
kmsg_dump(enum kmsg_dump_reason reason)
{
        pr_debug("TODO");
}

static inline bool
kmsg_dump_get_line(struct kmsg_dump_iter *iter, bool syslog,
    const char *line, size_t size, size_t *len)
{
        pr_debug("TODO");

        return (false);
}

static inline bool
kmsg_dump_get_buffer(struct kmsg_dump_iter *iter, bool syslog,
    char *buf, size_t size, size_t *len)
{
        pr_debug("TODO");

        return (false);
}

static inline void
kmsg_dump_rewind(struct kmsg_dump_iter *iter)
{
        pr_debug("TODO");
}

static inline int
kmsg_dump_register(struct kmsg_dumper *dumper)
{
        pr_debug("TODO");

        return (-EINVAL);
}

static inline int
kmsg_dump_unregister(struct kmsg_dumper *dumper)
{
        pr_debug("TODO");

        return (-EINVAL);
}

static inline const char *
kmsg_dump_reason_str(enum kmsg_dump_reason reason)
{
        pr_debug("TODO");

        return ("Unknown");
}
#endif