/*      $NetBSD: cnode.h,v 1.21 2024/05/17 23:56:24 thorpej Exp $       */

/*
*
*             Coda: an Experimental Distributed File System
*                              Release 3.1
*
*           Copyright (c) 1987-1998 Carnegie Mellon University
*                          All Rights Reserved
*
* Permission  to  use, copy, modify and distribute this software and its
* documentation is hereby granted,  provided  that  both  the  copyright
* notice  and  this  permission  notice  appear  in  all  copies  of the
* software, derivative works or  modified  versions,  and  any  portions
* thereof, and that both notices appear in supporting documentation, and
* that credit is given to Carnegie Mellon University  in  all  documents
* and publicity pertaining to direct or indirect use of this code or its
* derivatives.
*
* CODA IS AN EXPERIMENTAL SOFTWARE SYSTEM AND IS  KNOWN  TO  HAVE  BUGS,
* SOME  OF  WHICH MAY HAVE SERIOUS CONSEQUENCES.  CARNEGIE MELLON ALLOWS
* FREE USE OF THIS SOFTWARE IN ITS "AS IS" CONDITION.   CARNEGIE  MELLON
* DISCLAIMS  ANY  LIABILITY  OF  ANY  KIND  FOR  ANY  DAMAGES WHATSOEVER
* RESULTING DIRECTLY OR INDIRECTLY FROM THE USE OF THIS SOFTWARE  OR  OF
* ANY DERIVATIVE WORK.
*
* Carnegie  Mellon  encourages  users  of  this  software  to return any
* improvements or extensions that  they  make,  and  to  grant  Carnegie
* Mellon the rights to redistribute these changes without encumbrance.
*
*      @(#) coda/cnode.h,v 1.1.1.1 1998/08/29 21:26:46 rvb Exp $
*/

/*
* Mach Operating System
* Copyright (c) 1990 Carnegie-Mellon University
* Copyright (c) 1989 Carnegie-Mellon University
* All rights reserved.  The CMU software License Agreement specifies
* the terms and conditions for use and redistribution.
*/

/*
* This code was written for the Coda file system at Carnegie Mellon University.
* Contributers include David Steere, James Kistler, and M. Satyanarayanan.
*/

#ifndef _CNODE_H_
#define _CNODE_H_

#include <sys/vnode.h>
#ifdef _KERNEL
#include <sys/malloc.h>

MALLOC_DECLARE(M_CODA);
#endif

/*
* Cnode lookup stuff.
* NOTE: CODA_CACHESIZE must be a power of 2 for cfshash to work!
*/
#define CODA_CACHESIZE 512

#define CODA_ALLOC(ptr, cast, size)                                        \
do {                                                                      \
   ptr = (cast)malloc((unsigned long) size, M_CODA, M_WAITOK);            \
   if (ptr == 0) {                                                       \
       panic("kernel malloc returns 0 at %s:%d\n", __FILE__, __LINE__);  \
   }                                                                     \
} while (/*CONSTCOND*/ 0)

#define CODA_FREE(ptr, size)  free((ptr), M_CODA)

/*
* global cache state control
*/
extern int coda_nc_use;

/*
* Used to select debugging statements throughout the cfs code.
*/
extern int codadebug;
extern int coda_nc_debug;
extern int coda_printf_delay;
extern int coda_vnop_print_entry;
extern int coda_psdev_print_entry;
extern int coda_vfsop_print_entry;

#define CODADBGMSK(N)            (1 << N)
#define CODADEBUG(N, STMT)       { if (codadebug & CODADBGMSK(N)) { STMT } }
#define myprintf(args)          \
do {                            \
   if (coda_printf_delay)       \
       DELAY(coda_printf_delay);\
   printf args ;               \
} while (/*CONSTCOND*/ 0)

