Loading...
1/*
2 * linux/fs/open.c
3 *
4 * Copyright (C) 1991, 1992 Linus Torvalds
5 */
6
7#include <linux/string.h>
8#include <linux/mm.h>
9#include <linux/file.h>
10#include <linux/fdtable.h>
11#include <linux/fsnotify.h>
12#include <linux/module.h>
13#include <linux/tty.h>
14#include <linux/namei.h>
15#include <linux/backing-dev.h>
16#include <linux/capability.h>
17#include <linux/securebits.h>
18#include <linux/security.h>
19#include <linux/mount.h>
20#include <linux/fcntl.h>
21#include <linux/slab.h>
22#include <asm/uaccess.h>
23#include <linux/fs.h>
24#include <linux/personality.h>
25#include <linux/pagemap.h>
26#include <linux/syscalls.h>
27#include <linux/rcupdate.h>
28#include <linux/audit.h>
29#include <linux/falloc.h>
30#include <linux/fs_struct.h>
31#include <linux/ima.h>
32#include <linux/dnotify.h>
33
34#include "internal.h"
35
36int do_truncate(struct dentry *dentry, loff_t length, unsigned int time_attrs,
37 struct file *filp)
38{
39 int ret;
40 struct iattr newattrs;
41
42 /* Not pretty: "inode->i_size" shouldn't really be signed. But it is. */
43 if (length < 0)
44 return -EINVAL;
45
46 newattrs.ia_size = length;
47 newattrs.ia_valid = ATTR_SIZE | time_attrs;
48 if (filp) {
49 newattrs.ia_file = filp;
50 newattrs.ia_valid |= ATTR_FILE;
51 }
52
53 /* Remove suid/sgid on truncate too */
54 ret = should_remove_suid(dentry);
55 if (ret)
56 newattrs.ia_valid |= ret | ATTR_FORCE;
57
58 mutex_lock(&dentry->d_inode->i_mutex);
59 ret = notify_change(dentry, &newattrs);
60 mutex_unlock(&dentry->d_inode->i_mutex);
61 return ret;
62}
63
64static long do_sys_truncate(const char __user *pathname, loff_t length)
65{
66 struct path path;
67 struct inode *inode;
68 int error;
69
70 error = -EINVAL;
71 if (length < 0) /* sorry, but loff_t says... */
72 goto out;
73
74 error = user_path(pathname, &path);
75 if (error)
76 goto out;
77 inode = path.dentry->d_inode;
78
79 /* For directories it's -EISDIR, for other non-regulars - -EINVAL */
80 error = -EISDIR;
81 if (S_ISDIR(inode->i_mode))
82 goto dput_and_out;
83
84 error = -EINVAL;
85 if (!S_ISREG(inode->i_mode))
86 goto dput_and_out;
87
88 error = mnt_want_write(path.mnt);
89 if (error)
90 goto dput_and_out;
91
92 error = inode_permission(inode, MAY_WRITE);
93 if (error)
94 goto mnt_drop_write_and_out;
95
96 error = -EPERM;
97 if (IS_APPEND(inode))
98 goto mnt_drop_write_and_out;
99
100 error = get_write_access(inode);
101 if (error)
102 goto mnt_drop_write_and_out;
103
104 /*
105 * Make sure that there are no leases. get_write_access() protects
106 * against the truncate racing with a lease-granting setlease().
107 */
108 error = break_lease(inode, O_WRONLY);
109 if (error)
110 goto put_write_and_out;
111
112 error = locks_verify_truncate(inode, NULL, length);
113 if (!error)
114 error = security_path_truncate(&path);
115 if (!error)
116 error = do_truncate(path.dentry, length, 0, NULL);
117
118put_write_and_out:
119 put_write_access(inode);
120mnt_drop_write_and_out:
121 mnt_drop_write(path.mnt);
122dput_and_out:
123 path_put(&path);
124out:
125 return error;
126}
127
128SYSCALL_DEFINE2(truncate, const char __user *, path, long, length)
129{
130 return do_sys_truncate(path, length);
131}
132
133static long do_sys_ftruncate(unsigned int fd, loff_t length, int small)
134{
135 struct inode * inode;
136 struct dentry *dentry;
137 struct file * file;
138 int error;
139
140 error = -EINVAL;
141 if (length < 0)
142 goto out;
143 error = -EBADF;
144 file = fget(fd);
145 if (!file)
146 goto out;
147
148 /* explicitly opened as large or we are on 64-bit box */
149 if (file->f_flags & O_LARGEFILE)
150 small = 0;
151
152 dentry = file->f_path.dentry;
153 inode = dentry->d_inode;
154 error = -EINVAL;
155 if (!S_ISREG(inode->i_mode) || !(file->f_mode & FMODE_WRITE))
156 goto out_putf;
157
158 error = -EINVAL;
159 /* Cannot ftruncate over 2^31 bytes without large file support */
160 if (small && length > MAX_NON_LFS)
161 goto out_putf;
162
163 error = -EPERM;
164 if (IS_APPEND(inode))
165 goto out_putf;
166
167 error = locks_verify_truncate(inode, file, length);
168 if (!error)
169 error = security_path_truncate(&file->f_path);
170 if (!error)
171 error = do_truncate(dentry, length, ATTR_MTIME|ATTR_CTIME, file);
172out_putf:
173 fput(file);
174out:
175 return error;
176}
177
178SYSCALL_DEFINE2(ftruncate, unsigned int, fd, unsigned long, length)
179{
180 long ret = do_sys_ftruncate(fd, length, 1);
181 /* avoid REGPARM breakage on x86: */
182 asmlinkage_protect(2, ret, fd, length);
183 return ret;
184}
185
186/* LFS versions of truncate are only needed on 32 bit machines */
187#if BITS_PER_LONG == 32
188SYSCALL_DEFINE(truncate64)(const char __user * path, loff_t length)
189{
190 return do_sys_truncate(path, length);
191}
192#ifdef CONFIG_HAVE_SYSCALL_WRAPPERS
193asmlinkage long SyS_truncate64(long path, loff_t length)
194{
195 return SYSC_truncate64((const char __user *) path, length);
196}
197SYSCALL_ALIAS(sys_truncate64, SyS_truncate64);
198#endif
199
200SYSCALL_DEFINE(ftruncate64)(unsigned int fd, loff_t length)
201{
202 long ret = do_sys_ftruncate(fd, length, 0);
203 /* avoid REGPARM breakage on x86: */
204 asmlinkage_protect(2, ret, fd, length);
205 return ret;
206}
207#ifdef CONFIG_HAVE_SYSCALL_WRAPPERS
208asmlinkage long SyS_ftruncate64(long fd, loff_t length)
209{
210 return SYSC_ftruncate64((unsigned int) fd, length);
211}
212SYSCALL_ALIAS(sys_ftruncate64, SyS_ftruncate64);
213#endif
214#endif /* BITS_PER_LONG == 32 */
215
216
217int do_fallocate(struct file *file, int mode, loff_t offset, loff_t len)
218{
219 struct inode *inode = file->f_path.dentry->d_inode;
220 long ret;
221
222 if (offset < 0 || len <= 0)
223 return -EINVAL;
224
225 /* Return error if mode is not supported */
226 if (mode & ~(FALLOC_FL_KEEP_SIZE | FALLOC_FL_PUNCH_HOLE))
227 return -EOPNOTSUPP;
228
229 /* Punch hole must have keep size set */
230 if ((mode & FALLOC_FL_PUNCH_HOLE) &&
231 !(mode & FALLOC_FL_KEEP_SIZE))
232 return -EOPNOTSUPP;
233
234 if (!(file->f_mode & FMODE_WRITE))
235 return -EBADF;
236
237 /* It's not possible punch hole on append only file */
238 if (mode & FALLOC_FL_PUNCH_HOLE && IS_APPEND(inode))
239 return -EPERM;
240
241 if (IS_IMMUTABLE(inode))
242 return -EPERM;
243
244 /*
245 * Revalidate the write permissions, in case security policy has
246 * changed since the files were opened.
247 */
248 ret = security_file_permission(file, MAY_WRITE);
249 if (ret)
250 return ret;
251
252 if (S_ISFIFO(inode->i_mode))
253 return -ESPIPE;
254
255 /*
256 * Let individual file system decide if it supports preallocation
257 * for directories or not.
258 */
259 if (!S_ISREG(inode->i_mode) && !S_ISDIR(inode->i_mode))
260 return -ENODEV;
261
262 /* Check for wrap through zero too */
263 if (((offset + len) > inode->i_sb->s_maxbytes) || ((offset + len) < 0))
264 return -EFBIG;
265
266 if (!file->f_op->fallocate)
267 return -EOPNOTSUPP;
268
269 return file->f_op->fallocate(file, mode, offset, len);
270}
271
272SYSCALL_DEFINE(fallocate)(int fd, int mode, loff_t offset, loff_t len)
273{
274 struct file *file;
275 int error = -EBADF;
276
277 file = fget(fd);
278 if (file) {
279 error = do_fallocate(file, mode, offset, len);
280 fput(file);
281 }
282
283 return error;
284}
285
286#ifdef CONFIG_HAVE_SYSCALL_WRAPPERS
287asmlinkage long SyS_fallocate(long fd, long mode, loff_t offset, loff_t len)
288{
289 return SYSC_fallocate((int)fd, (int)mode, offset, len);
290}
291SYSCALL_ALIAS(sys_fallocate, SyS_fallocate);
292#endif
293
294/*
295 * access() needs to use the real uid/gid, not the effective uid/gid.
296 * We do this by temporarily clearing all FS-related capabilities and
297 * switching the fsuid/fsgid around to the real ones.
298 */
299SYSCALL_DEFINE3(faccessat, int, dfd, const char __user *, filename, int, mode)
300{
301 const struct cred *old_cred;
302 struct cred *override_cred;
303 struct path path;
304 struct inode *inode;
305 int res;
306
307 if (mode & ~S_IRWXO) /* where's F_OK, X_OK, W_OK, R_OK? */
308 return -EINVAL;
309
310 override_cred = prepare_creds();
311 if (!override_cred)
312 return -ENOMEM;
313
314 override_cred->fsuid = override_cred->uid;
315 override_cred->fsgid = override_cred->gid;
316
317 if (!issecure(SECURE_NO_SETUID_FIXUP)) {
318 /* Clear the capabilities if we switch to a non-root user */
319 if (override_cred->uid)
320 cap_clear(override_cred->cap_effective);
321 else
322 override_cred->cap_effective =
323 override_cred->cap_permitted;
324 }
325
326 old_cred = override_creds(override_cred);
327
328 res = user_path_at(dfd, filename, LOOKUP_FOLLOW, &path);
329 if (res)
330 goto out;
331
332 inode = path.dentry->d_inode;
333
334 if ((mode & MAY_EXEC) && S_ISREG(inode->i_mode)) {
335 /*
336 * MAY_EXEC on regular files is denied if the fs is mounted
337 * with the "noexec" flag.
338 */
339 res = -EACCES;
340 if (path.mnt->mnt_flags & MNT_NOEXEC)
341 goto out_path_release;
342 }
343
344 res = inode_permission(inode, mode | MAY_ACCESS);
345 /* SuS v2 requires we report a read only fs too */
346 if (res || !(mode & S_IWOTH) || special_file(inode->i_mode))
347 goto out_path_release;
348 /*
349 * This is a rare case where using __mnt_is_readonly()
350 * is OK without a mnt_want/drop_write() pair. Since
351 * no actual write to the fs is performed here, we do
352 * not need to telegraph to that to anyone.
353 *
354 * By doing this, we accept that this access is
355 * inherently racy and know that the fs may change
356 * state before we even see this result.
357 */
358 if (__mnt_is_readonly(path.mnt))
359 res = -EROFS;
360
361out_path_release:
362 path_put(&path);
363out:
364 revert_creds(old_cred);
365 put_cred(override_cred);
366 return res;
367}
368
369SYSCALL_DEFINE2(access, const char __user *, filename, int, mode)
370{
371 return sys_faccessat(AT_FDCWD, filename, mode);
372}
373
374SYSCALL_DEFINE1(chdir, const char __user *, filename)
375{
376 struct path path;
377 int error;
378
379 error = user_path_dir(filename, &path);
380 if (error)
381 goto out;
382
383 error = inode_permission(path.dentry->d_inode, MAY_EXEC | MAY_CHDIR);
384 if (error)
385 goto dput_and_out;
386
387 set_fs_pwd(current->fs, &path);
388
389dput_and_out:
390 path_put(&path);
391out:
392 return error;
393}
394
395SYSCALL_DEFINE1(fchdir, unsigned int, fd)
396{
397 struct file *file;
398 struct inode *inode;
399 int error;
400
401 error = -EBADF;
402 file = fget(fd);
403 if (!file)
404 goto out;
405
406 inode = file->f_path.dentry->d_inode;
407
408 error = -ENOTDIR;
409 if (!S_ISDIR(inode->i_mode))
410 goto out_putf;
411
412 error = inode_permission(inode, MAY_EXEC | MAY_CHDIR);
413 if (!error)
414 set_fs_pwd(current->fs, &file->f_path);
415out_putf:
416 fput(file);
417out:
418 return error;
419}
420
421SYSCALL_DEFINE1(chroot, const char __user *, filename)
422{
423 struct path path;
424 int error;
425
426 error = user_path_dir(filename, &path);
427 if (error)
428 goto out;
429
430 error = inode_permission(path.dentry->d_inode, MAY_EXEC | MAY_CHDIR);
431 if (error)
432 goto dput_and_out;
433
434 error = -EPERM;
435 if (!capable(CAP_SYS_CHROOT))
436 goto dput_and_out;
437 error = security_path_chroot(&path);
438 if (error)
439 goto dput_and_out;
440
441 set_fs_root(current->fs, &path);
442 error = 0;
443dput_and_out:
444 path_put(&path);
445out:
446 return error;
447}
448
449static int chmod_common(struct path *path, umode_t mode)
450{
451 struct inode *inode = path->dentry->d_inode;
452 struct iattr newattrs;
453 int error;
454
455 error = mnt_want_write(path->mnt);
456 if (error)
457 return error;
458 mutex_lock(&inode->i_mutex);
459 error = security_path_chmod(path->dentry, path->mnt, mode);
460 if (error)
461 goto out_unlock;
462 newattrs.ia_mode = (mode & S_IALLUGO) | (inode->i_mode & ~S_IALLUGO);
463 newattrs.ia_valid = ATTR_MODE | ATTR_CTIME;
464 error = notify_change(path->dentry, &newattrs);
465out_unlock:
466 mutex_unlock(&inode->i_mutex);
467 mnt_drop_write(path->mnt);
468 return error;
469}
470
471SYSCALL_DEFINE2(fchmod, unsigned int, fd, mode_t, mode)
472{
473 struct file * file;
474 int err = -EBADF;
475
476 file = fget(fd);
477 if (file) {
478 audit_inode(NULL, file->f_path.dentry);
479 err = chmod_common(&file->f_path, mode);
480 fput(file);
481 }
482 return err;
483}
484
485SYSCALL_DEFINE3(fchmodat, int, dfd, const char __user *, filename, mode_t, mode)
486{
487 struct path path;
488 int error;
489
490 error = user_path_at(dfd, filename, LOOKUP_FOLLOW, &path);
491 if (!error) {
492 error = chmod_common(&path, mode);
493 path_put(&path);
494 }
495 return error;
496}
497
498SYSCALL_DEFINE2(chmod, const char __user *, filename, mode_t, mode)
499{
500 return sys_fchmodat(AT_FDCWD, filename, mode);
501}
502
503static int chown_common(struct path *path, uid_t user, gid_t group)
504{
505 struct inode *inode = path->dentry->d_inode;
506 int error;
507 struct iattr newattrs;
508
509 newattrs.ia_valid = ATTR_CTIME;
510 if (user != (uid_t) -1) {
511 newattrs.ia_valid |= ATTR_UID;
512 newattrs.ia_uid = user;
513 }
514 if (group != (gid_t) -1) {
515 newattrs.ia_valid |= ATTR_GID;
516 newattrs.ia_gid = group;
517 }
518 if (!S_ISDIR(inode->i_mode))
519 newattrs.ia_valid |=
520 ATTR_KILL_SUID | ATTR_KILL_SGID | ATTR_KILL_PRIV;
521 mutex_lock(&inode->i_mutex);
522 error = security_path_chown(path, user, group);
523 if (!error)
524 error = notify_change(path->dentry, &newattrs);
525 mutex_unlock(&inode->i_mutex);
526
527 return error;
528}
529
530SYSCALL_DEFINE3(chown, const char __user *, filename, uid_t, user, gid_t, group)
531{
532 struct path path;
533 int error;
534
535 error = user_path(filename, &path);
536 if (error)
537 goto out;
538 error = mnt_want_write(path.mnt);
539 if (error)
540 goto out_release;
541 error = chown_common(&path, user, group);
542 mnt_drop_write(path.mnt);
543out_release:
544 path_put(&path);
545out:
546 return error;
547}
548
549SYSCALL_DEFINE5(fchownat, int, dfd, const char __user *, filename, uid_t, user,
550 gid_t, group, int, flag)
551{
552 struct path path;
553 int error = -EINVAL;
554 int lookup_flags;
555
556 if ((flag & ~(AT_SYMLINK_NOFOLLOW | AT_EMPTY_PATH)) != 0)
557 goto out;
558
559 lookup_flags = (flag & AT_SYMLINK_NOFOLLOW) ? 0 : LOOKUP_FOLLOW;
560 if (flag & AT_EMPTY_PATH)
561 lookup_flags |= LOOKUP_EMPTY;
562 error = user_path_at(dfd, filename, lookup_flags, &path);
563 if (error)
564 goto out;
565 error = mnt_want_write(path.mnt);
566 if (error)
567 goto out_release;
568 error = chown_common(&path, user, group);
569 mnt_drop_write(path.mnt);
570out_release:
571 path_put(&path);
572out:
573 return error;
574}
575
576SYSCALL_DEFINE3(lchown, const char __user *, filename, uid_t, user, gid_t, group)
577{
578 struct path path;
579 int error;
580
581 error = user_lpath(filename, &path);
582 if (error)
583 goto out;
584 error = mnt_want_write(path.mnt);
585 if (error)
586 goto out_release;
587 error = chown_common(&path, user, group);
588 mnt_drop_write(path.mnt);
589out_release:
590 path_put(&path);
591out:
592 return error;
593}
594
595SYSCALL_DEFINE3(fchown, unsigned int, fd, uid_t, user, gid_t, group)
596{
597 struct file * file;
598 int error = -EBADF;
599 struct dentry * dentry;
600
601 file = fget(fd);
602 if (!file)
603 goto out;
604
605 error = mnt_want_write_file(file);
606 if (error)
607 goto out_fput;
608 dentry = file->f_path.dentry;
609 audit_inode(NULL, dentry);
610 error = chown_common(&file->f_path, user, group);
611 mnt_drop_write(file->f_path.mnt);
612out_fput:
613 fput(file);
614out:
615 return error;
616}
617
618/*
619 * You have to be very careful that these write
620 * counts get cleaned up in error cases and
621 * upon __fput(). This should probably never
622 * be called outside of __dentry_open().
623 */
624static inline int __get_file_write_access(struct inode *inode,
625 struct vfsmount *mnt)
626{
627 int error;
628 error = get_write_access(inode);
629 if (error)
630 return error;
631 /*
632 * Do not take mount writer counts on
633 * special files since no writes to
634 * the mount itself will occur.
635 */
636 if (!special_file(inode->i_mode)) {
637 /*
638 * Balanced in __fput()
639 */
640 error = mnt_want_write(mnt);
641 if (error)
642 put_write_access(inode);
643 }
644 return error;
645}
646
647static struct file *__dentry_open(struct dentry *dentry, struct vfsmount *mnt,
648 struct file *f,
649 int (*open)(struct inode *, struct file *),
650 const struct cred *cred)
651{
652 static const struct file_operations empty_fops = {};
653 struct inode *inode;
654 int error;
655
656 f->f_mode = OPEN_FMODE(f->f_flags) | FMODE_LSEEK |
657 FMODE_PREAD | FMODE_PWRITE;
658
659 if (unlikely(f->f_flags & O_PATH))
660 f->f_mode = FMODE_PATH;
661
662 inode = dentry->d_inode;
663 if (f->f_mode & FMODE_WRITE) {
664 error = __get_file_write_access(inode, mnt);
665 if (error)
666 goto cleanup_file;
667 if (!special_file(inode->i_mode))
668 file_take_write(f);
669 }
670
671 f->f_mapping = inode->i_mapping;
672 f->f_path.dentry = dentry;
673 f->f_path.mnt = mnt;
674 f->f_pos = 0;
675 file_sb_list_add(f, inode->i_sb);
676
677 if (unlikely(f->f_mode & FMODE_PATH)) {
678 f->f_op = &empty_fops;
679 return f;
680 }
681
682 f->f_op = fops_get(inode->i_fop);
683
684 error = security_dentry_open(f, cred);
685 if (error)
686 goto cleanup_all;
687
688 if (!open && f->f_op)
689 open = f->f_op->open;
690 if (open) {
691 error = open(inode, f);
692 if (error)
693 goto cleanup_all;
694 }
695 if ((f->f_mode & (FMODE_READ | FMODE_WRITE)) == FMODE_READ)
696 i_readcount_inc(inode);
697
698 f->f_flags &= ~(O_CREAT | O_EXCL | O_NOCTTY | O_TRUNC);
699
700 file_ra_state_init(&f->f_ra, f->f_mapping->host->i_mapping);
701
702 /* NB: we're sure to have correct a_ops only after f_op->open */
703 if (f->f_flags & O_DIRECT) {
704 if (!f->f_mapping->a_ops ||
705 ((!f->f_mapping->a_ops->direct_IO) &&
706 (!f->f_mapping->a_ops->get_xip_mem))) {
707 fput(f);
708 f = ERR_PTR(-EINVAL);
709 }
710 }
711
712 return f;
713
714cleanup_all:
715 fops_put(f->f_op);
716 if (f->f_mode & FMODE_WRITE) {
717 put_write_access(inode);
718 if (!special_file(inode->i_mode)) {
719 /*
720 * We don't consider this a real
721 * mnt_want/drop_write() pair
722 * because it all happenend right
723 * here, so just reset the state.
724 */
725 file_reset_write(f);
726 mnt_drop_write(mnt);
727 }
728 }
729 file_sb_list_del(f);
730 f->f_path.dentry = NULL;
731 f->f_path.mnt = NULL;
732cleanup_file:
733 put_filp(f);
734 dput(dentry);
735 mntput(mnt);
736 return ERR_PTR(error);
737}
738
739/**
740 * lookup_instantiate_filp - instantiates the open intent filp
741 * @nd: pointer to nameidata
742 * @dentry: pointer to dentry
743 * @open: open callback
744 *
745 * Helper for filesystems that want to use lookup open intents and pass back
746 * a fully instantiated struct file to the caller.
747 * This function is meant to be called from within a filesystem's
748 * lookup method.
749 * Beware of calling it for non-regular files! Those ->open methods might block
750 * (e.g. in fifo_open), leaving you with parent locked (and in case of fifo,
751 * leading to a deadlock, as nobody can open that fifo anymore, because
752 * another process to open fifo will block on locked parent when doing lookup).
753 * Note that in case of error, nd->intent.open.file is destroyed, but the
754 * path information remains valid.
755 * If the open callback is set to NULL, then the standard f_op->open()
756 * filesystem callback is substituted.
757 */
758struct file *lookup_instantiate_filp(struct nameidata *nd, struct dentry *dentry,
759 int (*open)(struct inode *, struct file *))
760{
761 const struct cred *cred = current_cred();
762
763 if (IS_ERR(nd->intent.open.file))
764 goto out;
765 if (IS_ERR(dentry))
766 goto out_err;
767 nd->intent.open.file = __dentry_open(dget(dentry), mntget(nd->path.mnt),
768 nd->intent.open.file,
769 open, cred);
770out:
771 return nd->intent.open.file;
772out_err:
773 release_open_intent(nd);
774 nd->intent.open.file = ERR_CAST(dentry);
775 goto out;
776}
777EXPORT_SYMBOL_GPL(lookup_instantiate_filp);
778
779/**
780 * nameidata_to_filp - convert a nameidata to an open filp.
781 * @nd: pointer to nameidata
782 * @flags: open flags
783 *
784 * Note that this function destroys the original nameidata
785 */
786struct file *nameidata_to_filp(struct nameidata *nd)
787{
788 const struct cred *cred = current_cred();
789 struct file *filp;
790
791 /* Pick up the filp from the open intent */
792 filp = nd->intent.open.file;
793 nd->intent.open.file = NULL;
794
795 /* Has the filesystem initialised the file for us? */
796 if (filp->f_path.dentry == NULL) {
797 path_get(&nd->path);
798 filp = __dentry_open(nd->path.dentry, nd->path.mnt, filp,
799 NULL, cred);
800 }
801 return filp;
802}
803
804/*
805 * dentry_open() will have done dput(dentry) and mntput(mnt) if it returns an
806 * error.
807 */
808struct file *dentry_open(struct dentry *dentry, struct vfsmount *mnt, int flags,
809 const struct cred *cred)
810{
811 int error;
812 struct file *f;
813
814 validate_creds(cred);
815
816 /* We must always pass in a valid mount pointer. */
817 BUG_ON(!mnt);
818
819 error = -ENFILE;
820 f = get_empty_filp();
821 if (f == NULL) {
822 dput(dentry);
823 mntput(mnt);
824 return ERR_PTR(error);
825 }
826
827 f->f_flags = flags;
828 return __dentry_open(dentry, mnt, f, NULL, cred);
829}
830EXPORT_SYMBOL(dentry_open);
831
832static void __put_unused_fd(struct files_struct *files, unsigned int fd)
833{
834 struct fdtable *fdt = files_fdtable(files);
835 __FD_CLR(fd, fdt->open_fds);
836 if (fd < files->next_fd)
837 files->next_fd = fd;
838}
839
840void put_unused_fd(unsigned int fd)
841{
842 struct files_struct *files = current->files;
843 spin_lock(&files->file_lock);
844 __put_unused_fd(files, fd);
845 spin_unlock(&files->file_lock);
846}
847
848EXPORT_SYMBOL(put_unused_fd);
849
850/*
851 * Install a file pointer in the fd array.
852 *
853 * The VFS is full of places where we drop the files lock between
854 * setting the open_fds bitmap and installing the file in the file
855 * array. At any such point, we are vulnerable to a dup2() race
856 * installing a file in the array before us. We need to detect this and
857 * fput() the struct file we are about to overwrite in this case.
858 *
859 * It should never happen - if we allow dup2() do it, _really_ bad things
860 * will follow.
861 */
862
863void fd_install(unsigned int fd, struct file *file)
864{
865 struct files_struct *files = current->files;
866 struct fdtable *fdt;
867 spin_lock(&files->file_lock);
868 fdt = files_fdtable(files);
869 BUG_ON(fdt->fd[fd] != NULL);
870 rcu_assign_pointer(fdt->fd[fd], file);
871 spin_unlock(&files->file_lock);
872}
873
874EXPORT_SYMBOL(fd_install);
875
876static inline int build_open_flags(int flags, int mode, struct open_flags *op)
877{
878 int lookup_flags = 0;
879 int acc_mode;
880
881 if (!(flags & O_CREAT))
882 mode = 0;
883 op->mode = mode;
884
885 /* Must never be set by userspace */
886 flags &= ~FMODE_NONOTIFY;
887
888 /*
889 * O_SYNC is implemented as __O_SYNC|O_DSYNC. As many places only
890 * check for O_DSYNC if the need any syncing at all we enforce it's
891 * always set instead of having to deal with possibly weird behaviour
892 * for malicious applications setting only __O_SYNC.
893 */
894 if (flags & __O_SYNC)
895 flags |= O_DSYNC;
896
897 /*
898 * If we have O_PATH in the open flag. Then we
899 * cannot have anything other than the below set of flags
900 */
901 if (flags & O_PATH) {
902 flags &= O_DIRECTORY | O_NOFOLLOW | O_PATH;
903 acc_mode = 0;
904 } else {
905 acc_mode = MAY_OPEN | ACC_MODE(flags);
906 }
907
908 op->open_flag = flags;
909
910 /* O_TRUNC implies we need access checks for write permissions */
911 if (flags & O_TRUNC)
912 acc_mode |= MAY_WRITE;
913
914 /* Allow the LSM permission hook to distinguish append
915 access from general write access. */
916 if (flags & O_APPEND)
917 acc_mode |= MAY_APPEND;
918
919 op->acc_mode = acc_mode;
920
921 op->intent = flags & O_PATH ? 0 : LOOKUP_OPEN;
922
923 if (flags & O_CREAT) {
924 op->intent |= LOOKUP_CREATE;
925 if (flags & O_EXCL)
926 op->intent |= LOOKUP_EXCL;
927 }
928
929 if (flags & O_DIRECTORY)
930 lookup_flags |= LOOKUP_DIRECTORY;
931 if (!(flags & O_NOFOLLOW))
932 lookup_flags |= LOOKUP_FOLLOW;
933 return lookup_flags;
934}
935
936/**
937 * filp_open - open file and return file pointer
938 *
939 * @filename: path to open
940 * @flags: open flags as per the open(2) second argument
941 * @mode: mode for the new file if O_CREAT is set, else ignored
942 *
943 * This is the helper to open a file from kernelspace if you really
944 * have to. But in generally you should not do this, so please move
945 * along, nothing to see here..
946 */
947struct file *filp_open(const char *filename, int flags, int mode)
948{
949 struct open_flags op;
950 int lookup = build_open_flags(flags, mode, &op);
951 return do_filp_open(AT_FDCWD, filename, &op, lookup);
952}
953EXPORT_SYMBOL(filp_open);
954
955struct file *file_open_root(struct dentry *dentry, struct vfsmount *mnt,
956 const char *filename, int flags)
957{
958 struct open_flags op;
959 int lookup = build_open_flags(flags, 0, &op);
960 if (flags & O_CREAT)
961 return ERR_PTR(-EINVAL);
962 if (!filename && (flags & O_DIRECTORY))
963 if (!dentry->d_inode->i_op->lookup)
964 return ERR_PTR(-ENOTDIR);
965 return do_file_open_root(dentry, mnt, filename, &op, lookup);
966}
967EXPORT_SYMBOL(file_open_root);
968
969long do_sys_open(int dfd, const char __user *filename, int flags, int mode)
970{
971 struct open_flags op;
972 int lookup = build_open_flags(flags, mode, &op);
973 char *tmp = getname(filename);
974 int fd = PTR_ERR(tmp);
975
976 if (!IS_ERR(tmp)) {
977 fd = get_unused_fd_flags(flags);
978 if (fd >= 0) {
979 struct file *f = do_filp_open(dfd, tmp, &op, lookup);
980 if (IS_ERR(f)) {
981 put_unused_fd(fd);
982 fd = PTR_ERR(f);
983 } else {
984 fsnotify_open(f);
985 fd_install(fd, f);
986 }
987 }
988 putname(tmp);
989 }
990 return fd;
991}
992
993SYSCALL_DEFINE3(open, const char __user *, filename, int, flags, int, mode)
994{
995 long ret;
996
997 if (force_o_largefile())
998 flags |= O_LARGEFILE;
999
1000 ret = do_sys_open(AT_FDCWD, filename, flags, mode);
1001 /* avoid REGPARM breakage on x86: */
1002 asmlinkage_protect(3, ret, filename, flags, mode);
1003 return ret;
1004}
1005
1006SYSCALL_DEFINE4(openat, int, dfd, const char __user *, filename, int, flags,
1007 int, mode)
1008{
1009 long ret;
1010
1011 if (force_o_largefile())
1012 flags |= O_LARGEFILE;
1013
1014 ret = do_sys_open(dfd, filename, flags, mode);
1015 /* avoid REGPARM breakage on x86: */
1016 asmlinkage_protect(4, ret, dfd, filename, flags, mode);
1017 return ret;
1018}
1019
1020#ifndef __alpha__
1021
1022/*
1023 * For backward compatibility? Maybe this should be moved
1024 * into arch/i386 instead?
1025 */
1026SYSCALL_DEFINE2(creat, const char __user *, pathname, int, mode)
1027{
1028 return sys_open(pathname, O_CREAT | O_WRONLY | O_TRUNC, mode);
1029}
1030
1031#endif
1032
1033/*
1034 * "id" is the POSIX thread ID. We use the
1035 * files pointer for this..
1036 */
1037int filp_close(struct file *filp, fl_owner_t id)
1038{
1039 int retval = 0;
1040
1041 if (!file_count(filp)) {
1042 printk(KERN_ERR "VFS: Close: file count is 0\n");
1043 return 0;
1044 }
1045
1046 if (filp->f_op && filp->f_op->flush)
1047 retval = filp->f_op->flush(filp, id);
1048
1049 if (likely(!(filp->f_mode & FMODE_PATH))) {
1050 dnotify_flush(filp, id);
1051 locks_remove_posix(filp, id);
1052 }
1053 fput(filp);
1054 return retval;
1055}
1056
1057EXPORT_SYMBOL(filp_close);
1058
1059/*
1060 * Careful here! We test whether the file pointer is NULL before
1061 * releasing the fd. This ensures that one clone task can't release
1062 * an fd while another clone is opening it.
1063 */
1064SYSCALL_DEFINE1(close, unsigned int, fd)
1065{
1066 struct file * filp;
1067 struct files_struct *files = current->files;
1068 struct fdtable *fdt;
1069 int retval;
1070
1071 spin_lock(&files->file_lock);
1072 fdt = files_fdtable(files);
1073 if (fd >= fdt->max_fds)
1074 goto out_unlock;
1075 filp = fdt->fd[fd];
1076 if (!filp)
1077 goto out_unlock;
1078 rcu_assign_pointer(fdt->fd[fd], NULL);
1079 FD_CLR(fd, fdt->close_on_exec);
1080 __put_unused_fd(files, fd);
1081 spin_unlock(&files->file_lock);
1082 retval = filp_close(filp, files);
1083
1084 /* can't restart close syscall because file table entry was cleared */
1085 if (unlikely(retval == -ERESTARTSYS ||
1086 retval == -ERESTARTNOINTR ||
1087 retval == -ERESTARTNOHAND ||
1088 retval == -ERESTART_RESTARTBLOCK))
1089 retval = -EINTR;
1090
1091 return retval;
1092
1093out_unlock:
1094 spin_unlock(&files->file_lock);
1095 return -EBADF;
1096}
1097EXPORT_SYMBOL(sys_close);
1098
1099/*
1100 * This routine simulates a hangup on the tty, to arrange that users
1101 * are given clean terminals at login time.
1102 */
1103SYSCALL_DEFINE0(vhangup)
1104{
1105 if (capable(CAP_SYS_TTY_CONFIG)) {
1106 tty_vhangup_self();
1107 return 0;
1108 }
1109 return -EPERM;
1110}
1111
1112/*
1113 * Called when an inode is about to be open.
1114 * We use this to disallow opening large files on 32bit systems if
1115 * the caller didn't specify O_LARGEFILE. On 64bit systems we force
1116 * on this flag in sys_open.
1117 */
1118int generic_file_open(struct inode * inode, struct file * filp)
1119{
1120 if (!(filp->f_flags & O_LARGEFILE) && i_size_read(inode) > MAX_NON_LFS)
1121 return -EOVERFLOW;
1122 return 0;
1123}
1124
1125EXPORT_SYMBOL(generic_file_open);
1126
1127/*
1128 * This is used by subsystems that don't want seekable
1129 * file descriptors. The function is not supposed to ever fail, the only
1130 * reason it returns an 'int' and not 'void' is so that it can be plugged
1131 * directly into file_operations structure.
1132 */
1133int nonseekable_open(struct inode *inode, struct file *filp)
1134{
1135 filp->f_mode &= ~(FMODE_LSEEK | FMODE_PREAD | FMODE_PWRITE);
1136 return 0;
1137}
1138
1139EXPORT_SYMBOL(nonseekable_open);
1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * linux/fs/open.c
4 *
5 * Copyright (C) 1991, 1992 Linus Torvalds
6 */
7
8#include <linux/string.h>
9#include <linux/mm.h>
10#include <linux/file.h>
11#include <linux/fdtable.h>
12#include <linux/fsnotify.h>
13#include <linux/module.h>
14#include <linux/tty.h>
15#include <linux/namei.h>
16#include <linux/backing-dev.h>
17#include <linux/capability.h>
18#include <linux/securebits.h>
19#include <linux/security.h>
20#include <linux/mount.h>
21#include <linux/fcntl.h>
22#include <linux/slab.h>
23#include <linux/uaccess.h>
24#include <linux/fs.h>
25#include <linux/personality.h>
26#include <linux/pagemap.h>
27#include <linux/syscalls.h>
28#include <linux/rcupdate.h>
29#include <linux/audit.h>
30#include <linux/falloc.h>
31#include <linux/fs_struct.h>
32#include <linux/ima.h>
33#include <linux/dnotify.h>
34#include <linux/compat.h>
35#include <linux/mnt_idmapping.h>
36#include <linux/filelock.h>
37
38#include "internal.h"
39
40int do_truncate(struct mnt_idmap *idmap, struct dentry *dentry,
41 loff_t length, unsigned int time_attrs, struct file *filp)
42{
43 int ret;
44 struct iattr newattrs;
45
46 /* Not pretty: "inode->i_size" shouldn't really be signed. But it is. */
47 if (length < 0)
48 return -EINVAL;
49
50 newattrs.ia_size = length;
51 newattrs.ia_valid = ATTR_SIZE | time_attrs;
52 if (filp) {
53 newattrs.ia_file = filp;
54 newattrs.ia_valid |= ATTR_FILE;
55 }
56
57 /* Remove suid, sgid, and file capabilities on truncate too */
58 ret = dentry_needs_remove_privs(idmap, dentry);
59 if (ret < 0)
60 return ret;
61 if (ret)
62 newattrs.ia_valid |= ret | ATTR_FORCE;
63
64 inode_lock(dentry->d_inode);
65 /* Note any delegations or leases have already been broken: */
66 ret = notify_change(idmap, dentry, &newattrs, NULL);
67 inode_unlock(dentry->d_inode);
68 return ret;
69}
70
71long vfs_truncate(const struct path *path, loff_t length)
72{
73 struct mnt_idmap *idmap;
74 struct inode *inode;
75 long error;
76
77 inode = path->dentry->d_inode;
78
79 /* For directories it's -EISDIR, for other non-regulars - -EINVAL */
80 if (S_ISDIR(inode->i_mode))
81 return -EISDIR;
82 if (!S_ISREG(inode->i_mode))
83 return -EINVAL;
84
85 error = mnt_want_write(path->mnt);
86 if (error)
87 goto out;
88
89 idmap = mnt_idmap(path->mnt);
90 error = inode_permission(idmap, inode, MAY_WRITE);
91 if (error)
92 goto mnt_drop_write_and_out;
93
94 error = -EPERM;
95 if (IS_APPEND(inode))
96 goto mnt_drop_write_and_out;
97
98 error = get_write_access(inode);
99 if (error)
100 goto mnt_drop_write_and_out;
101
102 /*
103 * Make sure that there are no leases. get_write_access() protects
104 * against the truncate racing with a lease-granting setlease().
105 */
106 error = break_lease(inode, O_WRONLY);
107 if (error)
108 goto put_write_and_out;
109
110 error = security_path_truncate(path);
111 if (!error)
112 error = do_truncate(idmap, path->dentry, length, 0, NULL);
113
114put_write_and_out:
115 put_write_access(inode);
116mnt_drop_write_and_out:
117 mnt_drop_write(path->mnt);
118out:
119 return error;
120}
121EXPORT_SYMBOL_GPL(vfs_truncate);
122
123long do_sys_truncate(const char __user *pathname, loff_t length)
124{
125 unsigned int lookup_flags = LOOKUP_FOLLOW;
126 struct path path;
127 int error;
128
129 if (length < 0) /* sorry, but loff_t says... */
130 return -EINVAL;
131
132retry:
133 error = user_path_at(AT_FDCWD, pathname, lookup_flags, &path);
134 if (!error) {
135 error = vfs_truncate(&path, length);
136 path_put(&path);
137 }
138 if (retry_estale(error, lookup_flags)) {
139 lookup_flags |= LOOKUP_REVAL;
140 goto retry;
141 }
142 return error;
143}
144
145SYSCALL_DEFINE2(truncate, const char __user *, path, long, length)
146{
147 return do_sys_truncate(path, length);
148}
149
150#ifdef CONFIG_COMPAT
151COMPAT_SYSCALL_DEFINE2(truncate, const char __user *, path, compat_off_t, length)
152{
153 return do_sys_truncate(path, length);
154}
155#endif
156
157long do_sys_ftruncate(unsigned int fd, loff_t length, int small)
158{
159 struct inode *inode;
160 struct dentry *dentry;
161 struct fd f;
162 int error;
163
164 error = -EINVAL;
165 if (length < 0)
166 goto out;
167 error = -EBADF;
168 f = fdget(fd);
169 if (!f.file)
170 goto out;
171
172 /* explicitly opened as large or we are on 64-bit box */
173 if (f.file->f_flags & O_LARGEFILE)
174 small = 0;
175
176 dentry = f.file->f_path.dentry;
177 inode = dentry->d_inode;
178 error = -EINVAL;
179 if (!S_ISREG(inode->i_mode) || !(f.file->f_mode & FMODE_WRITE))
180 goto out_putf;
181
182 error = -EINVAL;
183 /* Cannot ftruncate over 2^31 bytes without large file support */
184 if (small && length > MAX_NON_LFS)
185 goto out_putf;
186
187 error = -EPERM;
188 /* Check IS_APPEND on real upper inode */
189 if (IS_APPEND(file_inode(f.file)))
190 goto out_putf;
191 sb_start_write(inode->i_sb);
192 error = security_file_truncate(f.file);
193 if (!error)
194 error = do_truncate(file_mnt_idmap(f.file), dentry, length,
195 ATTR_MTIME | ATTR_CTIME, f.file);
196 sb_end_write(inode->i_sb);
197out_putf:
198 fdput(f);
199out:
200 return error;
201}
202
203SYSCALL_DEFINE2(ftruncate, unsigned int, fd, unsigned long, length)
204{
205 return do_sys_ftruncate(fd, length, 1);
206}
207
208#ifdef CONFIG_COMPAT
209COMPAT_SYSCALL_DEFINE2(ftruncate, unsigned int, fd, compat_ulong_t, length)
210{
211 return do_sys_ftruncate(fd, length, 1);
212}
213#endif
214
215/* LFS versions of truncate are only needed on 32 bit machines */
216#if BITS_PER_LONG == 32
217SYSCALL_DEFINE2(truncate64, const char __user *, path, loff_t, length)
218{
219 return do_sys_truncate(path, length);
220}
221
222SYSCALL_DEFINE2(ftruncate64, unsigned int, fd, loff_t, length)
223{
224 return do_sys_ftruncate(fd, length, 0);
225}
226#endif /* BITS_PER_LONG == 32 */
227
228#if defined(CONFIG_COMPAT) && defined(__ARCH_WANT_COMPAT_TRUNCATE64)
229COMPAT_SYSCALL_DEFINE3(truncate64, const char __user *, pathname,
230 compat_arg_u64_dual(length))
231{
232 return ksys_truncate(pathname, compat_arg_u64_glue(length));
233}
234#endif
235
236#if defined(CONFIG_COMPAT) && defined(__ARCH_WANT_COMPAT_FTRUNCATE64)
237COMPAT_SYSCALL_DEFINE3(ftruncate64, unsigned int, fd,
238 compat_arg_u64_dual(length))
239{
240 return ksys_ftruncate(fd, compat_arg_u64_glue(length));
241}
242#endif
243
244int vfs_fallocate(struct file *file, int mode, loff_t offset, loff_t len)
245{
246 struct inode *inode = file_inode(file);
247 long ret;
248
249 if (offset < 0 || len <= 0)
250 return -EINVAL;
251
252 /* Return error if mode is not supported */
253 if (mode & ~FALLOC_FL_SUPPORTED_MASK)
254 return -EOPNOTSUPP;
255
256 /* Punch hole and zero range are mutually exclusive */
257 if ((mode & (FALLOC_FL_PUNCH_HOLE | FALLOC_FL_ZERO_RANGE)) ==
258 (FALLOC_FL_PUNCH_HOLE | FALLOC_FL_ZERO_RANGE))
259 return -EOPNOTSUPP;
260
261 /* Punch hole must have keep size set */
262 if ((mode & FALLOC_FL_PUNCH_HOLE) &&
263 !(mode & FALLOC_FL_KEEP_SIZE))
264 return -EOPNOTSUPP;
265
266 /* Collapse range should only be used exclusively. */
267 if ((mode & FALLOC_FL_COLLAPSE_RANGE) &&
268 (mode & ~FALLOC_FL_COLLAPSE_RANGE))
269 return -EINVAL;
270
271 /* Insert range should only be used exclusively. */
272 if ((mode & FALLOC_FL_INSERT_RANGE) &&
273 (mode & ~FALLOC_FL_INSERT_RANGE))
274 return -EINVAL;
275
276 /* Unshare range should only be used with allocate mode. */
277 if ((mode & FALLOC_FL_UNSHARE_RANGE) &&
278 (mode & ~(FALLOC_FL_UNSHARE_RANGE | FALLOC_FL_KEEP_SIZE)))
279 return -EINVAL;
280
281 if (!(file->f_mode & FMODE_WRITE))
282 return -EBADF;
283
284 /*
285 * We can only allow pure fallocate on append only files
286 */
287 if ((mode & ~FALLOC_FL_KEEP_SIZE) && IS_APPEND(inode))
288 return -EPERM;
289
290 if (IS_IMMUTABLE(inode))
291 return -EPERM;
292
293 /*
294 * We cannot allow any fallocate operation on an active swapfile
295 */
296 if (IS_SWAPFILE(inode))
297 return -ETXTBSY;
298
299 /*
300 * Revalidate the write permissions, in case security policy has
301 * changed since the files were opened.
302 */
303 ret = security_file_permission(file, MAY_WRITE);
304 if (ret)
305 return ret;
306
307 ret = fsnotify_file_area_perm(file, MAY_WRITE, &offset, len);
308 if (ret)
309 return ret;
310
311 if (S_ISFIFO(inode->i_mode))
312 return -ESPIPE;
313
314 if (S_ISDIR(inode->i_mode))
315 return -EISDIR;
316
317 if (!S_ISREG(inode->i_mode) && !S_ISBLK(inode->i_mode))
318 return -ENODEV;
319
320 /* Check for wrap through zero too */
321 if (((offset + len) > inode->i_sb->s_maxbytes) || ((offset + len) < 0))
322 return -EFBIG;
323
324 if (!file->f_op->fallocate)
325 return -EOPNOTSUPP;
326
327 file_start_write(file);
328 ret = file->f_op->fallocate(file, mode, offset, len);
329
330 /*
331 * Create inotify and fanotify events.
332 *
333 * To keep the logic simple always create events if fallocate succeeds.
334 * This implies that events are even created if the file size remains
335 * unchanged, e.g. when using flag FALLOC_FL_KEEP_SIZE.
336 */
337 if (ret == 0)
338 fsnotify_modify(file);
339
340 file_end_write(file);
341 return ret;
342}
343EXPORT_SYMBOL_GPL(vfs_fallocate);
344
345int ksys_fallocate(int fd, int mode, loff_t offset, loff_t len)
346{
347 struct fd f = fdget(fd);
348 int error = -EBADF;
349
350 if (f.file) {
351 error = vfs_fallocate(f.file, mode, offset, len);
352 fdput(f);
353 }
354 return error;
355}
356
357SYSCALL_DEFINE4(fallocate, int, fd, int, mode, loff_t, offset, loff_t, len)
358{
359 return ksys_fallocate(fd, mode, offset, len);
360}
361
362#if defined(CONFIG_COMPAT) && defined(__ARCH_WANT_COMPAT_FALLOCATE)
363COMPAT_SYSCALL_DEFINE6(fallocate, int, fd, int, mode, compat_arg_u64_dual(offset),
364 compat_arg_u64_dual(len))
365{
366 return ksys_fallocate(fd, mode, compat_arg_u64_glue(offset),
367 compat_arg_u64_glue(len));
368}
369#endif
370
371/*
372 * access() needs to use the real uid/gid, not the effective uid/gid.
373 * We do this by temporarily clearing all FS-related capabilities and
374 * switching the fsuid/fsgid around to the real ones.
375 *
376 * Creating new credentials is expensive, so we try to skip doing it,
377 * which we can if the result would match what we already got.
378 */
379static bool access_need_override_creds(int flags)
380{
381 const struct cred *cred;
382
383 if (flags & AT_EACCESS)
384 return false;
385
386 cred = current_cred();
387 if (!uid_eq(cred->fsuid, cred->uid) ||
388 !gid_eq(cred->fsgid, cred->gid))
389 return true;
390
391 if (!issecure(SECURE_NO_SETUID_FIXUP)) {
392 kuid_t root_uid = make_kuid(cred->user_ns, 0);
393 if (!uid_eq(cred->uid, root_uid)) {
394 if (!cap_isclear(cred->cap_effective))
395 return true;
396 } else {
397 if (!cap_isidentical(cred->cap_effective,
398 cred->cap_permitted))
399 return true;
400 }
401 }
402
403 return false;
404}
405
406static const struct cred *access_override_creds(void)
407{
408 const struct cred *old_cred;
409 struct cred *override_cred;
410
411 override_cred = prepare_creds();
412 if (!override_cred)
413 return NULL;
414
415 /*
416 * XXX access_need_override_creds performs checks in hopes of skipping
417 * this work. Make sure it stays in sync if making any changes in this
418 * routine.
419 */
420
421 override_cred->fsuid = override_cred->uid;
422 override_cred->fsgid = override_cred->gid;
423
424 if (!issecure(SECURE_NO_SETUID_FIXUP)) {
425 /* Clear the capabilities if we switch to a non-root user */
426 kuid_t root_uid = make_kuid(override_cred->user_ns, 0);
427 if (!uid_eq(override_cred->uid, root_uid))
428 cap_clear(override_cred->cap_effective);
429 else
430 override_cred->cap_effective =
431 override_cred->cap_permitted;
432 }
433
434 /*
435 * The new set of credentials can *only* be used in
436 * task-synchronous circumstances, and does not need
437 * RCU freeing, unless somebody then takes a separate
438 * reference to it.
439 *
440 * NOTE! This is _only_ true because this credential
441 * is used purely for override_creds() that installs
442 * it as the subjective cred. Other threads will be
443 * accessing ->real_cred, not the subjective cred.
444 *
445 * If somebody _does_ make a copy of this (using the
446 * 'get_current_cred()' function), that will clear the
447 * non_rcu field, because now that other user may be
448 * expecting RCU freeing. But normal thread-synchronous
449 * cred accesses will keep things non-racy to avoid RCU
450 * freeing.
451 */
452 override_cred->non_rcu = 1;
453
454 old_cred = override_creds(override_cred);
455
456 /* override_cred() gets its own ref */
457 put_cred(override_cred);
458
459 return old_cred;
460}
461
462static long do_faccessat(int dfd, const char __user *filename, int mode, int flags)
463{
464 struct path path;
465 struct inode *inode;
466 int res;
467 unsigned int lookup_flags = LOOKUP_FOLLOW;
468 const struct cred *old_cred = NULL;
469
470 if (mode & ~S_IRWXO) /* where's F_OK, X_OK, W_OK, R_OK? */
471 return -EINVAL;
472
473 if (flags & ~(AT_EACCESS | AT_SYMLINK_NOFOLLOW | AT_EMPTY_PATH))
474 return -EINVAL;
475
476 if (flags & AT_SYMLINK_NOFOLLOW)
477 lookup_flags &= ~LOOKUP_FOLLOW;
478 if (flags & AT_EMPTY_PATH)
479 lookup_flags |= LOOKUP_EMPTY;
480
481 if (access_need_override_creds(flags)) {
482 old_cred = access_override_creds();
483 if (!old_cred)
484 return -ENOMEM;
485 }
486
487retry:
488 res = user_path_at(dfd, filename, lookup_flags, &path);
489 if (res)
490 goto out;
491
492 inode = d_backing_inode(path.dentry);
493
494 if ((mode & MAY_EXEC) && S_ISREG(inode->i_mode)) {
495 /*
496 * MAY_EXEC on regular files is denied if the fs is mounted
497 * with the "noexec" flag.
498 */
499 res = -EACCES;
500 if (path_noexec(&path))
501 goto out_path_release;
502 }
503
504 res = inode_permission(mnt_idmap(path.mnt), inode, mode | MAY_ACCESS);
505 /* SuS v2 requires we report a read only fs too */
506 if (res || !(mode & S_IWOTH) || special_file(inode->i_mode))
507 goto out_path_release;
508 /*
509 * This is a rare case where using __mnt_is_readonly()
510 * is OK without a mnt_want/drop_write() pair. Since
511 * no actual write to the fs is performed here, we do
512 * not need to telegraph to that to anyone.
513 *
514 * By doing this, we accept that this access is
515 * inherently racy and know that the fs may change
516 * state before we even see this result.
517 */
518 if (__mnt_is_readonly(path.mnt))
519 res = -EROFS;
520
521out_path_release:
522 path_put(&path);
523 if (retry_estale(res, lookup_flags)) {
524 lookup_flags |= LOOKUP_REVAL;
525 goto retry;
526 }
527out:
528 if (old_cred)
529 revert_creds(old_cred);
530
531 return res;
532}
533
534SYSCALL_DEFINE3(faccessat, int, dfd, const char __user *, filename, int, mode)
535{
536 return do_faccessat(dfd, filename, mode, 0);
537}
538
539SYSCALL_DEFINE4(faccessat2, int, dfd, const char __user *, filename, int, mode,
540 int, flags)
541{
542 return do_faccessat(dfd, filename, mode, flags);
543}
544
545SYSCALL_DEFINE2(access, const char __user *, filename, int, mode)
546{
547 return do_faccessat(AT_FDCWD, filename, mode, 0);
548}
549
550SYSCALL_DEFINE1(chdir, const char __user *, filename)
551{
552 struct path path;
553 int error;
554 unsigned int lookup_flags = LOOKUP_FOLLOW | LOOKUP_DIRECTORY;
555retry:
556 error = user_path_at(AT_FDCWD, filename, lookup_flags, &path);
557 if (error)
558 goto out;
559
560 error = path_permission(&path, MAY_EXEC | MAY_CHDIR);
561 if (error)
562 goto dput_and_out;
563
564 set_fs_pwd(current->fs, &path);
565
566dput_and_out:
567 path_put(&path);
568 if (retry_estale(error, lookup_flags)) {
569 lookup_flags |= LOOKUP_REVAL;
570 goto retry;
571 }
572out:
573 return error;
574}
575
576SYSCALL_DEFINE1(fchdir, unsigned int, fd)
577{
578 struct fd f = fdget_raw(fd);
579 int error;
580
581 error = -EBADF;
582 if (!f.file)
583 goto out;
584
585 error = -ENOTDIR;
586 if (!d_can_lookup(f.file->f_path.dentry))
587 goto out_putf;
588
589 error = file_permission(f.file, MAY_EXEC | MAY_CHDIR);
590 if (!error)
591 set_fs_pwd(current->fs, &f.file->f_path);
592out_putf:
593 fdput(f);
594out:
595 return error;
596}
597
598SYSCALL_DEFINE1(chroot, const char __user *, filename)
599{
600 struct path path;
601 int error;
602 unsigned int lookup_flags = LOOKUP_FOLLOW | LOOKUP_DIRECTORY;
603retry:
604 error = user_path_at(AT_FDCWD, filename, lookup_flags, &path);
605 if (error)
606 goto out;
607
608 error = path_permission(&path, MAY_EXEC | MAY_CHDIR);
609 if (error)
610 goto dput_and_out;
611
612 error = -EPERM;
613 if (!ns_capable(current_user_ns(), CAP_SYS_CHROOT))
614 goto dput_and_out;
615 error = security_path_chroot(&path);
616 if (error)
617 goto dput_and_out;
618
619 set_fs_root(current->fs, &path);
620 error = 0;
621dput_and_out:
622 path_put(&path);
623 if (retry_estale(error, lookup_flags)) {
624 lookup_flags |= LOOKUP_REVAL;
625 goto retry;
626 }
627out:
628 return error;
629}
630
631int chmod_common(const struct path *path, umode_t mode)
632{
633 struct inode *inode = path->dentry->d_inode;
634 struct inode *delegated_inode = NULL;
635 struct iattr newattrs;
636 int error;
637
638 error = mnt_want_write(path->mnt);
639 if (error)
640 return error;
641retry_deleg:
642 inode_lock(inode);
643 error = security_path_chmod(path, mode);
644 if (error)
645 goto out_unlock;
646 newattrs.ia_mode = (mode & S_IALLUGO) | (inode->i_mode & ~S_IALLUGO);
647 newattrs.ia_valid = ATTR_MODE | ATTR_CTIME;
648 error = notify_change(mnt_idmap(path->mnt), path->dentry,
649 &newattrs, &delegated_inode);
650out_unlock:
651 inode_unlock(inode);
652 if (delegated_inode) {
653 error = break_deleg_wait(&delegated_inode);
654 if (!error)
655 goto retry_deleg;
656 }
657 mnt_drop_write(path->mnt);
658 return error;
659}
660
661int vfs_fchmod(struct file *file, umode_t mode)
662{
663 audit_file(file);
664 return chmod_common(&file->f_path, mode);
665}
666
667SYSCALL_DEFINE2(fchmod, unsigned int, fd, umode_t, mode)
668{
669 struct fd f = fdget(fd);
670 int err = -EBADF;
671
672 if (f.file) {
673 err = vfs_fchmod(f.file, mode);
674 fdput(f);
675 }
676 return err;
677}
678
679static int do_fchmodat(int dfd, const char __user *filename, umode_t mode,
680 unsigned int flags)
681{
682 struct path path;
683 int error;
684 unsigned int lookup_flags;
685
686 if (unlikely(flags & ~(AT_SYMLINK_NOFOLLOW | AT_EMPTY_PATH)))
687 return -EINVAL;
688
689 lookup_flags = (flags & AT_SYMLINK_NOFOLLOW) ? 0 : LOOKUP_FOLLOW;
690 if (flags & AT_EMPTY_PATH)
691 lookup_flags |= LOOKUP_EMPTY;
692
693retry:
694 error = user_path_at(dfd, filename, lookup_flags, &path);
695 if (!error) {
696 error = chmod_common(&path, mode);
697 path_put(&path);
698 if (retry_estale(error, lookup_flags)) {
699 lookup_flags |= LOOKUP_REVAL;
700 goto retry;
701 }
702 }
703 return error;
704}
705
706SYSCALL_DEFINE4(fchmodat2, int, dfd, const char __user *, filename,
707 umode_t, mode, unsigned int, flags)
708{
709 return do_fchmodat(dfd, filename, mode, flags);
710}
711
712SYSCALL_DEFINE3(fchmodat, int, dfd, const char __user *, filename,
713 umode_t, mode)
714{
715 return do_fchmodat(dfd, filename, mode, 0);
716}
717
718SYSCALL_DEFINE2(chmod, const char __user *, filename, umode_t, mode)
719{
720 return do_fchmodat(AT_FDCWD, filename, mode, 0);
721}
722
723/*
724 * Check whether @kuid is valid and if so generate and set vfsuid_t in
725 * ia_vfsuid.
726 *
727 * Return: true if @kuid is valid, false if not.
728 */
729static inline bool setattr_vfsuid(struct iattr *attr, kuid_t kuid)
730{
731 if (!uid_valid(kuid))
732 return false;
733 attr->ia_valid |= ATTR_UID;
734 attr->ia_vfsuid = VFSUIDT_INIT(kuid);
735 return true;
736}
737
738/*
739 * Check whether @kgid is valid and if so generate and set vfsgid_t in
740 * ia_vfsgid.
741 *
742 * Return: true if @kgid is valid, false if not.
743 */
744static inline bool setattr_vfsgid(struct iattr *attr, kgid_t kgid)
745{
746 if (!gid_valid(kgid))
747 return false;
748 attr->ia_valid |= ATTR_GID;
749 attr->ia_vfsgid = VFSGIDT_INIT(kgid);
750 return true;
751}
752
753int chown_common(const struct path *path, uid_t user, gid_t group)
754{
755 struct mnt_idmap *idmap;
756 struct user_namespace *fs_userns;
757 struct inode *inode = path->dentry->d_inode;
758 struct inode *delegated_inode = NULL;
759 int error;
760 struct iattr newattrs;
761 kuid_t uid;
762 kgid_t gid;
763
764 uid = make_kuid(current_user_ns(), user);
765 gid = make_kgid(current_user_ns(), group);
766
767 idmap = mnt_idmap(path->mnt);
768 fs_userns = i_user_ns(inode);
769
770retry_deleg:
771 newattrs.ia_vfsuid = INVALID_VFSUID;
772 newattrs.ia_vfsgid = INVALID_VFSGID;
773 newattrs.ia_valid = ATTR_CTIME;
774 if ((user != (uid_t)-1) && !setattr_vfsuid(&newattrs, uid))
775 return -EINVAL;
776 if ((group != (gid_t)-1) && !setattr_vfsgid(&newattrs, gid))
777 return -EINVAL;
778 inode_lock(inode);
779 if (!S_ISDIR(inode->i_mode))
780 newattrs.ia_valid |= ATTR_KILL_SUID | ATTR_KILL_PRIV |
781 setattr_should_drop_sgid(idmap, inode);
782 /* Continue to send actual fs values, not the mount values. */
783 error = security_path_chown(
784 path,
785 from_vfsuid(idmap, fs_userns, newattrs.ia_vfsuid),
786 from_vfsgid(idmap, fs_userns, newattrs.ia_vfsgid));
787 if (!error)
788 error = notify_change(idmap, path->dentry, &newattrs,
789 &delegated_inode);
790 inode_unlock(inode);
791 if (delegated_inode) {
792 error = break_deleg_wait(&delegated_inode);
793 if (!error)
794 goto retry_deleg;
795 }
796 return error;
797}
798
799int do_fchownat(int dfd, const char __user *filename, uid_t user, gid_t group,
800 int flag)
801{
802 struct path path;
803 int error = -EINVAL;
804 int lookup_flags;
805
806 if ((flag & ~(AT_SYMLINK_NOFOLLOW | AT_EMPTY_PATH)) != 0)
807 goto out;
808
809 lookup_flags = (flag & AT_SYMLINK_NOFOLLOW) ? 0 : LOOKUP_FOLLOW;
810 if (flag & AT_EMPTY_PATH)
811 lookup_flags |= LOOKUP_EMPTY;
812retry:
813 error = user_path_at(dfd, filename, lookup_flags, &path);
814 if (error)
815 goto out;
816 error = mnt_want_write(path.mnt);
817 if (error)
818 goto out_release;
819 error = chown_common(&path, user, group);
820 mnt_drop_write(path.mnt);
821out_release:
822 path_put(&path);
823 if (retry_estale(error, lookup_flags)) {
824 lookup_flags |= LOOKUP_REVAL;
825 goto retry;
826 }
827out:
828 return error;
829}
830
831SYSCALL_DEFINE5(fchownat, int, dfd, const char __user *, filename, uid_t, user,
832 gid_t, group, int, flag)
833{
834 return do_fchownat(dfd, filename, user, group, flag);
835}
836
837SYSCALL_DEFINE3(chown, const char __user *, filename, uid_t, user, gid_t, group)
838{
839 return do_fchownat(AT_FDCWD, filename, user, group, 0);
840}
841
842SYSCALL_DEFINE3(lchown, const char __user *, filename, uid_t, user, gid_t, group)
843{
844 return do_fchownat(AT_FDCWD, filename, user, group,
845 AT_SYMLINK_NOFOLLOW);
846}
847
848int vfs_fchown(struct file *file, uid_t user, gid_t group)
849{
850 int error;
851
852 error = mnt_want_write_file(file);
853 if (error)
854 return error;
855 audit_file(file);
856 error = chown_common(&file->f_path, user, group);
857 mnt_drop_write_file(file);
858 return error;
859}
860
861int ksys_fchown(unsigned int fd, uid_t user, gid_t group)
862{
863 struct fd f = fdget(fd);
864 int error = -EBADF;
865
866 if (f.file) {
867 error = vfs_fchown(f.file, user, group);
868 fdput(f);
869 }
870 return error;
871}
872
873SYSCALL_DEFINE3(fchown, unsigned int, fd, uid_t, user, gid_t, group)
874{
875 return ksys_fchown(fd, user, group);
876}
877
878static inline int file_get_write_access(struct file *f)
879{
880 int error;
881
882 error = get_write_access(f->f_inode);
883 if (unlikely(error))
884 return error;
885 error = mnt_get_write_access(f->f_path.mnt);
886 if (unlikely(error))
887 goto cleanup_inode;
888 if (unlikely(f->f_mode & FMODE_BACKING)) {
889 error = mnt_get_write_access(backing_file_user_path(f)->mnt);
890 if (unlikely(error))
891 goto cleanup_mnt;
892 }
893 return 0;
894
895cleanup_mnt:
896 mnt_put_write_access(f->f_path.mnt);
897cleanup_inode:
898 put_write_access(f->f_inode);
899 return error;
900}
901
902static int do_dentry_open(struct file *f,
903 struct inode *inode,
904 int (*open)(struct inode *, struct file *))
905{
906 static const struct file_operations empty_fops = {};
907 int error;
908
909 path_get(&f->f_path);
910 f->f_inode = inode;
911 f->f_mapping = inode->i_mapping;
912 f->f_wb_err = filemap_sample_wb_err(f->f_mapping);
913 f->f_sb_err = file_sample_sb_err(f);
914
915 if (unlikely(f->f_flags & O_PATH)) {
916 f->f_mode = FMODE_PATH | FMODE_OPENED;
917 f->f_op = &empty_fops;
918 return 0;
919 }
920
921 if ((f->f_mode & (FMODE_READ | FMODE_WRITE)) == FMODE_READ) {
922 i_readcount_inc(inode);
923 } else if (f->f_mode & FMODE_WRITE && !special_file(inode->i_mode)) {
924 error = file_get_write_access(f);
925 if (unlikely(error))
926 goto cleanup_file;
927 f->f_mode |= FMODE_WRITER;
928 }
929
930 /* POSIX.1-2008/SUSv4 Section XSI 2.9.7 */
931 if (S_ISREG(inode->i_mode) || S_ISDIR(inode->i_mode))
932 f->f_mode |= FMODE_ATOMIC_POS;
933
934 f->f_op = fops_get(inode->i_fop);
935 if (WARN_ON(!f->f_op)) {
936 error = -ENODEV;
937 goto cleanup_all;
938 }
939
940 error = security_file_open(f);
941 if (error)
942 goto cleanup_all;
943
944 error = break_lease(file_inode(f), f->f_flags);
945 if (error)
946 goto cleanup_all;
947
948 /* normally all 3 are set; ->open() can clear them if needed */
949 f->f_mode |= FMODE_LSEEK | FMODE_PREAD | FMODE_PWRITE;
950 if (!open)
951 open = f->f_op->open;
952 if (open) {
953 error = open(inode, f);
954 if (error)
955 goto cleanup_all;
956 }
957 f->f_mode |= FMODE_OPENED;
958 if ((f->f_mode & FMODE_READ) &&
959 likely(f->f_op->read || f->f_op->read_iter))
960 f->f_mode |= FMODE_CAN_READ;
961 if ((f->f_mode & FMODE_WRITE) &&
962 likely(f->f_op->write || f->f_op->write_iter))
963 f->f_mode |= FMODE_CAN_WRITE;
964 if ((f->f_mode & FMODE_LSEEK) && !f->f_op->llseek)
965 f->f_mode &= ~FMODE_LSEEK;
966 if (f->f_mapping->a_ops && f->f_mapping->a_ops->direct_IO)
967 f->f_mode |= FMODE_CAN_ODIRECT;
968
969 f->f_flags &= ~(O_CREAT | O_EXCL | O_NOCTTY | O_TRUNC);
970 f->f_iocb_flags = iocb_flags(f);
971
972 file_ra_state_init(&f->f_ra, f->f_mapping->host->i_mapping);
973
974 if ((f->f_flags & O_DIRECT) && !(f->f_mode & FMODE_CAN_ODIRECT))
975 return -EINVAL;
976
977 /*
978 * XXX: Huge page cache doesn't support writing yet. Drop all page
979 * cache for this file before processing writes.
980 */
981 if (f->f_mode & FMODE_WRITE) {
982 /*
983 * Paired with smp_mb() in collapse_file() to ensure nr_thps
984 * is up to date and the update to i_writecount by
985 * get_write_access() is visible. Ensures subsequent insertion
986 * of THPs into the page cache will fail.
987 */
988 smp_mb();
989 if (filemap_nr_thps(inode->i_mapping)) {
990 struct address_space *mapping = inode->i_mapping;
991
992 filemap_invalidate_lock(inode->i_mapping);
993 /*
994 * unmap_mapping_range just need to be called once
995 * here, because the private pages is not need to be
996 * unmapped mapping (e.g. data segment of dynamic
997 * shared libraries here).
998 */
999 unmap_mapping_range(mapping, 0, 0, 0);
1000 truncate_inode_pages(mapping, 0);
1001 filemap_invalidate_unlock(inode->i_mapping);
1002 }
1003 }
1004
1005 /*
1006 * Once we return a file with FMODE_OPENED, __fput() will call
1007 * fsnotify_close(), so we need fsnotify_open() here for symmetry.
1008 */
1009 fsnotify_open(f);
1010 return 0;
1011
1012cleanup_all:
1013 if (WARN_ON_ONCE(error > 0))
1014 error = -EINVAL;
1015 fops_put(f->f_op);
1016 put_file_access(f);
1017cleanup_file:
1018 path_put(&f->f_path);
1019 f->f_path.mnt = NULL;
1020 f->f_path.dentry = NULL;
1021 f->f_inode = NULL;
1022 return error;
1023}
1024
1025/**
1026 * finish_open - finish opening a file
1027 * @file: file pointer
1028 * @dentry: pointer to dentry
1029 * @open: open callback
1030 *
1031 * This can be used to finish opening a file passed to i_op->atomic_open().
1032 *
1033 * If the open callback is set to NULL, then the standard f_op->open()
1034 * filesystem callback is substituted.
1035 *
1036 * NB: the dentry reference is _not_ consumed. If, for example, the dentry is
1037 * the return value of d_splice_alias(), then the caller needs to perform dput()
1038 * on it after finish_open().
1039 *
1040 * Returns zero on success or -errno if the open failed.
1041 */
1042int finish_open(struct file *file, struct dentry *dentry,
1043 int (*open)(struct inode *, struct file *))
1044{
1045 BUG_ON(file->f_mode & FMODE_OPENED); /* once it's opened, it's opened */
1046
1047 file->f_path.dentry = dentry;
1048 return do_dentry_open(file, d_backing_inode(dentry), open);
1049}
1050EXPORT_SYMBOL(finish_open);
1051
1052/**
1053 * finish_no_open - finish ->atomic_open() without opening the file
1054 *
1055 * @file: file pointer
1056 * @dentry: dentry or NULL (as returned from ->lookup())
1057 *
1058 * This can be used to set the result of a successful lookup in ->atomic_open().
1059 *
1060 * NB: unlike finish_open() this function does consume the dentry reference and
1061 * the caller need not dput() it.
1062 *
1063 * Returns "0" which must be the return value of ->atomic_open() after having
1064 * called this function.
1065 */
1066int finish_no_open(struct file *file, struct dentry *dentry)
1067{
1068 file->f_path.dentry = dentry;
1069 return 0;
1070}
1071EXPORT_SYMBOL(finish_no_open);
1072
1073char *file_path(struct file *filp, char *buf, int buflen)
1074{
1075 return d_path(&filp->f_path, buf, buflen);
1076}
1077EXPORT_SYMBOL(file_path);
1078
1079/**
1080 * vfs_open - open the file at the given path
1081 * @path: path to open
1082 * @file: newly allocated file with f_flag initialized
1083 */
1084int vfs_open(const struct path *path, struct file *file)
1085{
1086 file->f_path = *path;
1087 return do_dentry_open(file, d_backing_inode(path->dentry), NULL);
1088}
1089
1090struct file *dentry_open(const struct path *path, int flags,
1091 const struct cred *cred)
1092{
1093 int error;
1094 struct file *f;
1095
1096 /* We must always pass in a valid mount pointer. */
1097 BUG_ON(!path->mnt);
1098
1099 f = alloc_empty_file(flags, cred);
1100 if (!IS_ERR(f)) {
1101 error = vfs_open(path, f);
1102 if (error) {
1103 fput(f);
1104 f = ERR_PTR(error);
1105 }
1106 }
1107 return f;
1108}
1109EXPORT_SYMBOL(dentry_open);
1110
1111/**
1112 * dentry_create - Create and open a file
1113 * @path: path to create
1114 * @flags: O_ flags
1115 * @mode: mode bits for new file
1116 * @cred: credentials to use
1117 *
1118 * Caller must hold the parent directory's lock, and have prepared
1119 * a negative dentry, placed in @path->dentry, for the new file.
1120 *
1121 * Caller sets @path->mnt to the vfsmount of the filesystem where
1122 * the new file is to be created. The parent directory and the
1123 * negative dentry must reside on the same filesystem instance.
1124 *
1125 * On success, returns a "struct file *". Otherwise a ERR_PTR
1126 * is returned.
1127 */
1128struct file *dentry_create(const struct path *path, int flags, umode_t mode,
1129 const struct cred *cred)
1130{
1131 struct file *f;
1132 int error;
1133
1134 f = alloc_empty_file(flags, cred);
1135 if (IS_ERR(f))
1136 return f;
1137
1138 error = vfs_create(mnt_idmap(path->mnt),
1139 d_inode(path->dentry->d_parent),
1140 path->dentry, mode, true);
1141 if (!error)
1142 error = vfs_open(path, f);
1143
1144 if (unlikely(error)) {
1145 fput(f);
1146 return ERR_PTR(error);
1147 }
1148 return f;
1149}
1150EXPORT_SYMBOL(dentry_create);
1151
1152/**
1153 * kernel_file_open - open a file for kernel internal use
1154 * @path: path of the file to open
1155 * @flags: open flags
1156 * @inode: the inode
1157 * @cred: credentials for open
1158 *
1159 * Open a file for use by in-kernel consumers. The file is not accounted
1160 * against nr_files and must not be installed into the file descriptor
1161 * table.
1162 *
1163 * Return: Opened file on success, an error pointer on failure.
1164 */
1165struct file *kernel_file_open(const struct path *path, int flags,
1166 struct inode *inode, const struct cred *cred)
1167{
1168 struct file *f;
1169 int error;
1170
1171 f = alloc_empty_file_noaccount(flags, cred);
1172 if (IS_ERR(f))
1173 return f;
1174
1175 f->f_path = *path;
1176 error = do_dentry_open(f, inode, NULL);
1177 if (error) {
1178 fput(f);
1179 f = ERR_PTR(error);
1180 }
1181 return f;
1182}
1183EXPORT_SYMBOL_GPL(kernel_file_open);
1184
1185#define WILL_CREATE(flags) (flags & (O_CREAT | __O_TMPFILE))
1186#define O_PATH_FLAGS (O_DIRECTORY | O_NOFOLLOW | O_PATH | O_CLOEXEC)
1187
1188inline struct open_how build_open_how(int flags, umode_t mode)
1189{
1190 struct open_how how = {
1191 .flags = flags & VALID_OPEN_FLAGS,
1192 .mode = mode & S_IALLUGO,
1193 };
1194
1195 /* O_PATH beats everything else. */
1196 if (how.flags & O_PATH)
1197 how.flags &= O_PATH_FLAGS;
1198 /* Modes should only be set for create-like flags. */
1199 if (!WILL_CREATE(how.flags))
1200 how.mode = 0;
1201 return how;
1202}
1203
1204inline int build_open_flags(const struct open_how *how, struct open_flags *op)
1205{
1206 u64 flags = how->flags;
1207 u64 strip = __FMODE_NONOTIFY | O_CLOEXEC;
1208 int lookup_flags = 0;
1209 int acc_mode = ACC_MODE(flags);
1210
1211 BUILD_BUG_ON_MSG(upper_32_bits(VALID_OPEN_FLAGS),
1212 "struct open_flags doesn't yet handle flags > 32 bits");
1213
1214 /*
1215 * Strip flags that either shouldn't be set by userspace like
1216 * FMODE_NONOTIFY or that aren't relevant in determining struct
1217 * open_flags like O_CLOEXEC.
1218 */
1219 flags &= ~strip;
1220
1221 /*
1222 * Older syscalls implicitly clear all of the invalid flags or argument
1223 * values before calling build_open_flags(), but openat2(2) checks all
1224 * of its arguments.
1225 */
1226 if (flags & ~VALID_OPEN_FLAGS)
1227 return -EINVAL;
1228 if (how->resolve & ~VALID_RESOLVE_FLAGS)
1229 return -EINVAL;
1230
1231 /* Scoping flags are mutually exclusive. */
1232 if ((how->resolve & RESOLVE_BENEATH) && (how->resolve & RESOLVE_IN_ROOT))
1233 return -EINVAL;
1234
1235 /* Deal with the mode. */
1236 if (WILL_CREATE(flags)) {
1237 if (how->mode & ~S_IALLUGO)
1238 return -EINVAL;
1239 op->mode = how->mode | S_IFREG;
1240 } else {
1241 if (how->mode != 0)
1242 return -EINVAL;
1243 op->mode = 0;
1244 }
1245
1246 /*
1247 * Block bugs where O_DIRECTORY | O_CREAT created regular files.
1248 * Note, that blocking O_DIRECTORY | O_CREAT here also protects
1249 * O_TMPFILE below which requires O_DIRECTORY being raised.
1250 */
1251 if ((flags & (O_DIRECTORY | O_CREAT)) == (O_DIRECTORY | O_CREAT))
1252 return -EINVAL;
1253
1254 /* Now handle the creative implementation of O_TMPFILE. */
1255 if (flags & __O_TMPFILE) {
1256 /*
1257 * In order to ensure programs get explicit errors when trying
1258 * to use O_TMPFILE on old kernels we enforce that O_DIRECTORY
1259 * is raised alongside __O_TMPFILE.
1260 */
1261 if (!(flags & O_DIRECTORY))
1262 return -EINVAL;
1263 if (!(acc_mode & MAY_WRITE))
1264 return -EINVAL;
1265 }
1266 if (flags & O_PATH) {
1267 /* O_PATH only permits certain other flags to be set. */
1268 if (flags & ~O_PATH_FLAGS)
1269 return -EINVAL;
1270 acc_mode = 0;
1271 }
1272
1273 /*
1274 * O_SYNC is implemented as __O_SYNC|O_DSYNC. As many places only
1275 * check for O_DSYNC if the need any syncing at all we enforce it's
1276 * always set instead of having to deal with possibly weird behaviour
1277 * for malicious applications setting only __O_SYNC.
1278 */
1279 if (flags & __O_SYNC)
1280 flags |= O_DSYNC;
1281
1282 op->open_flag = flags;
1283
1284 /* O_TRUNC implies we need access checks for write permissions */
1285 if (flags & O_TRUNC)
1286 acc_mode |= MAY_WRITE;
1287
1288 /* Allow the LSM permission hook to distinguish append
1289 access from general write access. */
1290 if (flags & O_APPEND)
1291 acc_mode |= MAY_APPEND;
1292
1293 op->acc_mode = acc_mode;
1294
1295 op->intent = flags & O_PATH ? 0 : LOOKUP_OPEN;
1296
1297 if (flags & O_CREAT) {
1298 op->intent |= LOOKUP_CREATE;
1299 if (flags & O_EXCL) {
1300 op->intent |= LOOKUP_EXCL;
1301 flags |= O_NOFOLLOW;
1302 }
1303 }
1304
1305 if (flags & O_DIRECTORY)
1306 lookup_flags |= LOOKUP_DIRECTORY;
1307 if (!(flags & O_NOFOLLOW))
1308 lookup_flags |= LOOKUP_FOLLOW;
1309
1310 if (how->resolve & RESOLVE_NO_XDEV)
1311 lookup_flags |= LOOKUP_NO_XDEV;
1312 if (how->resolve & RESOLVE_NO_MAGICLINKS)
1313 lookup_flags |= LOOKUP_NO_MAGICLINKS;
1314 if (how->resolve & RESOLVE_NO_SYMLINKS)
1315 lookup_flags |= LOOKUP_NO_SYMLINKS;
1316 if (how->resolve & RESOLVE_BENEATH)
1317 lookup_flags |= LOOKUP_BENEATH;
1318 if (how->resolve & RESOLVE_IN_ROOT)
1319 lookup_flags |= LOOKUP_IN_ROOT;
1320 if (how->resolve & RESOLVE_CACHED) {
1321 /* Don't bother even trying for create/truncate/tmpfile open */
1322 if (flags & (O_TRUNC | O_CREAT | __O_TMPFILE))
1323 return -EAGAIN;
1324 lookup_flags |= LOOKUP_CACHED;
1325 }
1326
1327 op->lookup_flags = lookup_flags;
1328 return 0;
1329}
1330
1331/**
1332 * file_open_name - open file and return file pointer
1333 *
1334 * @name: struct filename containing path to open
1335 * @flags: open flags as per the open(2) second argument
1336 * @mode: mode for the new file if O_CREAT is set, else ignored
1337 *
1338 * This is the helper to open a file from kernelspace if you really
1339 * have to. But in generally you should not do this, so please move
1340 * along, nothing to see here..
1341 */
1342struct file *file_open_name(struct filename *name, int flags, umode_t mode)
1343{
1344 struct open_flags op;
1345 struct open_how how = build_open_how(flags, mode);
1346 int err = build_open_flags(&how, &op);
1347 if (err)
1348 return ERR_PTR(err);
1349 return do_filp_open(AT_FDCWD, name, &op);
1350}
1351
1352/**
1353 * filp_open - open file and return file pointer
1354 *
1355 * @filename: path to open
1356 * @flags: open flags as per the open(2) second argument
1357 * @mode: mode for the new file if O_CREAT is set, else ignored
1358 *
1359 * This is the helper to open a file from kernelspace if you really
1360 * have to. But in generally you should not do this, so please move
1361 * along, nothing to see here..
1362 */
1363struct file *filp_open(const char *filename, int flags, umode_t mode)
1364{
1365 struct filename *name = getname_kernel(filename);
1366 struct file *file = ERR_CAST(name);
1367
1368 if (!IS_ERR(name)) {
1369 file = file_open_name(name, flags, mode);
1370 putname(name);
1371 }
1372 return file;
1373}
1374EXPORT_SYMBOL(filp_open);
1375
1376struct file *file_open_root(const struct path *root,
1377 const char *filename, int flags, umode_t mode)
1378{
1379 struct open_flags op;
1380 struct open_how how = build_open_how(flags, mode);
1381 int err = build_open_flags(&how, &op);
1382 if (err)
1383 return ERR_PTR(err);
1384 return do_file_open_root(root, filename, &op);
1385}
1386EXPORT_SYMBOL(file_open_root);
1387
1388static long do_sys_openat2(int dfd, const char __user *filename,
1389 struct open_how *how)
1390{
1391 struct open_flags op;
1392 int fd = build_open_flags(how, &op);
1393 struct filename *tmp;
1394
1395 if (fd)
1396 return fd;
1397
1398 tmp = getname(filename);
1399 if (IS_ERR(tmp))
1400 return PTR_ERR(tmp);
1401
1402 fd = get_unused_fd_flags(how->flags);
1403 if (fd >= 0) {
1404 struct file *f = do_filp_open(dfd, tmp, &op);
1405 if (IS_ERR(f)) {
1406 put_unused_fd(fd);
1407 fd = PTR_ERR(f);
1408 } else {
1409 fd_install(fd, f);
1410 }
1411 }
1412 putname(tmp);
1413 return fd;
1414}
1415
1416long do_sys_open(int dfd, const char __user *filename, int flags, umode_t mode)
1417{
1418 struct open_how how = build_open_how(flags, mode);
1419 return do_sys_openat2(dfd, filename, &how);
1420}
1421
1422
1423SYSCALL_DEFINE3(open, const char __user *, filename, int, flags, umode_t, mode)
1424{
1425 if (force_o_largefile())
1426 flags |= O_LARGEFILE;
1427 return do_sys_open(AT_FDCWD, filename, flags, mode);
1428}
1429
1430SYSCALL_DEFINE4(openat, int, dfd, const char __user *, filename, int, flags,
1431 umode_t, mode)
1432{
1433 if (force_o_largefile())
1434 flags |= O_LARGEFILE;
1435 return do_sys_open(dfd, filename, flags, mode);
1436}
1437
1438SYSCALL_DEFINE4(openat2, int, dfd, const char __user *, filename,
1439 struct open_how __user *, how, size_t, usize)
1440{
1441 int err;
1442 struct open_how tmp;
1443
1444 BUILD_BUG_ON(sizeof(struct open_how) < OPEN_HOW_SIZE_VER0);
1445 BUILD_BUG_ON(sizeof(struct open_how) != OPEN_HOW_SIZE_LATEST);
1446
1447 if (unlikely(usize < OPEN_HOW_SIZE_VER0))
1448 return -EINVAL;
1449
1450 err = copy_struct_from_user(&tmp, sizeof(tmp), how, usize);
1451 if (err)
1452 return err;
1453
1454 audit_openat2_how(&tmp);
1455
1456 /* O_LARGEFILE is only allowed for non-O_PATH. */
1457 if (!(tmp.flags & O_PATH) && force_o_largefile())
1458 tmp.flags |= O_LARGEFILE;
1459
1460 return do_sys_openat2(dfd, filename, &tmp);
1461}
1462
1463#ifdef CONFIG_COMPAT
1464/*
1465 * Exactly like sys_open(), except that it doesn't set the
1466 * O_LARGEFILE flag.
1467 */
1468COMPAT_SYSCALL_DEFINE3(open, const char __user *, filename, int, flags, umode_t, mode)
1469{
1470 return do_sys_open(AT_FDCWD, filename, flags, mode);
1471}
1472
1473/*
1474 * Exactly like sys_openat(), except that it doesn't set the
1475 * O_LARGEFILE flag.
1476 */
1477COMPAT_SYSCALL_DEFINE4(openat, int, dfd, const char __user *, filename, int, flags, umode_t, mode)
1478{
1479 return do_sys_open(dfd, filename, flags, mode);
1480}
1481#endif
1482
1483#ifndef __alpha__
1484
1485/*
1486 * For backward compatibility? Maybe this should be moved
1487 * into arch/i386 instead?
1488 */
1489SYSCALL_DEFINE2(creat, const char __user *, pathname, umode_t, mode)
1490{
1491 int flags = O_CREAT | O_WRONLY | O_TRUNC;
1492
1493 if (force_o_largefile())
1494 flags |= O_LARGEFILE;
1495 return do_sys_open(AT_FDCWD, pathname, flags, mode);
1496}
1497#endif
1498
1499/*
1500 * "id" is the POSIX thread ID. We use the
1501 * files pointer for this..
1502 */
1503static int filp_flush(struct file *filp, fl_owner_t id)
1504{
1505 int retval = 0;
1506
1507 if (CHECK_DATA_CORRUPTION(file_count(filp) == 0,
1508 "VFS: Close: file count is 0 (f_op=%ps)",
1509 filp->f_op)) {
1510 return 0;
1511 }
1512
1513 if (filp->f_op->flush)
1514 retval = filp->f_op->flush(filp, id);
1515
1516 if (likely(!(filp->f_mode & FMODE_PATH))) {
1517 dnotify_flush(filp, id);
1518 locks_remove_posix(filp, id);
1519 }
1520 return retval;
1521}
1522
1523int filp_close(struct file *filp, fl_owner_t id)
1524{
1525 int retval;
1526
1527 retval = filp_flush(filp, id);
1528 fput(filp);
1529
1530 return retval;
1531}
1532EXPORT_SYMBOL(filp_close);
1533
1534/*
1535 * Careful here! We test whether the file pointer is NULL before
1536 * releasing the fd. This ensures that one clone task can't release
1537 * an fd while another clone is opening it.
1538 */
1539SYSCALL_DEFINE1(close, unsigned int, fd)
1540{
1541 int retval;
1542 struct file *file;
1543
1544 file = file_close_fd(fd);
1545 if (!file)
1546 return -EBADF;
1547
1548 retval = filp_flush(file, current->files);
1549
1550 /*
1551 * We're returning to user space. Don't bother
1552 * with any delayed fput() cases.
1553 */
1554 __fput_sync(file);
1555
1556 /* can't restart close syscall because file table entry was cleared */
1557 if (unlikely(retval == -ERESTARTSYS ||
1558 retval == -ERESTARTNOINTR ||
1559 retval == -ERESTARTNOHAND ||
1560 retval == -ERESTART_RESTARTBLOCK))
1561 retval = -EINTR;
1562
1563 return retval;
1564}
1565
1566/**
1567 * sys_close_range() - Close all file descriptors in a given range.
1568 *
1569 * @fd: starting file descriptor to close
1570 * @max_fd: last file descriptor to close
1571 * @flags: reserved for future extensions
1572 *
1573 * This closes a range of file descriptors. All file descriptors
1574 * from @fd up to and including @max_fd are closed.
1575 * Currently, errors to close a given file descriptor are ignored.
1576 */
1577SYSCALL_DEFINE3(close_range, unsigned int, fd, unsigned int, max_fd,
1578 unsigned int, flags)
1579{
1580 return __close_range(fd, max_fd, flags);
1581}
1582
1583/*
1584 * This routine simulates a hangup on the tty, to arrange that users
1585 * are given clean terminals at login time.
1586 */
1587SYSCALL_DEFINE0(vhangup)
1588{
1589 if (capable(CAP_SYS_TTY_CONFIG)) {
1590 tty_vhangup_self();
1591 return 0;
1592 }
1593 return -EPERM;
1594}
1595
1596/*
1597 * Called when an inode is about to be open.
1598 * We use this to disallow opening large files on 32bit systems if
1599 * the caller didn't specify O_LARGEFILE. On 64bit systems we force
1600 * on this flag in sys_open.
1601 */
1602int generic_file_open(struct inode * inode, struct file * filp)
1603{
1604 if (!(filp->f_flags & O_LARGEFILE) && i_size_read(inode) > MAX_NON_LFS)
1605 return -EOVERFLOW;
1606 return 0;
1607}
1608
1609EXPORT_SYMBOL(generic_file_open);
1610
1611/*
1612 * This is used by subsystems that don't want seekable
1613 * file descriptors. The function is not supposed to ever fail, the only
1614 * reason it returns an 'int' and not 'void' is so that it can be plugged
1615 * directly into file_operations structure.
1616 */
1617int nonseekable_open(struct inode *inode, struct file *filp)
1618{
1619 filp->f_mode &= ~(FMODE_LSEEK | FMODE_PREAD | FMODE_PWRITE);
1620 return 0;
1621}
1622
1623EXPORT_SYMBOL(nonseekable_open);
1624
1625/*
1626 * stream_open is used by subsystems that want stream-like file descriptors.
1627 * Such file descriptors are not seekable and don't have notion of position
1628 * (file.f_pos is always 0 and ppos passed to .read()/.write() is always NULL).
1629 * Contrary to file descriptors of other regular files, .read() and .write()
1630 * can run simultaneously.
1631 *
1632 * stream_open never fails and is marked to return int so that it could be
1633 * directly used as file_operations.open .
1634 */
1635int stream_open(struct inode *inode, struct file *filp)
1636{
1637 filp->f_mode &= ~(FMODE_LSEEK | FMODE_PREAD | FMODE_PWRITE | FMODE_ATOMIC_POS);
1638 filp->f_mode |= FMODE_STREAM;
1639 return 0;
1640}
1641
1642EXPORT_SYMBOL(stream_open);