/*-
 * SPDX-License-Identifier: BSD-3-Clause
 *
 * Copyright (c) 1989, 1993, 1995
 *      The Regents of the University of California.  All rights reserved.
 *
 * This code is derived from software contributed to Berkeley by
 * Rick Macklem at The University of Guelph.
 *
 * 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. Neither the name of the University nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``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 REGENTS OR CONTRIBUTORS 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 _NFSCLIENT_NFS_H_
#define _NFSCLIENT_NFS_H_

#ifdef _KERNEL
#include "opt_nfs.h"
#endif

#include <nfsclient/nfsargs.h>

/*
 * Tunable constants for nfs
 */

#define NFS_TICKINTVL   10              /* Desired time for a tick (msec) */
#define NFS_HZ          (hz / nfs_ticks) /* Ticks/sec */
#define NFS_TIMEO       (1 * NFS_HZ)    /* Default timeout = 1 second */
#define NFS_MINTIMEO    (1 * NFS_HZ)    /* Min timeout to use */
#define NFS_MAXTIMEO    (60 * NFS_HZ)   /* Max timeout to backoff to */
#define NFS_MINIDEMTIMEO (5 * NFS_HZ)   /* Min timeout for non-idempotent ops*/
#define NFS_MAXREXMIT   100             /* Stop counting after this many */
#define NFS_RETRANS     10              /* Num of retrans for UDP soft mounts */
#define NFS_RETRANS_TCP 2               /* Num of retrans for TCP soft mounts */
#define NFS_MAXGRPS     16              /* Max. size of groups list */
#ifndef NFS_MINATTRTIMO
#define NFS_MINATTRTIMO 3               /* VREG attrib cache timeout in sec */
#endif
#ifndef NFS_MAXATTRTIMO
#define NFS_MAXATTRTIMO 60
#endif
#ifndef NFS_MINDIRATTRTIMO
#define NFS_MINDIRATTRTIMO 3            /* VDIR attrib cache timeout in sec */
#endif
#ifndef NFS_MAXDIRATTRTIMO
#define NFS_MAXDIRATTRTIMO 60
#endif
#ifndef NFS_ACCESSCACHESIZE
#define NFS_ACCESSCACHESIZE 8           /* Per-node access cache entries */
#endif
#define NFS_WSIZE       8192            /* Def. write data size <= 8192 */
#define NFS_RSIZE       8192            /* Def. read data size <= 8192 */
#define NFS_READDIRSIZE 8192            /* Def. readdir size */
#define NFS_DEFRAHEAD   1               /* Def. read ahead # blocks */
#define NFS_MAXRAHEAD   4               /* Max. read ahead # blocks */
#define NFS_MAXASYNCDAEMON      64      /* Max. number async_daemons runnable */
#define NFS_DIRBLKSIZ   4096            /* Must be a multiple of DIRBLKSIZ */
#ifdef _KERNEL
#define DIRBLKSIZ       512             /* XXX we used to use ufs's DIRBLKSIZ */
#endif
#define NFS_MAXDEADTHRESH       9       /* How long till we say 'server not responding' */

/*
 * Oddballs
 */
#define NFS_CMPFH(n, f, s) \
        ((n)->n_fhsize == (s) && !bcmp((caddr_t)(n)->n_fhp, (caddr_t)(f), (s)))
#define NFS_ISV3(v)     (VFSTONFS((v)->v_mount)->nm_flag & NFSMNT_NFSV3)
#define NFS_ISV4(v)     (VFSTONFS((v)->v_mount)->nm_flag & NFSMNT_NFSV4)

#define NFSSTA_HASWRITEVERF     0x00040000  /* Has write verifier for V3 */
#define NFSSTA_GOTFSINFO        0x00100000  /* Got the V3 fsinfo */
#define NFSSTA_SNDLOCK          0x01000000  /* Send socket lock */
#define NFSSTA_WANTSND          0x02000000  /* Want above */
#define NFSSTA_TIMEO            0x10000000  /* Experiencing a timeout */
#define NFSSTA_LOCKTIMEO        0x20000000  /* Experiencing a lockd timeout */

