1 /* SPDX-License-Identifier: MIT */ 1 /* SPDX-License-Identifier: MIT */
2 /* 2 /*
3 * VirtualBox Guest Shared Folders support: mo 3 * VirtualBox Guest Shared Folders support: module header.
4 * 4 *
5 * Copyright (C) 2006-2018 Oracle Corporation 5 * Copyright (C) 2006-2018 Oracle Corporation
6 */ 6 */
7 7
8 #ifndef VFSMOD_H 8 #ifndef VFSMOD_H
9 #define VFSMOD_H 9 #define VFSMOD_H
10 10
11 #include <linux/backing-dev.h> 11 #include <linux/backing-dev.h>
12 #include <linux/idr.h> 12 #include <linux/idr.h>
13 #include "shfl_hostintf.h" 13 #include "shfl_hostintf.h"
14 14
15 #define DIR_BUFFER_SIZE SZ_16K 15 #define DIR_BUFFER_SIZE SZ_16K
16 16
17 /* The cast is to prevent assignment of void * 17 /* The cast is to prevent assignment of void * to pointers of arbitrary type */
18 #define VBOXSF_SBI(sb) ((struct vboxsf_sbi *) 18 #define VBOXSF_SBI(sb) ((struct vboxsf_sbi *)(sb)->s_fs_info)
19 #define VBOXSF_I(i) container_of(i, struct 19 #define VBOXSF_I(i) container_of(i, struct vboxsf_inode, vfs_inode)
20 20
21 struct vboxsf_handle; <<
22 <<
23 struct vboxsf_options { 21 struct vboxsf_options {
24 unsigned long ttl; 22 unsigned long ttl;
25 kuid_t uid; 23 kuid_t uid;
26 kgid_t gid; 24 kgid_t gid;
27 bool dmode_set; 25 bool dmode_set;
28 bool fmode_set; 26 bool fmode_set;
29 umode_t dmode; 27 umode_t dmode;
30 umode_t fmode; 28 umode_t fmode;
31 umode_t dmask; 29 umode_t dmask;
32 umode_t fmask; 30 umode_t fmask;
33 }; 31 };
34 32
35 struct vboxsf_fs_context { 33 struct vboxsf_fs_context {
36 struct vboxsf_options o; 34 struct vboxsf_options o;
37 char *nls_name; 35 char *nls_name;
38 }; 36 };
39 37
40 /* per-shared folder information */ 38 /* per-shared folder information */
41 struct vboxsf_sbi { 39 struct vboxsf_sbi {
42 struct vboxsf_options o; 40 struct vboxsf_options o;
43 struct shfl_fsobjinfo root_info; 41 struct shfl_fsobjinfo root_info;
44 struct idr ino_idr; 42 struct idr ino_idr;
45 spinlock_t ino_idr_lock; /* This prote 43 spinlock_t ino_idr_lock; /* This protects ino_idr */
46 struct nls_table *nls; 44 struct nls_table *nls;
47 u32 next_generation; 45 u32 next_generation;
48 u32 root; 46 u32 root;
49 int bdi_id; 47 int bdi_id;
50 }; 48 };
51 49
52 /* per-inode information */ 50 /* per-inode information */
53 struct vboxsf_inode { 51 struct vboxsf_inode {
54 /* some information was changed, updat 52 /* some information was changed, update data on next revalidate */
55 int force_restat; 53 int force_restat;
56 /* list of open handles for this inode 54 /* list of open handles for this inode + lock protecting it */
57 struct list_head handle_list; 55 struct list_head handle_list;
58 /* This mutex protects handle_list acc 56 /* This mutex protects handle_list accesses */
59 struct mutex handle_list_mutex; 57 struct mutex handle_list_mutex;
60 /* The VFS inode struct */ 58 /* The VFS inode struct */
61 struct inode vfs_inode; 59 struct inode vfs_inode;
62 }; 60 };
63 61
64 struct vboxsf_dir_info { 62 struct vboxsf_dir_info {
65 struct list_head info_list; 63 struct list_head info_list;
66 }; 64 };
67 65
68 struct vboxsf_dir_buf { 66 struct vboxsf_dir_buf {
69 size_t entries; 67 size_t entries;
70 size_t free; 68 size_t free;
71 size_t used; 69 size_t used;
72 void *buf; 70 void *buf;
73 struct list_head head; 71 struct list_head head;
74 }; 72 };
75 73
76 /* globals */ 74 /* globals */
77 extern const struct inode_operations vboxsf_di 75 extern const struct inode_operations vboxsf_dir_iops;
78 extern const struct inode_operations vboxsf_ln 76 extern const struct inode_operations vboxsf_lnk_iops;
79 extern const struct inode_operations vboxsf_re 77 extern const struct inode_operations vboxsf_reg_iops;
80 extern const struct file_operations vboxsf_dir 78 extern const struct file_operations vboxsf_dir_fops;
81 extern const struct file_operations vboxsf_reg 79 extern const struct file_operations vboxsf_reg_fops;
82 extern const struct address_space_operations v 80 extern const struct address_space_operations vboxsf_reg_aops;
83 extern const struct dentry_operations vboxsf_d 81 extern const struct dentry_operations vboxsf_dentry_ops;
84 82
85 /* from file.c */ <<
86 struct vboxsf_handle *vboxsf_create_sf_handle( <<
87 <<
88 void vboxsf_release_sf_handle(struct inode *in <<
89 <<
90 /* from utils.c */ 83 /* from utils.c */
91 struct inode *vboxsf_new_inode(struct super_bl 84 struct inode *vboxsf_new_inode(struct super_block *sb);
92 int vboxsf_init_inode(struct vboxsf_sbi *sbi, !! 85 void vboxsf_init_inode(struct vboxsf_sbi *sbi, struct inode *inode,
93 const struct shfl_fsobj !! 86 const struct shfl_fsobjinfo *info);
94 int vboxsf_create_at_dentry(struct dentry *den 87 int vboxsf_create_at_dentry(struct dentry *dentry,
95 struct shfl_create 88 struct shfl_createparms *params);
96 int vboxsf_stat(struct vboxsf_sbi *sbi, struct 89 int vboxsf_stat(struct vboxsf_sbi *sbi, struct shfl_string *path,
97 struct shfl_fsobjinfo *info); 90 struct shfl_fsobjinfo *info);
98 int vboxsf_stat_dentry(struct dentry *dentry, 91 int vboxsf_stat_dentry(struct dentry *dentry, struct shfl_fsobjinfo *info);
99 int vboxsf_inode_revalidate(struct dentry *den 92 int vboxsf_inode_revalidate(struct dentry *dentry);
100 int vboxsf_getattr(struct mnt_idmap *idmap, co !! 93 int vboxsf_getattr(const struct path *path, struct kstat *kstat,
101 struct kstat *kstat, u32 re !! 94 u32 request_mask, unsigned int query_flags);
102 unsigned int query_flags); !! 95 int vboxsf_setattr(struct dentry *dentry, struct iattr *iattr);
103 int vboxsf_setattr(struct mnt_idmap *idmap, st <<
104 struct iattr *iattr); <<
105 struct shfl_string *vboxsf_path_from_dentry(st 96 struct shfl_string *vboxsf_path_from_dentry(struct vboxsf_sbi *sbi,
106 st 97 struct dentry *dentry);
107 int vboxsf_nlscpy(struct vboxsf_sbi *sbi, char 98 int vboxsf_nlscpy(struct vboxsf_sbi *sbi, char *name, size_t name_bound_len,
108 const unsigned char *utf8_na 99 const unsigned char *utf8_name, size_t utf8_len);
109 struct vboxsf_dir_info *vboxsf_dir_info_alloc( 100 struct vboxsf_dir_info *vboxsf_dir_info_alloc(void);
110 void vboxsf_dir_info_free(struct vboxsf_dir_in 101 void vboxsf_dir_info_free(struct vboxsf_dir_info *p);
111 int vboxsf_dir_read_all(struct vboxsf_sbi *sbi 102 int vboxsf_dir_read_all(struct vboxsf_sbi *sbi, struct vboxsf_dir_info *sf_d,
112 u64 handle); 103 u64 handle);
113 104
114 /* from vboxsf_wrappers.c */ 105 /* from vboxsf_wrappers.c */
115 int vboxsf_connect(void); 106 int vboxsf_connect(void);
116 void vboxsf_disconnect(void); 107 void vboxsf_disconnect(void);
117 108
118 int vboxsf_create(u32 root, struct shfl_string 109 int vboxsf_create(u32 root, struct shfl_string *parsed_path,
119 struct shfl_createparms *cre 110 struct shfl_createparms *create_parms);
120 111
121 int vboxsf_close(u32 root, u64 handle); 112 int vboxsf_close(u32 root, u64 handle);
122 int vboxsf_remove(u32 root, struct shfl_string 113 int vboxsf_remove(u32 root, struct shfl_string *parsed_path, u32 flags);
123 int vboxsf_rename(u32 root, struct shfl_string 114 int vboxsf_rename(u32 root, struct shfl_string *src_path,
124 struct shfl_string *dest_pat 115 struct shfl_string *dest_path, u32 flags);
125 116
126 int vboxsf_read(u32 root, u64 handle, u64 offs 117 int vboxsf_read(u32 root, u64 handle, u64 offset, u32 *buf_len, u8 *buf);
127 int vboxsf_write(u32 root, u64 handle, u64 off 118 int vboxsf_write(u32 root, u64 handle, u64 offset, u32 *buf_len, u8 *buf);
128 119
129 int vboxsf_dirinfo(u32 root, u64 handle, 120 int vboxsf_dirinfo(u32 root, u64 handle,
130 struct shfl_string *parsed_ 121 struct shfl_string *parsed_path, u32 flags, u32 index,
131 u32 *buf_len, struct shfl_d 122 u32 *buf_len, struct shfl_dirinfo *buf, u32 *file_count);
132 int vboxsf_fsinfo(u32 root, u64 handle, u32 fl 123 int vboxsf_fsinfo(u32 root, u64 handle, u32 flags,
133 u32 *buf_len, void *buf); 124 u32 *buf_len, void *buf);
134 125
135 int vboxsf_map_folder(struct shfl_string *fold 126 int vboxsf_map_folder(struct shfl_string *folder_name, u32 *root);
136 int vboxsf_unmap_folder(u32 root); 127 int vboxsf_unmap_folder(u32 root);
137 128
138 int vboxsf_readlink(u32 root, struct shfl_stri 129 int vboxsf_readlink(u32 root, struct shfl_string *parsed_path,
139 u32 buf_len, u8 *buf); 130 u32 buf_len, u8 *buf);
140 int vboxsf_symlink(u32 root, struct shfl_strin 131 int vboxsf_symlink(u32 root, struct shfl_string *new_path,
141 struct shfl_string *old_pat 132 struct shfl_string *old_path, struct shfl_fsobjinfo *buf);
142 133
143 int vboxsf_set_utf8(void); 134 int vboxsf_set_utf8(void);
144 int vboxsf_set_symlinks(void); 135 int vboxsf_set_symlinks(void);
145 136
146 #endif 137 #endif
147 138
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.