struct cnode {
   struct vnode        *c_vnode;
   u_short              c_flags;       /* flags (see below) */
   CodaFid              c_fid;         /* file handle */
   struct vnode        *c_ovp;         /* open vnode pointer */
   u_short              c_ocount;      /* count of openers */
   u_short              c_owrite;      /* count of open for write */
   struct vattr         c_vattr;       /* attributes */
   char                *c_symlink;     /* pointer to symbolic link */
   u_short              c_symlen;      /* length of symbolic link */
   dev_t                c_device;      /* associated vnode device */
   ino_t                c_inode;       /* associated vnode inode */
   kmutex_t             c_lock;
};
#define VTOC(vp)        ((struct cnode *)(vp)->v_data)
#define SET_VTOC(vp)    ((vp)->v_data)
#define CTOV(cp)        ((struct vnode *)((cp)->c_vnode))

/* flags */
#define C_VATTR         0x01    /* Validity of vattr in the cnode */
#define C_SYMLINK       0x02    /* Validity of symlink pointer in the Code */
#define C_UNMOUNTING    0X20    /* Set if unmounting */
#define C_PURGING       0x40    /* Set if purging a fid */

#define VALID_VATTR(cp)         ((cp->c_flags) & C_VATTR)
#define VALID_SYMLINK(cp)       ((cp->c_flags) & C_SYMLINK)
#define IS_UNMOUNTING(cp)       ((cp)->c_flags & C_UNMOUNTING)

struct vmsg;

struct vcomm {
       u_long                  vc_seq;
       int                     vc_open;
       struct selinfo          vc_selproc;
       TAILQ_HEAD(,vmsg)       vc_requests;
       TAILQ_HEAD(,vmsg)       vc_replies;
};

#define VC_OPEN(vcp)            ((vcp)->vc_open == 1)
#define MARK_VC_CLOSED(vcp)     ((vcp)->vc_open = 0)
#define MARK_VC_OPEN(vcp)       ((vcp)->vc_open = 1)

struct coda_clstat {
       int     ncalls;                 /* client requests */
       int     nbadcalls;              /* upcall failures */
       int     reqs[CODA_NCALLS];      /* count of each request */
};
extern struct coda_clstat coda_clstat;

/*
* CODA structure to hold mount/file system information
*/
struct coda_mntinfo {
   struct vnode        *mi_rootvp;
   struct mount        *mi_vfsp;
   struct vcomm         mi_vcomm;
   int                  mi_started;
};
extern struct coda_mntinfo coda_mnttbl[]; /* indexed by minor device number */

/*
* vfs pointer to mount info
*/
#define vftomi(vfsp)    ((struct coda_mntinfo *)(vfsp->mnt_data))
#define CODA_MOUNTED(vfsp)   ((vftomi(vfsp) != (struct coda_mntinfo *)0) \
       && (vftomi(vfsp)->mi_started))

/*
* vnode pointer to mount info
*/
#define vtomi(vp)       ((struct coda_mntinfo *)(vp->v_mount->mnt_data))

/*
* Used for identifying usage of "Control" object
*/
extern struct vnode *coda_ctlvp;
#define IS_CTL_VP(vp)           ((vp) == coda_ctlvp)
#define IS_CTL_NAME(vp, name, l)((l == CODA_CONTROLLEN) \
                                && ((vp) == vtomi((vp))->mi_rootvp)    \
                                && strncmp(name, CODA_CONTROL, l) == 0)

/*
* An enum to tell us whether something that will remove a reference
* to a cnode was a downcall or not
*/
enum dc_status {
   IS_DOWNCALL = 6,
   NOT_DOWNCALL = 7
};

/* cfs_psdev.h */
extern int coda_call(struct coda_mntinfo *, int, int *, void *);
extern int coda_kernel_version;

/* cfs_subr.h */
extern int  handleDownCall(int, union outputArgs *);
extern void coda_unmounting(struct mount *);
extern int  coda_vmflush(struct cnode *);

/* cfs_vnodeops.h */
extern struct cnode *make_coda_node(CodaFid *, struct mount *, short);
extern int coda_vnodeopstats_init(void);

/* coda_vfsops.h */
extern struct mount *devtomp(dev_t);

/* sigh */
#define CODA_RDWR ((u_long) 31)

#endif  /* _CNODE_H_ */