/*
 * XXX to allow amd to include nfs.h without nfsproto.h
 */
#ifdef NFS_NPROCS
#include <nfsclient/nfsstats.h>
#endif

/*
 * vfs.oldnfs sysctl(3) identifiers
 */
#define NFS_NFSSTATS    1               /* struct: struct nfsstats */

#ifdef _KERNEL

#ifdef MALLOC_DECLARE
MALLOC_DECLARE(M_NFSDIROFF);
MALLOC_DECLARE(M_NFSDIRECTIO);
#endif

extern struct uma_zone *nfsmount_zone;

extern struct nfsstats nfsstats;
extern struct mtx nfs_iod_mtx;
extern struct task nfs_nfsiodnew_task;

extern int nfs_numasync;
extern unsigned int nfs_iodmax;
extern int nfs_pbuf_freecnt;
extern int nfs_ticks;

/* Data constants in XDR form */
extern u_int32_t nfs_true, nfs_false, nfs_xdrneg1;
extern u_int32_t rpc_reply, rpc_msgdenied, rpc_mismatch, rpc_vers;
extern u_int32_t rpc_auth_unix, rpc_msgaccepted, rpc_call, rpc_autherr;

extern int nfsv3_procid[NFS_NPROCS];

/*
 * Socket errors ignored for connectionless sockets??
 * For now, ignore them all
 */
#define NFSIGNORE_SOERROR(s, e) \
                ((e) != EINTR && (e) != EIO && \
                (e) != ERESTART && (e) != EWOULDBLOCK && \
                ((s) & PR_CONNREQUIRED) == 0)

struct nfsmount;

struct buf;
struct socket;
struct uio;
struct vattr;

/*
 * Pointers to ops that differ from v3 to v4
 */
struct nfs_rpcops {
        int     (*nr_readrpc)(struct vnode *vp, struct uio *uiop,
                    struct ucred *cred);
        int     (*nr_writerpc)(struct vnode *vp, struct uio *uiop,
                    struct ucred *cred, int *iomode, int *must_commit);
        int     (*nr_writebp)(struct buf *bp, int force, struct thread *td);
        int     (*nr_readlinkrpc)(struct vnode *vp, struct uio *uiop,
                    struct ucred *cred);
        void    (*nr_invaldir)(struct vnode *vp);
        int     (*nr_commit)(struct vnode *vp, u_quad_t offset, int cnt,
                    struct ucred *cred, struct thread *td);
};

/*
 * Defines for WebNFS
 */

#define WEBNFS_ESC_CHAR         '%'
#define WEBNFS_SPECCHAR_START   0x80

#define WEBNFS_NATIVE_CHAR      0x80
/*
 * ..
 * Possibly more here in the future.
 */

/*
 * Macro for converting escape characters in WebNFS pathnames.
 * Should really be in libkern.
 */

#define HEXTOC(c) \
        ((c) >= 'a' ? ((c) - ('a' - 10)) : \
            ((c) >= 'A' ? ((c) - ('A' - 10)) : ((c) - '0')))
#define HEXSTRTOI(p) \
        ((HEXTOC(p[0]) << 4) + HEXTOC(p[1]))

/* nfs_sigintr() helper, when 'rep' has all we need */
#define NFS_SIGREP(rep)         nfs_sigintr((rep)->r_nmp, (rep), (rep)->r_td)

#ifdef NFS_DEBUG

extern int nfs_debug;
#define NFS_DEBUG_ASYNCIO       1 /* asynchronous i/o */
#define NFS_DEBUG_WG            2 /* server write gathering */
#define NFS_DEBUG_RC            4 /* server request caching */

