/* $NetBSD: genfs_node.h,v 1.25 2025/12/25 09:08:28 nia Exp $ */

/*
 * Copyright (c) 2001 Chuck Silvers.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. The name of the author may not be used to endorse or promote products
 *    derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef _MISCFS_GENFS_GENFS_NODE_H_
#define _MISCFS_GENFS_GENFS_NODE_H_

#include <sys/rwlock.h>

struct vm_page;
struct kauth_cred;
struct uio;
struct vnode;

struct genfs_ops {
        void    (*gop_size)(struct vnode *, off_t, off_t *, int);
        int     (*gop_alloc)(struct vnode *, off_t, off_t, int,
            struct kauth_cred *);
        int     (*gop_write)(struct vnode *, struct vm_page **, int, int);
        void    (*gop_markupdate)(struct vnode *, int);
        void    (*gop_putrange)(struct vnode *, off_t, off_t *, off_t *);
};

#define GOP_SIZE(vp, size, eobp, flags) \
        (*VTOG(vp)->g_op->gop_size)((vp), (size), (eobp), (flags))
#define GOP_ALLOC(vp, off, len, flags, cred) \
        (*VTOG(vp)->g_op->gop_alloc)((vp), (off), (len), (flags), (cred))
#define GOP_WRITE(vp, pgs, npages, flags) \
        (*VTOG(vp)->g_op->gop_write)((vp), (pgs), (npages), (flags))
#define GOP_PUTRANGE(vp, off, lop, hip) \
        (*VTOG(vp)->g_op->gop_putrange)((vp), (off), (lop), (hip))

/*
 * GOP_MARKUPDATE: mark vnode's timestamps for update.
 *
 * => called with vmobjlock (and possibly other locks) held.
 * => used for accesses via mmap.
 */

#define GOP_MARKUPDATE(vp, flags) \
        (VTOG(vp)->g_op->gop_markupdate) ? \
        (*VTOG(vp)->g_op->gop_markupdate)((vp), (flags)) : \
        (void)0;

/* Flags to GOP_SIZE */
#define GOP_SIZE_MEM    0x4     /* in-memory size */

/* Flags to GOP_MARKUPDATE */
#define GOP_UPDATE_ACCESSED     1
#define GOP_UPDATE_MODIFIED     2

struct genfs_node {
        const struct genfs_ops  *g_op;          /* ops vector */
        krwlock_t               g_glock;        /* getpages lock */
};

#define VTOG(vp) ((struct genfs_node *)(vp)->v_data)

void    genfs_size(struct vnode *, off_t, off_t *, int);
void    genfs_node_init(struct vnode *, const struct genfs_ops *);
void    genfs_node_destroy(struct vnode *);
void    genfs_gop_putrange(struct vnode *, off_t, off_t *, off_t *);
int     genfs_gop_write(struct vnode *, struct vm_page **, int, int);
int     genfs_gop_write_rwmap(struct vnode *, struct vm_page **, int, int);
int     genfs_compat_gop_write(struct vnode *, struct vm_page **, int, int);
void    genfs_directio(struct vnode *, struct uio *, int);

void    genfs_node_wrlock(struct vnode *);
void    genfs_node_rdlock(struct vnode *);
int     genfs_node_rdtrylock(struct vnode *);
void    genfs_node_unlock(struct vnode *);
int     genfs_node_wrlocked(struct vnode *);

#endif  /* _MISCFS_GENFS_GENFS_NODE_H_ */