xref: /qemu/fsdev/file-op-9p.h (revision e0bd743b)
1 /*
2  * 9p
3  *
4  * Copyright IBM, Corp. 2010
5  *
6  * Authors:
7  *  Aneesh Kumar K.V <aneesh.kumar@linux.vnet.ibm.com>
8  *
9  * This work is licensed under the terms of the GNU GPL, version 2.  See
10  * the COPYING file in the top-level directory.
11  *
12  */
13 
14 #ifndef FILE_OP_9P_H
15 #define FILE_OP_9P_H
16 
17 #include <dirent.h>
18 #include <utime.h>
19 #include "qemu-fsdev-throttle.h"
20 #include "p9array.h"
21 
22 #ifdef CONFIG_LINUX
23 # include <sys/vfs.h>
24 #endif
25 #ifdef CONFIG_DARWIN
26 # include <sys/param.h>
27 # include <sys/mount.h>
28 #endif
29 
30 #define SM_LOCAL_MODE_BITS    0600
31 #define SM_LOCAL_DIR_MODE_BITS    0700
32 
33 typedef struct FsCred {
34     uid_t   fc_uid;
35     gid_t   fc_gid;
36     mode_t  fc_mode;
37     dev_t   fc_rdev;
38 } FsCred;
39 
40 typedef struct FsContext FsContext;
41 typedef struct V9fsPath V9fsPath;
42 
43 typedef struct ExtendedOps {
44     int (*get_st_gen)(FsContext *, V9fsPath *, mode_t, uint64_t *);
45 } ExtendedOps;
46 
47 /* export flags */
48 #define V9FS_IMMEDIATE_WRITEOUT     0x00000001
49 #define V9FS_PATHNAME_FSCONTEXT     0x00000002
50 /*
51  * uid/gid set on fileserver files
52  */
53 #define V9FS_SM_PASSTHROUGH         0x00000004
54 /*
55  * uid/gid part of xattr
56  */
57 #define V9FS_SM_MAPPED              0x00000008
58 /*
59  * Server will try to set uid/gid.
60  * On failure ignore the error.
61  */
62 #define V9FS_SM_NONE                0x00000010
63 /*
64  * uid/gid part of .virtfs_meatadata namespace
65  */
66 #define V9FS_SM_MAPPED_FILE         0x00000020
67 #define V9FS_RDONLY                 0x00000040
68 #define V9FS_PROXY_SOCK_FD          0x00000080
69 #define V9FS_PROXY_SOCK_NAME        0x00000100
70 /*
71  * multidevs option (either one of the two applies exclusively)
72  */
73 #define V9FS_REMAP_INODES           0x00000200
74 #define V9FS_FORBID_MULTIDEVS       0x00000400
75 /*
76  * Disables certain performance warnings from being logged on host side.
77  */
78 #define V9FS_NO_PERF_WARN           0x00000800
79 
80 #define V9FS_SEC_MASK               0x0000003C
81 
82 
83 typedef struct FileOperations FileOperations;
84 typedef struct XattrOperations XattrOperations;
85 
86 /*
87  * Structure to store the various fsdev's passed through command line.
88  */
89 typedef struct FsDriverEntry {
90     char *fsdev_id;
91     char *path;
92     int export_flags;
93     FileOperations *ops;
94     FsThrottle fst;
95     mode_t fmode;
96     mode_t dmode;
97 } FsDriverEntry;
98 
99 struct FsContext {
100     uid_t uid;
101     char *fs_root;
102     int export_flags;
103     XattrOperations **xops;
104     ExtendedOps exops;
105     FsThrottle *fst;
106     /* fs driver specific data */
107     void *private;
108     mode_t fmode;
109     mode_t dmode;
110 };
111 
112 struct V9fsPath {
113     uint16_t size;
114     char *data;
115 };
116 P9ARRAY_DECLARE_TYPE(V9fsPath);
117 
118 typedef union V9fsFidOpenState V9fsFidOpenState;
119 
120 void cred_init(FsCred *);
121 
122 struct FileOperations {
123     int (*parse_opts)(QemuOpts *, FsDriverEntry *, Error **errp);
124     int (*init)(FsContext *, Error **errp);
125     void (*cleanup)(FsContext *);
126     int (*lstat)(FsContext *, V9fsPath *, struct stat *);
127     ssize_t (*readlink)(FsContext *, V9fsPath *, char *, size_t);
128     int (*chmod)(FsContext *, V9fsPath *, FsCred *);
129     int (*chown)(FsContext *, V9fsPath *, FsCred *);
130     int (*mknod)(FsContext *, V9fsPath *, const char *, FsCred *);
131     int (*utimensat)(FsContext *, V9fsPath *, const struct timespec *);
132     int (*remove)(FsContext *, const char *);
133     int (*symlink)(FsContext *, const char *, V9fsPath *,
134                    const char *, FsCred *);
135     int (*link)(FsContext *, V9fsPath *, V9fsPath *, const char *);
136     int (*setuid)(FsContext *, uid_t);
137     int (*close)(FsContext *, V9fsFidOpenState *);
138     int (*closedir)(FsContext *, V9fsFidOpenState *);
139     int (*opendir)(FsContext *, V9fsPath *, V9fsFidOpenState *);
140     int (*open)(FsContext *, V9fsPath *, int, V9fsFidOpenState *);
141     int (*open2)(FsContext *, V9fsPath *, const char *,
142                  int, FsCred *, V9fsFidOpenState *);
143     void (*rewinddir)(FsContext *, V9fsFidOpenState *);
144     off_t (*telldir)(FsContext *, V9fsFidOpenState *);
145     struct dirent * (*readdir)(FsContext *, V9fsFidOpenState *);
146     void (*seekdir)(FsContext *, V9fsFidOpenState *, off_t);
147     ssize_t (*preadv)(FsContext *, V9fsFidOpenState *,
148                       const struct iovec *, int, off_t);
149     ssize_t (*pwritev)(FsContext *, V9fsFidOpenState *,
150                        const struct iovec *, int, off_t);
151     int (*mkdir)(FsContext *, V9fsPath *, const char *, FsCred *);
152     int (*fstat)(FsContext *, int, V9fsFidOpenState *, struct stat *);
153     int (*rename)(FsContext *, const char *, const char *);
154     int (*truncate)(FsContext *, V9fsPath *, off_t);
155     int (*fsync)(FsContext *, int, V9fsFidOpenState *, int);
156     int (*statfs)(FsContext *s, V9fsPath *path, struct statfs *stbuf);
157     ssize_t (*lgetxattr)(FsContext *, V9fsPath *,
158                          const char *, void *, size_t);
159     ssize_t (*llistxattr)(FsContext *, V9fsPath *, void *, size_t);
160     int (*lsetxattr)(FsContext *, V9fsPath *,
161                      const char *, void *, size_t, int);
162     int (*lremovexattr)(FsContext *, V9fsPath *, const char *);
163     int (*name_to_path)(FsContext *, V9fsPath *, const char *, V9fsPath *);
164     int (*renameat)(FsContext *ctx, V9fsPath *olddir, const char *old_name,
165                     V9fsPath *newdir, const char *new_name);
166     int (*unlinkat)(FsContext *ctx, V9fsPath *dir, const char *name, int flags);
167 };
168 
169 #endif
170