sys/fs/fuse/fuse_internal.h

   1 /*-
   2  * SPDX-License-Identifier: BSD-3-Clause
   3  *
   4  * Copyright (c) 2007-2009 Google Inc. and Amit Singh
   5  * All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions are
   9  * met:
  10  *
  11  * * Redistributions of source code must retain the above copyright
  12  *   notice, this list of conditions and the following disclaimer.
  13  * * Redistributions in binary form must reproduce the above
  14  *   copyright notice, this list of conditions and the following disclaimer
  15  *   in the documentation and/or other materials provided with the
  16  *   distribution.
  17  * * Neither the name of Google Inc. nor the names of its
  18  *   contributors may be used to endorse or promote products derived from
  19  *   this software without specific prior written permission.
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  22  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  23  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  24  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  25  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  26  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  27  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  28  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  29  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  30  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  31  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32  *
  33  * Copyright (C) 2005 Csaba Henk.
  34  * All rights reserved.
  35  *
  36  * Redistribution and use in source and binary forms, with or without
  37  * modification, are permitted provided that the following conditions
  38  * are met:
  39  * 1. Redistributions of source code must retain the above copyright
  40  *    notice, this list of conditions and the following disclaimer.
  41  * 2. Redistributions in binary form must reproduce the above copyright
  42  *    notice, this list of conditions and the following disclaimer in the
  43  *    documentation and/or other materials provided with the distribution.
  44  *
  45  * THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  46  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  47  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  48  * ARE DISCLAIMED.  IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
  49  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  50  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  51  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  52  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  53  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  54  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  55  * SUCH DAMAGE.
  56  *
  57  * $FreeBSD$
  58  */
  59
  60 #ifndef _FUSE_INTERNAL_H_
  61 #define _FUSE_INTERNAL_H_
  62
  63 #include <sys/types.h>
  64 #include <sys/uio.h>
  65 #include <sys/stat.h>
  66 #include <sys/vnode.h>
  67
  68 #include "fuse_ipc.h"
  69 #include "fuse_node.h"
  70
  71 static inline bool
  72 vfs_isrdonly(struct mount *mp)
  73 {
  74         return ((mp->mnt_flag & MNT_RDONLY) != 0);
  75 }
  76
  77 static inline struct mount *
  78 vnode_mount(struct vnode *vp)
  79 {
  80         return (vp->v_mount);
  81 }
  82
  83 static inline enum vtype
  84 vnode_vtype(struct vnode *vp)
  85 {
  86         return (vp->v_type);
  87 }
  88
  89 static inline bool
  90 vnode_isvroot(struct vnode *vp)
  91 {
  92         return ((vp->v_vflag & VV_ROOT) != 0);
  93 }
  94
  95 static inline bool
  96 vnode_isreg(struct vnode *vp)
  97 {
  98         return (vp->v_type == VREG);
  99 }
 100
 101 static inline bool
 102 vnode_isdir(struct vnode *vp)
 103 {
 104         return (vp->v_type == VDIR);
 105 }
 106
 107 static inline bool
 108 vnode_islnk(struct vnode *vp)
 109 {
 110         return (vp->v_type == VLNK);
 111 }
 112
 113 static inline ssize_t
 114 uio_resid(struct uio *uio)
 115 {
 116         return (uio->uio_resid);
 117 }
 118
 119 static inline off_t
 120 uio_offset(struct uio *uio)
 121 {
 122         return (uio->uio_offset);
 123 }
 124
 125 static inline void
 126 uio_setoffset(struct uio *uio, off_t offset)
 127 {
 128         uio->uio_offset = offset;
 129 }
 130
 131 /* miscellaneous */
 132
 133 static inline bool
 134 fuse_isdeadfs(struct vnode *vp)
 135 {
 136         struct fuse_data *data = fuse_get_mpdata(vnode_mount(vp));
 137
 138         return (data->dataflags & FSESS_DEAD);
 139 }
 140
 141 static inline uint64_t
 142 fuse_iosize(struct vnode *vp)
 143 {
 144         return (vp->v_mount->mnt_stat.f_iosize);
 145 }
 146
 147 /*
 148  * Make a cacheable timeout in bintime format value based on a fuse_attr_out
 149  * response
 150  */
 151 static inline void
 152 fuse_validity_2_bintime(uint64_t attr_valid, uint32_t attr_valid_nsec,
 153         struct bintime *timeout)
 154 {
 155         struct timespec now, duration, timeout_ts;
 156
 157         getnanouptime(&now);
 158         /* "+ 2" is the bound of attr_valid_nsec + now.tv_nsec */
 159         /* Why oh why isn't there a TIME_MAX defined? */
 160         if (attr_valid >= INT_MAX || attr_valid + now.tv_sec + 2 >= INT_MAX) {
 161                 timeout->sec = INT_MAX;
 162         } else {
 163                 duration.tv_sec = attr_valid;
 164                 duration.tv_nsec = attr_valid_nsec;
 165                 timespecadd(&duration, &now, &timeout_ts);
 166                 timespec2bintime(&timeout_ts, timeout);
 167         }
 168 }
 169
 170 /*
 171  * Make a cacheable timeout value in timespec format based on the fuse_entry_out
 172  * response
 173  */
 174 static inline void
 175 fuse_validity_2_timespec(const struct fuse_entry_out *feo,
 176         struct timespec *timeout)
 177 {
 178         struct timespec duration, now;
 179
 180         getnanouptime(&now);
 181         /* "+ 2" is the bound of entry_valid_nsec + now.tv_nsec */
 182         if (feo->entry_valid >= INT_MAX ||
 183             feo->entry_valid + now.tv_sec + 2 >= INT_MAX) {
 184                 timeout->tv_sec = INT_MAX;
 185         } else {
 186                 duration.tv_sec = feo->entry_valid;
 187                 duration.tv_nsec = feo->entry_valid_nsec;
 188                 timespecadd(&duration, &now, timeout);
 189         }
 190 }
 191
 192
 193 /* access */
 194 static inline int
 195 fuse_match_cred(struct ucred *basecred, struct ucred *usercred)
 196 {
 197         if (basecred->cr_uid == usercred->cr_uid             &&
 198             basecred->cr_uid == usercred->cr_ruid            &&
 199             basecred->cr_uid == usercred->cr_svuid           &&
 200             basecred->cr_groups[0] == usercred->cr_groups[0] &&
 201             basecred->cr_groups[0] == usercred->cr_rgid      &&
 202             basecred->cr_groups[0] == usercred->cr_svgid)
 203                 return (0);
 204
 205         return (EPERM);
 206 }
 207
 208 int fuse_internal_access(struct vnode *vp, accmode_t mode,
 209     struct thread *td, struct ucred *cred);
 210
 211 /* attributes */
 212 void fuse_internal_cache_attrs(struct vnode *vp, struct fuse_attr *attr,
 213         uint64_t attr_valid, uint32_t attr_valid_nsec, struct vattr *vap);
 214
 215 /* fsync */
 216
 217 int fuse_internal_fsync(struct vnode *vp, struct thread *td, int waitfor,
 218         bool datasync);
 219 int fuse_internal_fsync_callback(struct fuse_ticket *tick, struct uio *uio);
 220
 221 /* getattr */
 222 int fuse_internal_getattr(struct vnode *vp, struct vattr *vap,
 223         struct ucred *cred, struct thread *td);
 224
 225 /* readdir */
 226
 227 struct pseudo_dirent {
 228         uint32_t d_namlen;
 229 };
 230
 231 /* mknod */
 232 int fuse_internal_mknod(struct vnode *dvp, struct vnode **vpp,
 233         struct componentname *cnp, struct vattr *vap);
 234
 235 /* readdir */
 236 int fuse_internal_readdir(struct vnode *vp, struct uio *uio,
 237     struct fuse_filehandle *fufh, struct fuse_iov *cookediov);
 238 int fuse_internal_readdir_processdata(struct uio *uio, size_t reqsize,
 239     void *buf, size_t bufsize, void *param);
 240
 241 /* remove */
 242
 243 int fuse_internal_remove(struct vnode *dvp, struct vnode *vp,
 244     struct componentname *cnp, enum fuse_opcode op);
 245
 246 /* rename */
 247
 248 int fuse_internal_rename(struct vnode *fdvp, struct componentname *fcnp,
 249     struct vnode *tdvp, struct componentname *tcnp);
 250
 251 /* revoke */
 252
 253 void fuse_internal_vnode_disappear(struct vnode *vp);
 254
 255 /* setattr */
 256 int fuse_internal_setattr(struct vnode *vp, struct vattr *va,
 257         struct thread *td, struct ucred *cred);
 258
 259 /* strategy */
 260
 261 /* entity creation */
 262
 263 static inline int
 264 fuse_internal_checkentry(struct fuse_entry_out *feo, enum vtype vtyp)
 265 {
 266         if (vtyp != IFTOVT(feo->attr.mode)) {
 267                 return (EINVAL);
 268         }
 269
 270         if (feo->nodeid == FUSE_NULL_ID) {
 271                 return (EINVAL);
 272         }
 273
 274         if (feo->nodeid == FUSE_ROOT_ID) {
 275                 return (EINVAL);
 276         }
 277
 278         return (0);
 279 }
 280
 281 int fuse_internal_newentry(struct vnode *dvp, struct vnode **vpp,
 282     struct componentname *cnp, enum fuse_opcode op, void *buf, size_t bufsize,
 283     enum vtype vtyp);
 284
 285 void fuse_internal_newentry_makerequest(struct mount *mp, uint64_t dnid,
 286     struct componentname *cnp, enum fuse_opcode op, void *buf, size_t bufsize,
 287     struct fuse_dispatcher *fdip);
 288
 289 int fuse_internal_newentry_core(struct vnode *dvp, struct vnode **vpp,
 290     struct componentname *cnp, enum vtype vtyp, struct fuse_dispatcher *fdip);
 291
 292 /* entity destruction */
 293
 294 int fuse_internal_forget_callback(struct fuse_ticket *tick, struct uio *uio);
 295 void fuse_internal_forget_send(struct mount *mp, struct thread *td,
 296     struct ucred *cred, uint64_t nodeid, uint64_t nlookup);
 297
 298 /* fuse start/stop */
 299
 300 int fuse_internal_init_callback(struct fuse_ticket *tick, struct uio *uio);
 301 void fuse_internal_send_init(struct fuse_data *data, struct thread *td);
 302
 303 #endif /* _FUSE_INTERNAL_H_ */