#define NFS_DPF(cat, args)                                      \
        do {                                                    \
                if (nfs_debug & NFS_DEBUG_##cat) printf args;   \
        } while (0)

#else

#define NFS_DPF(cat, args)

#endif

/*
 * On fast networks, the estimator will try to reduce the
 * timeout lower than the latency of the server's disks,
 * which results in too many timeouts, so cap the lower
 * bound.
 */
#define NFS_MINRTO      (NFS_HZ >> 2)

/*
 * Keep the RTO from increasing to unreasonably large values
 * when a server is not responding.
 */
#define NFS_MAXRTO      (20 * NFS_HZ)

enum nfs_rto_timer_t {
        NFS_DEFAULT_TIMER,
        NFS_GETATTR_TIMER,
        NFS_LOOKUP_TIMER,
        NFS_READ_TIMER,
        NFS_WRITE_TIMER,
};
#define NFS_MAX_TIMER   (NFS_WRITE_TIMER)

#define NFS_INITRTT     (NFS_HZ << 3)

vfs_init_t nfs_init;
vfs_uninit_t nfs_uninit;
int     nfs_mountroot(struct mount *mp);

void    nfs_purgecache(struct vnode *);
int     nfs_vinvalbuf(struct vnode *, int, struct thread *, int);
int     nfs_readrpc(struct vnode *, struct uio *, struct ucred *);
int     nfs_writerpc(struct vnode *, struct uio *, struct ucred *, int *,
            int *);
int     nfs_commit(struct vnode *vp, u_quad_t offset, int cnt,
            struct ucred *cred, struct thread *td);
int     nfs_readdirrpc(struct vnode *, struct uio *, struct ucred *);
void    nfs_nfsiodnew(void);
void    nfs_nfsiodnew_tq(__unused void *, int);
int     nfs_asyncio(struct nfsmount *, struct buf *, struct ucred *, struct thread *);
int     nfs_doio(struct vnode *, struct buf *, struct ucred *, struct thread *);
void    nfs_doio_directwrite (struct buf *);
int     nfs_readlinkrpc(struct vnode *, struct uio *, struct ucred *);
int     nfs_sigintr(struct nfsmount *, struct thread *);
int     nfs_readdirplusrpc(struct vnode *, struct uio *, struct ucred *);
int     nfs_request(struct vnode *, struct mbuf *, int, struct thread *,
            struct ucred *, struct mbuf **, struct mbuf **, caddr_t *);
int     nfs_loadattrcache(struct vnode **, struct mbuf **, caddr_t *,
            struct vattr *, int);
int     nfsm_mbuftouio(struct mbuf **, struct uio *, int, caddr_t *);
void    nfs_nhinit(void);
void    nfs_nhuninit(void);
int     nfs_nmcancelreqs(struct nfsmount *);
void    nfs_timer(void*);

int     nfs_connect(struct nfsmount *);
void    nfs_disconnect(struct nfsmount *);
void    nfs_safedisconnect(struct nfsmount *);
int     nfs_getattrcache(struct vnode *, struct vattr *);
int     nfs_iosize(struct nfsmount *nmp);
int     nfsm_strtmbuf(struct mbuf **, char **, const char *, long);
int     nfs_bioread(struct vnode *, struct uio *, int, struct ucred *);
int     nfsm_uiotombuf(struct uio *, struct mbuf **, int, caddr_t *);
void    nfs_clearcommit(struct mount *);
int     nfs_writebp(struct buf *, int, struct thread *);
int     nfs_fsinfo(struct nfsmount *, struct vnode *, struct ucred *,
            struct thread *);
int     nfs_meta_setsize (struct vnode *, struct ucred *,
            struct thread *, u_quad_t);

void    nfs_set_sigmask(struct thread *td, sigset_t *oldset);
void    nfs_restore_sigmask(struct thread *td, sigset_t *set);
int     nfs_msleep(struct thread *td, void *ident, struct mtx *mtx,
            int priority, char *wmesg, int timo);

#endif  /* _KERNEL */

#endif