1 // SPDX-License-Identifier: MIT
3 * VirtualBox Guest Shared Folders support: Utility functions.
4 * Mainly conversion from/to VirtualBox/Linux data structures.
6 * Copyright (C) 2006-2018 Oracle Corporation
9 #include <linux/namei.h>
10 #include <linux/nls.h>
11 #include <linux/sizes.h>
12 #include <linux/pagemap.h>
13 #include <linux/vfs.h>
16 struct inode *vboxsf_new_inode(struct super_block *sb)
18 struct vboxsf_sbi *sbi = VBOXSF_SBI(sb);
24 inode = new_inode(sb);
26 return ERR_PTR(-ENOMEM);
28 idr_preload(GFP_KERNEL);
29 spin_lock_irqsave(&sbi->ino_idr_lock, flags);
30 cursor = idr_get_cursor(&sbi->ino_idr);
31 ret = idr_alloc_cyclic(&sbi->ino_idr, inode, 1, 0, GFP_ATOMIC);
32 if (ret >= 0 && ret < cursor)
33 sbi->next_generation++;
34 gen = sbi->next_generation;
35 spin_unlock_irqrestore(&sbi->ino_idr_lock, flags);
44 inode->i_generation = gen;
48 /* set [inode] attributes based on [info], uid/gid based on [sbi] */
49 int vboxsf_init_inode(struct vboxsf_sbi *sbi, struct inode *inode,
50 const struct shfl_fsobjinfo *info, bool reinit)
52 const struct shfl_fsobjattr *attr;
58 #define mode_set(r) ((attr->mode & (SHFL_UNIX_##r)) ? (S_##r) : 0)
60 mode = mode_set(IRUSR);
61 mode |= mode_set(IWUSR);
62 mode |= mode_set(IXUSR);
64 mode |= mode_set(IRGRP);
65 mode |= mode_set(IWGRP);
66 mode |= mode_set(IXGRP);
68 mode |= mode_set(IROTH);
69 mode |= mode_set(IWOTH);
70 mode |= mode_set(IXOTH);
74 /* We use the host-side values for these */
75 inode->i_flags |= S_NOATIME | S_NOCMTIME;
76 inode->i_mapping->a_ops = &vboxsf_reg_aops;
78 if (SHFL_IS_DIRECTORY(attr->mode)) {
81 mode &= ~sbi->o.dmask;
84 inode->i_op = &vboxsf_dir_iops;
85 inode->i_fop = &vboxsf_dir_fops;
87 * XXX: this probably should be set to the number of entries
88 * in the directory plus two (. ..)
91 } else if (!S_ISDIR(inode->i_mode))
94 } else if (SHFL_IS_SYMLINK(attr->mode)) {
97 mode &= ~sbi->o.fmask;
100 inode->i_op = &vboxsf_lnk_iops;
102 } else if (!S_ISLNK(inode->i_mode))
104 inode->i_mode = mode;
106 if (sbi->o.fmode_set)
108 mode &= ~sbi->o.fmask;
111 inode->i_op = &vboxsf_reg_iops;
112 inode->i_fop = &vboxsf_reg_fops;
114 } else if (!S_ISREG(inode->i_mode))
116 inode->i_mode = mode;
119 inode->i_uid = sbi->o.uid;
120 inode->i_gid = sbi->o.gid;
122 inode->i_size = info->size;
123 inode->i_blkbits = 12;
124 /* i_blocks always in units of 512 bytes! */
125 allocated = info->allocated + 511;
126 do_div(allocated, 512);
127 inode->i_blocks = allocated;
129 inode->i_atime = ns_to_timespec64(
130 info->access_time.ns_relative_to_unix_epoch);
131 inode->i_ctime = ns_to_timespec64(
132 info->change_time.ns_relative_to_unix_epoch);
133 inode->i_mtime = ns_to_timespec64(
134 info->modification_time.ns_relative_to_unix_epoch);
138 int vboxsf_create_at_dentry(struct dentry *dentry,
139 struct shfl_createparms *params)
141 struct vboxsf_sbi *sbi = VBOXSF_SBI(dentry->d_sb);
142 struct shfl_string *path;
145 path = vboxsf_path_from_dentry(sbi, dentry);
147 return PTR_ERR(path);
149 err = vboxsf_create(sbi->root, path, params);
155 int vboxsf_stat(struct vboxsf_sbi *sbi, struct shfl_string *path,
156 struct shfl_fsobjinfo *info)
158 struct shfl_createparms params = {};
161 params.handle = SHFL_HANDLE_NIL;
162 params.create_flags = SHFL_CF_LOOKUP | SHFL_CF_ACT_FAIL_IF_NEW;
164 err = vboxsf_create(sbi->root, path, ¶ms);
168 if (params.result != SHFL_FILE_EXISTS)
177 int vboxsf_stat_dentry(struct dentry *dentry, struct shfl_fsobjinfo *info)
179 struct vboxsf_sbi *sbi = VBOXSF_SBI(dentry->d_sb);
180 struct shfl_string *path;
183 path = vboxsf_path_from_dentry(sbi, dentry);
185 return PTR_ERR(path);
187 err = vboxsf_stat(sbi, path, info);
192 int vboxsf_inode_revalidate(struct dentry *dentry)
194 struct vboxsf_sbi *sbi;
195 struct vboxsf_inode *sf_i;
196 struct shfl_fsobjinfo info;
197 struct timespec64 prev_mtime;
201 if (!dentry || !d_really_is_positive(dentry))
204 inode = d_inode(dentry);
205 prev_mtime = inode->i_mtime;
206 sf_i = VBOXSF_I(inode);
207 sbi = VBOXSF_SBI(dentry->d_sb);
208 if (!sf_i->force_restat) {
209 if (time_before(jiffies, dentry->d_time + sbi->o.ttl))
213 err = vboxsf_stat_dentry(dentry, &info);
217 dentry->d_time = jiffies;
218 sf_i->force_restat = 0;
219 err = vboxsf_init_inode(sbi, inode, &info, true);
224 * If the file was changed on the host side we need to invalidate the
225 * page-cache for it. Note this also gets triggered by our own writes,
226 * this is unavoidable.
228 if (timespec64_compare(&inode->i_mtime, &prev_mtime) > 0)
229 invalidate_inode_pages2(inode->i_mapping);
234 int vboxsf_getattr(struct user_namespace *mnt_userns, const struct path *path,
235 struct kstat *kstat, u32 request_mask, unsigned int flags)
238 struct dentry *dentry = path->dentry;
239 struct inode *inode = d_inode(dentry);
240 struct vboxsf_inode *sf_i = VBOXSF_I(inode);
242 switch (flags & AT_STATX_SYNC_TYPE) {
243 case AT_STATX_DONT_SYNC:
246 case AT_STATX_FORCE_SYNC:
247 sf_i->force_restat = 1;
250 err = vboxsf_inode_revalidate(dentry);
255 generic_fillattr(&init_user_ns, d_inode(dentry), kstat);
259 int vboxsf_setattr(struct user_namespace *mnt_userns, struct dentry *dentry,
262 struct vboxsf_inode *sf_i = VBOXSF_I(d_inode(dentry));
263 struct vboxsf_sbi *sbi = VBOXSF_SBI(dentry->d_sb);
264 struct shfl_createparms params = {};
265 struct shfl_fsobjinfo info = {};
269 params.handle = SHFL_HANDLE_NIL;
270 params.create_flags = SHFL_CF_ACT_OPEN_IF_EXISTS |
271 SHFL_CF_ACT_FAIL_IF_NEW |
272 SHFL_CF_ACCESS_ATTR_WRITE;
274 /* this is at least required for Posix hosts */
275 if (iattr->ia_valid & ATTR_SIZE)
276 params.create_flags |= SHFL_CF_ACCESS_WRITE;
278 err = vboxsf_create_at_dentry(dentry, ¶ms);
279 if (err || params.result != SHFL_FILE_EXISTS)
280 return err ? err : -ENOENT;
282 #define mode_set(r) ((iattr->ia_mode & (S_##r)) ? SHFL_UNIX_##r : 0)
285 * Setting the file size and setting the other attributes has to
286 * be handled separately.
288 if (iattr->ia_valid & (ATTR_MODE | ATTR_ATIME | ATTR_MTIME)) {
289 if (iattr->ia_valid & ATTR_MODE) {
290 info.attr.mode = mode_set(IRUSR);
291 info.attr.mode |= mode_set(IWUSR);
292 info.attr.mode |= mode_set(IXUSR);
293 info.attr.mode |= mode_set(IRGRP);
294 info.attr.mode |= mode_set(IWGRP);
295 info.attr.mode |= mode_set(IXGRP);
296 info.attr.mode |= mode_set(IROTH);
297 info.attr.mode |= mode_set(IWOTH);
298 info.attr.mode |= mode_set(IXOTH);
300 if (iattr->ia_mode & S_IFDIR)
301 info.attr.mode |= SHFL_TYPE_DIRECTORY;
303 info.attr.mode |= SHFL_TYPE_FILE;
306 if (iattr->ia_valid & ATTR_ATIME)
307 info.access_time.ns_relative_to_unix_epoch =
308 timespec64_to_ns(&iattr->ia_atime);
310 if (iattr->ia_valid & ATTR_MTIME)
311 info.modification_time.ns_relative_to_unix_epoch =
312 timespec64_to_ns(&iattr->ia_mtime);
315 * Ignore ctime (inode change time) as it can't be set
316 * from userland anyway.
319 buf_len = sizeof(info);
320 err = vboxsf_fsinfo(sbi->root, params.handle,
321 SHFL_INFO_SET | SHFL_INFO_FILE, &buf_len,
324 vboxsf_close(sbi->root, params.handle);
328 /* the host may have given us different attr then requested */
329 sf_i->force_restat = 1;
334 if (iattr->ia_valid & ATTR_SIZE) {
335 memset(&info, 0, sizeof(info));
336 info.size = iattr->ia_size;
337 buf_len = sizeof(info);
338 err = vboxsf_fsinfo(sbi->root, params.handle,
339 SHFL_INFO_SET | SHFL_INFO_SIZE, &buf_len,
342 vboxsf_close(sbi->root, params.handle);
346 /* the host may have given us different attr then requested */
347 sf_i->force_restat = 1;
350 vboxsf_close(sbi->root, params.handle);
352 /* Update the inode with what the host has actually given us. */
353 if (sf_i->force_restat)
354 vboxsf_inode_revalidate(dentry);
360 * [dentry] contains string encoded in coding system that corresponds
361 * to [sbi]->nls, we must convert it to UTF8 here.
362 * Returns a shfl_string allocated through __getname (must be freed using
363 * __putname), or an ERR_PTR on error.
365 struct shfl_string *vboxsf_path_from_dentry(struct vboxsf_sbi *sbi,
366 struct dentry *dentry)
368 struct shfl_string *shfl_path;
369 int path_len, out_len, nb;
376 return ERR_PTR(-ENOMEM);
378 path = dentry_path_raw(dentry, buf, PATH_MAX);
381 return ERR_CAST(path);
383 path_len = strlen(path);
386 shfl_path = __getname();
389 return ERR_PTR(-ENOMEM);
392 out = shfl_path->string.utf8;
393 out_len = PATH_MAX - SHFLSTRING_HEADER_SIZE - 1;
396 nb = sbi->nls->char2uni(path, path_len, &uni);
398 __putname(shfl_path);
400 return ERR_PTR(-EINVAL);
405 nb = utf32_to_utf8(uni, out, out_len);
407 __putname(shfl_path);
409 return ERR_PTR(-ENAMETOOLONG);
415 shfl_path->length = out - shfl_path->string.utf8;
416 shfl_path->size = shfl_path->length + 1;
419 if ((SHFLSTRING_HEADER_SIZE + path_len + 1) > PATH_MAX) {
421 return ERR_PTR(-ENAMETOOLONG);
424 * dentry_path stores the name at the end of buf, but the
425 * shfl_string string we return must be properly aligned.
427 shfl_path = (struct shfl_string *)buf;
428 memmove(shfl_path->string.utf8, path, path_len);
429 shfl_path->string.utf8[path_len] = 0;
430 shfl_path->length = path_len;
431 shfl_path->size = path_len + 1;
437 int vboxsf_nlscpy(struct vboxsf_sbi *sbi, char *name, size_t name_bound_len,
438 const unsigned char *utf8_name, size_t utf8_len)
443 size_t out_bound_len;
447 in_bound_len = utf8_len;
451 /* Reserve space for terminating 0 */
452 out_bound_len = name_bound_len - 1;
454 while (in_bound_len) {
458 nb = utf8_to_utf32(in, in_bound_len, &uni);
465 nb = sbi->nls->uni2char(uni, out, out_bound_len);
479 static struct vboxsf_dir_buf *vboxsf_dir_buf_alloc(struct list_head *list)
481 struct vboxsf_dir_buf *b;
483 b = kmalloc(sizeof(*b), GFP_KERNEL);
487 b->buf = kmalloc(DIR_BUFFER_SIZE, GFP_KERNEL);
495 b->free = DIR_BUFFER_SIZE;
496 list_add(&b->head, list);
501 static void vboxsf_dir_buf_free(struct vboxsf_dir_buf *b)
508 struct vboxsf_dir_info *vboxsf_dir_info_alloc(void)
510 struct vboxsf_dir_info *p;
512 p = kmalloc(sizeof(*p), GFP_KERNEL);
516 INIT_LIST_HEAD(&p->info_list);
520 void vboxsf_dir_info_free(struct vboxsf_dir_info *p)
522 struct list_head *list, *pos, *tmp;
524 list = &p->info_list;
525 list_for_each_safe(pos, tmp, list) {
526 struct vboxsf_dir_buf *b;
528 b = list_entry(pos, struct vboxsf_dir_buf, head);
529 vboxsf_dir_buf_free(b);
534 int vboxsf_dir_read_all(struct vboxsf_sbi *sbi, struct vboxsf_dir_info *sf_d,
537 struct vboxsf_dir_buf *b;
542 /* vboxsf_dirinfo returns 1 on end of dir */
544 b = vboxsf_dir_buf_alloc(&sf_d->info_list);
553 err = vboxsf_dirinfo(sbi->root, handle, NULL, 0, 0,
554 &size, buf, &entries);
558 b->entries += entries;
563 if (b && b->used == 0)
564 vboxsf_dir_buf_free(b);
566 /* -EILSEQ means the host could not translate a filename, ignore */
567 if (err > 0 || err == -EILSEQ)