4 * Copyright (C) 1991, 1992 Linus Torvalds
7 #include <linux/string.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>
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 #include <linux/compat.h>
37 int do_truncate(struct dentry
*dentry
, loff_t length
, unsigned int time_attrs
,
41 struct iattr newattrs
;
43 /* Not pretty: "inode->i_size" shouldn't really be signed. But it is. */
47 newattrs
.ia_size
= length
;
48 newattrs
.ia_valid
= ATTR_SIZE
| time_attrs
;
50 newattrs
.ia_file
= filp
;
51 newattrs
.ia_valid
|= ATTR_FILE
;
54 /* Remove suid/sgid on truncate too */
55 ret
= should_remove_suid(dentry
);
57 newattrs
.ia_valid
|= ret
| ATTR_FORCE
;
59 mutex_lock(&dentry
->d_inode
->i_mutex
);
60 /* Note any delegations or leases have already been broken: */
61 ret
= notify_change(dentry
, &newattrs
, NULL
);
62 mutex_unlock(&dentry
->d_inode
->i_mutex
);
66 long vfs_truncate(struct path
*path
, loff_t length
)
71 inode
= path
->dentry
->d_inode
;
73 /* For directories it's -EISDIR, for other non-regulars - -EINVAL */
74 if (S_ISDIR(inode
->i_mode
))
76 if (!S_ISREG(inode
->i_mode
))
79 error
= mnt_want_write(path
->mnt
);
83 error
= inode_permission(inode
, MAY_WRITE
);
85 goto mnt_drop_write_and_out
;
89 goto mnt_drop_write_and_out
;
91 error
= get_write_access(inode
);
93 goto mnt_drop_write_and_out
;
96 * Make sure that there are no leases. get_write_access() protects
97 * against the truncate racing with a lease-granting setlease().
99 error
= break_lease(inode
, O_WRONLY
);
101 goto put_write_and_out
;
103 error
= locks_verify_truncate(inode
, NULL
, length
);
105 error
= security_path_truncate(path
);
107 error
= do_truncate(path
->dentry
, length
, 0, NULL
);
110 put_write_access(inode
);
111 mnt_drop_write_and_out
:
112 mnt_drop_write(path
->mnt
);
116 EXPORT_SYMBOL_GPL(vfs_truncate
);
118 static long do_sys_truncate(const char __user
*pathname
, loff_t length
)
120 unsigned int lookup_flags
= LOOKUP_FOLLOW
;
124 if (length
< 0) /* sorry, but loff_t says... */
128 error
= user_path_at(AT_FDCWD
, pathname
, lookup_flags
, &path
);
130 error
= vfs_truncate(&path
, length
);
133 if (retry_estale(error
, lookup_flags
)) {
134 lookup_flags
|= LOOKUP_REVAL
;
140 SYSCALL_DEFINE2(truncate
, const char __user
*, path
, long, length
)
142 return do_sys_truncate(path
, length
);
146 COMPAT_SYSCALL_DEFINE2(truncate
, const char __user
*, path
, compat_off_t
, length
)
148 return do_sys_truncate(path
, length
);
152 static long do_sys_ftruncate(unsigned int fd
, loff_t length
, int small
)
155 struct dentry
*dentry
;
167 /* explicitly opened as large or we are on 64-bit box */
168 if (f
.file
->f_flags
& O_LARGEFILE
)
171 dentry
= f
.file
->f_path
.dentry
;
172 inode
= dentry
->d_inode
;
174 if (!S_ISREG(inode
->i_mode
) || !(f
.file
->f_mode
& FMODE_WRITE
))
178 /* Cannot ftruncate over 2^31 bytes without large file support */
179 if (small
&& length
> MAX_NON_LFS
)
183 if (IS_APPEND(inode
))
186 sb_start_write(inode
->i_sb
);
187 error
= locks_verify_truncate(inode
, f
.file
, length
);
189 error
= security_path_truncate(&f
.file
->f_path
);
191 error
= do_truncate(dentry
, length
, ATTR_MTIME
|ATTR_CTIME
, f
.file
);
192 sb_end_write(inode
->i_sb
);
199 SYSCALL_DEFINE2(ftruncate
, unsigned int, fd
, unsigned long, length
)
201 return do_sys_ftruncate(fd
, length
, 1);
205 COMPAT_SYSCALL_DEFINE2(ftruncate
, unsigned int, fd
, compat_ulong_t
, length
)
207 return do_sys_ftruncate(fd
, length
, 1);
211 /* LFS versions of truncate are only needed on 32 bit machines */
212 #if BITS_PER_LONG == 32
213 SYSCALL_DEFINE2(truncate64
, const char __user
*, path
, loff_t
, length
)
215 return do_sys_truncate(path
, length
);
218 SYSCALL_DEFINE2(ftruncate64
, unsigned int, fd
, loff_t
, length
)
220 return do_sys_ftruncate(fd
, length
, 0);
222 #endif /* BITS_PER_LONG == 32 */
225 int do_fallocate(struct file
*file
, int mode
, loff_t offset
, loff_t len
)
227 struct inode
*inode
= file_inode(file
);
230 if (offset
< 0 || len
<= 0)
233 /* Return error if mode is not supported */
234 if (mode
& ~(FALLOC_FL_KEEP_SIZE
| FALLOC_FL_PUNCH_HOLE
|
235 FALLOC_FL_COLLAPSE_RANGE
| FALLOC_FL_ZERO_RANGE
))
238 /* Punch hole and zero range are mutually exclusive */
239 if ((mode
& (FALLOC_FL_PUNCH_HOLE
| FALLOC_FL_ZERO_RANGE
)) ==
240 (FALLOC_FL_PUNCH_HOLE
| FALLOC_FL_ZERO_RANGE
))
243 /* Punch hole must have keep size set */
244 if ((mode
& FALLOC_FL_PUNCH_HOLE
) &&
245 !(mode
& FALLOC_FL_KEEP_SIZE
))
248 /* Collapse range should only be used exclusively. */
249 if ((mode
& FALLOC_FL_COLLAPSE_RANGE
) &&
250 (mode
& ~FALLOC_FL_COLLAPSE_RANGE
))
253 if (!(file
->f_mode
& FMODE_WRITE
))
257 * We can only allow pure fallocate on append only files
259 if ((mode
& ~FALLOC_FL_KEEP_SIZE
) && IS_APPEND(inode
))
262 if (IS_IMMUTABLE(inode
))
266 * We cannot allow any fallocate operation on an active swapfile
268 if (IS_SWAPFILE(inode
))
272 * Revalidate the write permissions, in case security policy has
273 * changed since the files were opened.
275 ret
= security_file_permission(file
, MAY_WRITE
);
279 if (S_ISFIFO(inode
->i_mode
))
283 * Let individual file system decide if it supports preallocation
284 * for directories or not.
286 if (!S_ISREG(inode
->i_mode
) && !S_ISDIR(inode
->i_mode
))
289 /* Check for wrap through zero too */
290 if (((offset
+ len
) > inode
->i_sb
->s_maxbytes
) || ((offset
+ len
) < 0))
293 if (!file
->f_op
->fallocate
)
296 sb_start_write(inode
->i_sb
);
297 ret
= file
->f_op
->fallocate(file
, mode
, offset
, len
);
298 sb_end_write(inode
->i_sb
);
302 SYSCALL_DEFINE4(fallocate
, int, fd
, int, mode
, loff_t
, offset
, loff_t
, len
)
304 struct fd f
= fdget(fd
);
308 error
= do_fallocate(f
.file
, mode
, offset
, len
);
315 * access() needs to use the real uid/gid, not the effective uid/gid.
316 * We do this by temporarily clearing all FS-related capabilities and
317 * switching the fsuid/fsgid around to the real ones.
319 SYSCALL_DEFINE3(faccessat
, int, dfd
, const char __user
*, filename
, int, mode
)
321 const struct cred
*old_cred
;
322 struct cred
*override_cred
;
326 unsigned int lookup_flags
= LOOKUP_FOLLOW
;
328 if (mode
& ~S_IRWXO
) /* where's F_OK, X_OK, W_OK, R_OK? */
331 override_cred
= prepare_creds();
335 override_cred
->fsuid
= override_cred
->uid
;
336 override_cred
->fsgid
= override_cred
->gid
;
338 if (!issecure(SECURE_NO_SETUID_FIXUP
)) {
339 /* Clear the capabilities if we switch to a non-root user */
340 kuid_t root_uid
= make_kuid(override_cred
->user_ns
, 0);
341 if (!uid_eq(override_cred
->uid
, root_uid
))
342 cap_clear(override_cred
->cap_effective
);
344 override_cred
->cap_effective
=
345 override_cred
->cap_permitted
;
348 old_cred
= override_creds(override_cred
);
350 res
= user_path_at(dfd
, filename
, lookup_flags
, &path
);
354 inode
= path
.dentry
->d_inode
;
356 if ((mode
& MAY_EXEC
) && S_ISREG(inode
->i_mode
)) {
358 * MAY_EXEC on regular files is denied if the fs is mounted
359 * with the "noexec" flag.
362 if (path
.mnt
->mnt_flags
& MNT_NOEXEC
)
363 goto out_path_release
;
366 res
= inode_permission(inode
, mode
| MAY_ACCESS
);
367 /* SuS v2 requires we report a read only fs too */
368 if (res
|| !(mode
& S_IWOTH
) || special_file(inode
->i_mode
))
369 goto out_path_release
;
371 * This is a rare case where using __mnt_is_readonly()
372 * is OK without a mnt_want/drop_write() pair. Since
373 * no actual write to the fs is performed here, we do
374 * not need to telegraph to that to anyone.
376 * By doing this, we accept that this access is
377 * inherently racy and know that the fs may change
378 * state before we even see this result.
380 if (__mnt_is_readonly(path
.mnt
))
385 if (retry_estale(res
, lookup_flags
)) {
386 lookup_flags
|= LOOKUP_REVAL
;
390 revert_creds(old_cred
);
391 put_cred(override_cred
);
395 SYSCALL_DEFINE2(access
, const char __user
*, filename
, int, mode
)
397 return sys_faccessat(AT_FDCWD
, filename
, mode
);
400 SYSCALL_DEFINE1(chdir
, const char __user
*, filename
)
404 unsigned int lookup_flags
= LOOKUP_FOLLOW
| LOOKUP_DIRECTORY
;
406 error
= user_path_at(AT_FDCWD
, filename
, lookup_flags
, &path
);
410 error
= inode_permission(path
.dentry
->d_inode
, MAY_EXEC
| MAY_CHDIR
);
414 set_fs_pwd(current
->fs
, &path
);
418 if (retry_estale(error
, lookup_flags
)) {
419 lookup_flags
|= LOOKUP_REVAL
;
426 SYSCALL_DEFINE1(fchdir
, unsigned int, fd
)
428 struct fd f
= fdget_raw(fd
);
436 inode
= file_inode(f
.file
);
439 if (!S_ISDIR(inode
->i_mode
))
442 error
= inode_permission(inode
, MAY_EXEC
| MAY_CHDIR
);
444 set_fs_pwd(current
->fs
, &f
.file
->f_path
);
451 SYSCALL_DEFINE1(chroot
, const char __user
*, filename
)
455 unsigned int lookup_flags
= LOOKUP_FOLLOW
| LOOKUP_DIRECTORY
;
457 error
= user_path_at(AT_FDCWD
, filename
, lookup_flags
, &path
);
461 error
= inode_permission(path
.dentry
->d_inode
, MAY_EXEC
| MAY_CHDIR
);
466 if (!ns_capable(current_user_ns(), CAP_SYS_CHROOT
))
468 error
= security_path_chroot(&path
);
472 set_fs_root(current
->fs
, &path
);
476 if (retry_estale(error
, lookup_flags
)) {
477 lookup_flags
|= LOOKUP_REVAL
;
484 static int chmod_common(struct path
*path
, umode_t mode
)
486 struct inode
*inode
= path
->dentry
->d_inode
;
487 struct inode
*delegated_inode
= NULL
;
488 struct iattr newattrs
;
491 error
= mnt_want_write(path
->mnt
);
495 mutex_lock(&inode
->i_mutex
);
496 error
= security_path_chmod(path
, mode
);
499 newattrs
.ia_mode
= (mode
& S_IALLUGO
) | (inode
->i_mode
& ~S_IALLUGO
);
500 newattrs
.ia_valid
= ATTR_MODE
| ATTR_CTIME
;
501 error
= notify_change(path
->dentry
, &newattrs
, &delegated_inode
);
503 mutex_unlock(&inode
->i_mutex
);
504 if (delegated_inode
) {
505 error
= break_deleg_wait(&delegated_inode
);
509 mnt_drop_write(path
->mnt
);
513 SYSCALL_DEFINE2(fchmod
, unsigned int, fd
, umode_t
, mode
)
515 struct fd f
= fdget(fd
);
519 audit_inode(NULL
, f
.file
->f_path
.dentry
, 0);
520 err
= chmod_common(&f
.file
->f_path
, mode
);
526 SYSCALL_DEFINE3(fchmodat
, int, dfd
, const char __user
*, filename
, umode_t
, mode
)
530 unsigned int lookup_flags
= LOOKUP_FOLLOW
;
532 error
= user_path_at(dfd
, filename
, lookup_flags
, &path
);
534 error
= chmod_common(&path
, mode
);
536 if (retry_estale(error
, lookup_flags
)) {
537 lookup_flags
|= LOOKUP_REVAL
;
544 SYSCALL_DEFINE2(chmod
, const char __user
*, filename
, umode_t
, mode
)
546 return sys_fchmodat(AT_FDCWD
, filename
, mode
);
549 static int chown_common(struct path
*path
, uid_t user
, gid_t group
)
551 struct inode
*inode
= path
->dentry
->d_inode
;
552 struct inode
*delegated_inode
= NULL
;
554 struct iattr newattrs
;
558 uid
= make_kuid(current_user_ns(), user
);
559 gid
= make_kgid(current_user_ns(), group
);
562 newattrs
.ia_valid
= ATTR_CTIME
;
563 if (user
!= (uid_t
) -1) {
566 newattrs
.ia_valid
|= ATTR_UID
;
567 newattrs
.ia_uid
= uid
;
569 if (group
!= (gid_t
) -1) {
572 newattrs
.ia_valid
|= ATTR_GID
;
573 newattrs
.ia_gid
= gid
;
575 if (!S_ISDIR(inode
->i_mode
))
577 ATTR_KILL_SUID
| ATTR_KILL_SGID
| ATTR_KILL_PRIV
;
578 mutex_lock(&inode
->i_mutex
);
579 error
= security_path_chown(path
, uid
, gid
);
581 error
= notify_change(path
->dentry
, &newattrs
, &delegated_inode
);
582 mutex_unlock(&inode
->i_mutex
);
583 if (delegated_inode
) {
584 error
= break_deleg_wait(&delegated_inode
);
591 SYSCALL_DEFINE5(fchownat
, int, dfd
, const char __user
*, filename
, uid_t
, user
,
592 gid_t
, group
, int, flag
)
598 if ((flag
& ~(AT_SYMLINK_NOFOLLOW
| AT_EMPTY_PATH
)) != 0)
601 lookup_flags
= (flag
& AT_SYMLINK_NOFOLLOW
) ? 0 : LOOKUP_FOLLOW
;
602 if (flag
& AT_EMPTY_PATH
)
603 lookup_flags
|= LOOKUP_EMPTY
;
605 error
= user_path_at(dfd
, filename
, lookup_flags
, &path
);
608 error
= mnt_want_write(path
.mnt
);
611 error
= chown_common(&path
, user
, group
);
612 mnt_drop_write(path
.mnt
);
615 if (retry_estale(error
, lookup_flags
)) {
616 lookup_flags
|= LOOKUP_REVAL
;
623 SYSCALL_DEFINE3(chown
, const char __user
*, filename
, uid_t
, user
, gid_t
, group
)
625 return sys_fchownat(AT_FDCWD
, filename
, user
, group
, 0);
628 SYSCALL_DEFINE3(lchown
, const char __user
*, filename
, uid_t
, user
, gid_t
, group
)
630 return sys_fchownat(AT_FDCWD
, filename
, user
, group
,
631 AT_SYMLINK_NOFOLLOW
);
634 SYSCALL_DEFINE3(fchown
, unsigned int, fd
, uid_t
, user
, gid_t
, group
)
636 struct fd f
= fdget(fd
);
642 error
= mnt_want_write_file(f
.file
);
645 audit_inode(NULL
, f
.file
->f_path
.dentry
, 0);
646 error
= chown_common(&f
.file
->f_path
, user
, group
);
647 mnt_drop_write_file(f
.file
);
654 int open_check_o_direct(struct file
*f
)
656 /* NB: we're sure to have correct a_ops only after f_op->open */
657 if (f
->f_flags
& O_DIRECT
) {
658 if (!f
->f_mapping
->a_ops
||
659 ((!f
->f_mapping
->a_ops
->direct_IO
) &&
660 (!f
->f_mapping
->a_ops
->get_xip_mem
))) {
667 static int do_dentry_open(struct file
*f
,
668 int (*open
)(struct inode
*, struct file
*),
669 const struct cred
*cred
)
671 static const struct file_operations empty_fops
= {};
675 f
->f_mode
= OPEN_FMODE(f
->f_flags
) | FMODE_LSEEK
|
676 FMODE_PREAD
| FMODE_PWRITE
;
678 path_get(&f
->f_path
);
679 inode
= f
->f_inode
= f
->f_path
.dentry
->d_inode
;
680 f
->f_mapping
= inode
->i_mapping
;
682 if (unlikely(f
->f_flags
& O_PATH
)) {
683 f
->f_mode
= FMODE_PATH
;
684 f
->f_op
= &empty_fops
;
688 if (f
->f_mode
& FMODE_WRITE
&& !special_file(inode
->i_mode
)) {
689 error
= get_write_access(inode
);
692 error
= __mnt_want_write(f
->f_path
.mnt
);
693 if (unlikely(error
)) {
694 put_write_access(inode
);
697 f
->f_mode
|= FMODE_WRITER
;
700 /* POSIX.1-2008/SUSv4 Section XSI 2.9.7 */
701 if (S_ISREG(inode
->i_mode
))
702 f
->f_mode
|= FMODE_ATOMIC_POS
;
704 f
->f_op
= fops_get(inode
->i_fop
);
705 if (unlikely(WARN_ON(!f
->f_op
))) {
710 error
= security_file_open(f
, cred
);
714 error
= break_lease(inode
, f
->f_flags
);
719 open
= f
->f_op
->open
;
721 error
= open(inode
, f
);
725 if ((f
->f_mode
& (FMODE_READ
| FMODE_WRITE
)) == FMODE_READ
)
726 i_readcount_inc(inode
);
727 if ((f
->f_mode
& FMODE_READ
) &&
728 likely(f
->f_op
->read
|| f
->f_op
->aio_read
|| f
->f_op
->read_iter
))
729 f
->f_mode
|= FMODE_CAN_READ
;
730 if ((f
->f_mode
& FMODE_WRITE
) &&
731 likely(f
->f_op
->write
|| f
->f_op
->aio_write
|| f
->f_op
->write_iter
))
732 f
->f_mode
|= FMODE_CAN_WRITE
;
734 f
->f_flags
&= ~(O_CREAT
| O_EXCL
| O_NOCTTY
| O_TRUNC
);
736 file_ra_state_init(&f
->f_ra
, f
->f_mapping
->host
->i_mapping
);
742 if (f
->f_mode
& FMODE_WRITER
) {
743 put_write_access(inode
);
744 __mnt_drop_write(f
->f_path
.mnt
);
747 path_put(&f
->f_path
);
748 f
->f_path
.mnt
= NULL
;
749 f
->f_path
.dentry
= NULL
;
755 * finish_open - finish opening a file
756 * @file: file pointer
757 * @dentry: pointer to dentry
758 * @open: open callback
759 * @opened: state of open
761 * This can be used to finish opening a file passed to i_op->atomic_open().
763 * If the open callback is set to NULL, then the standard f_op->open()
764 * filesystem callback is substituted.
766 * NB: the dentry reference is _not_ consumed. If, for example, the dentry is
767 * the return value of d_splice_alias(), then the caller needs to perform dput()
768 * on it after finish_open().
770 * On successful return @file is a fully instantiated open file. After this, if
771 * an error occurs in ->atomic_open(), it needs to clean up with fput().
773 * Returns zero on success or -errno if the open failed.
775 int finish_open(struct file
*file
, struct dentry
*dentry
,
776 int (*open
)(struct inode
*, struct file
*),
780 BUG_ON(*opened
& FILE_OPENED
); /* once it's opened, it's opened */
782 file
->f_path
.dentry
= dentry
;
783 error
= do_dentry_open(file
, open
, current_cred());
785 *opened
|= FILE_OPENED
;
789 EXPORT_SYMBOL(finish_open
);
792 * finish_no_open - finish ->atomic_open() without opening the file
794 * @file: file pointer
795 * @dentry: dentry or NULL (as returned from ->lookup())
797 * This can be used to set the result of a successful lookup in ->atomic_open().
799 * NB: unlike finish_open() this function does consume the dentry reference and
800 * the caller need not dput() it.
802 * Returns "1" which must be the return value of ->atomic_open() after having
803 * called this function.
805 int finish_no_open(struct file
*file
, struct dentry
*dentry
)
807 file
->f_path
.dentry
= dentry
;
810 EXPORT_SYMBOL(finish_no_open
);
812 struct file
*dentry_open(const struct path
*path
, int flags
,
813 const struct cred
*cred
)
818 validate_creds(cred
);
820 /* We must always pass in a valid mount pointer. */
823 f
= get_empty_filp();
827 error
= do_dentry_open(f
, NULL
, cred
);
829 /* from now on we need fput() to dispose of f */
830 error
= open_check_o_direct(f
);
842 EXPORT_SYMBOL(dentry_open
);
844 static inline int build_open_flags(int flags
, umode_t mode
, struct open_flags
*op
)
846 int lookup_flags
= 0;
849 if (flags
& (O_CREAT
| __O_TMPFILE
))
850 op
->mode
= (mode
& S_IALLUGO
) | S_IFREG
;
854 /* Must never be set by userspace */
855 flags
&= ~FMODE_NONOTIFY
& ~O_CLOEXEC
;
858 * O_SYNC is implemented as __O_SYNC|O_DSYNC. As many places only
859 * check for O_DSYNC if the need any syncing at all we enforce it's
860 * always set instead of having to deal with possibly weird behaviour
861 * for malicious applications setting only __O_SYNC.
863 if (flags
& __O_SYNC
)
866 if (flags
& __O_TMPFILE
) {
867 if ((flags
& O_TMPFILE_MASK
) != O_TMPFILE
)
869 acc_mode
= MAY_OPEN
| ACC_MODE(flags
);
870 if (!(acc_mode
& MAY_WRITE
))
872 } else if (flags
& O_PATH
) {
874 * If we have O_PATH in the open flag. Then we
875 * cannot have anything other than the below set of flags
877 flags
&= O_DIRECTORY
| O_NOFOLLOW
| O_PATH
;
880 acc_mode
= MAY_OPEN
| ACC_MODE(flags
);
883 op
->open_flag
= flags
;
885 /* O_TRUNC implies we need access checks for write permissions */
887 acc_mode
|= MAY_WRITE
;
889 /* Allow the LSM permission hook to distinguish append
890 access from general write access. */
891 if (flags
& O_APPEND
)
892 acc_mode
|= MAY_APPEND
;
894 op
->acc_mode
= acc_mode
;
896 op
->intent
= flags
& O_PATH
? 0 : LOOKUP_OPEN
;
898 if (flags
& O_CREAT
) {
899 op
->intent
|= LOOKUP_CREATE
;
901 op
->intent
|= LOOKUP_EXCL
;
904 if (flags
& O_DIRECTORY
)
905 lookup_flags
|= LOOKUP_DIRECTORY
;
906 if (!(flags
& O_NOFOLLOW
))
907 lookup_flags
|= LOOKUP_FOLLOW
;
908 op
->lookup_flags
= lookup_flags
;
913 * file_open_name - open file and return file pointer
915 * @name: struct filename containing path to open
916 * @flags: open flags as per the open(2) second argument
917 * @mode: mode for the new file if O_CREAT is set, else ignored
919 * This is the helper to open a file from kernelspace if you really
920 * have to. But in generally you should not do this, so please move
921 * along, nothing to see here..
923 struct file
*file_open_name(struct filename
*name
, int flags
, umode_t mode
)
925 struct open_flags op
;
926 int err
= build_open_flags(flags
, mode
, &op
);
927 return err
? ERR_PTR(err
) : do_filp_open(AT_FDCWD
, name
, &op
);
931 * filp_open - open file and return file pointer
933 * @filename: path to open
934 * @flags: open flags as per the open(2) second argument
935 * @mode: mode for the new file if O_CREAT is set, else ignored
937 * This is the helper to open a file from kernelspace if you really
938 * have to. But in generally you should not do this, so please move
939 * along, nothing to see here..
941 struct file
*filp_open(const char *filename
, int flags
, umode_t mode
)
943 struct filename name
= {.name
= filename
};
944 return file_open_name(&name
, flags
, mode
);
946 EXPORT_SYMBOL(filp_open
);
948 struct file
*file_open_root(struct dentry
*dentry
, struct vfsmount
*mnt
,
949 const char *filename
, int flags
, umode_t mode
)
951 struct open_flags op
;
952 int err
= build_open_flags(flags
, mode
, &op
);
955 if (!filename
&& (flags
& O_DIRECTORY
))
956 if (!dentry
->d_inode
->i_op
->lookup
)
957 return ERR_PTR(-ENOTDIR
);
958 return do_file_open_root(dentry
, mnt
, filename
, &op
);
960 EXPORT_SYMBOL(file_open_root
);
962 long do_sys_open(int dfd
, const char __user
*filename
, int flags
, umode_t mode
)
964 struct open_flags op
;
965 int fd
= build_open_flags(flags
, mode
, &op
);
966 struct filename
*tmp
;
971 tmp
= getname(filename
);
975 fd
= get_unused_fd_flags(flags
);
977 struct file
*f
= do_filp_open(dfd
, tmp
, &op
);
990 SYSCALL_DEFINE3(open
, const char __user
*, filename
, int, flags
, umode_t
, mode
)
992 if (force_o_largefile())
993 flags
|= O_LARGEFILE
;
995 return do_sys_open(AT_FDCWD
, filename
, flags
, mode
);
998 SYSCALL_DEFINE4(openat
, int, dfd
, const char __user
*, filename
, int, flags
,
1001 if (force_o_largefile())
1002 flags
|= O_LARGEFILE
;
1004 return do_sys_open(dfd
, filename
, flags
, mode
);
1010 * For backward compatibility? Maybe this should be moved
1011 * into arch/i386 instead?
1013 SYSCALL_DEFINE2(creat
, const char __user
*, pathname
, umode_t
, mode
)
1015 return sys_open(pathname
, O_CREAT
| O_WRONLY
| O_TRUNC
, mode
);
1021 * "id" is the POSIX thread ID. We use the
1022 * files pointer for this..
1024 int filp_close(struct file
*filp
, fl_owner_t id
)
1028 if (!file_count(filp
)) {
1029 printk(KERN_ERR
"VFS: Close: file count is 0\n");
1033 if (filp
->f_op
->flush
)
1034 retval
= filp
->f_op
->flush(filp
, id
);
1036 if (likely(!(filp
->f_mode
& FMODE_PATH
))) {
1037 dnotify_flush(filp
, id
);
1038 locks_remove_posix(filp
, id
);
1044 EXPORT_SYMBOL(filp_close
);
1047 * Careful here! We test whether the file pointer is NULL before
1048 * releasing the fd. This ensures that one clone task can't release
1049 * an fd while another clone is opening it.
1051 SYSCALL_DEFINE1(close
, unsigned int, fd
)
1053 int retval
= __close_fd(current
->files
, fd
);
1055 /* can't restart close syscall because file table entry was cleared */
1056 if (unlikely(retval
== -ERESTARTSYS
||
1057 retval
== -ERESTARTNOINTR
||
1058 retval
== -ERESTARTNOHAND
||
1059 retval
== -ERESTART_RESTARTBLOCK
))
1064 EXPORT_SYMBOL(sys_close
);
1067 * This routine simulates a hangup on the tty, to arrange that users
1068 * are given clean terminals at login time.
1070 SYSCALL_DEFINE0(vhangup
)
1072 if (capable(CAP_SYS_TTY_CONFIG
)) {
1080 * Called when an inode is about to be open.
1081 * We use this to disallow opening large files on 32bit systems if
1082 * the caller didn't specify O_LARGEFILE. On 64bit systems we force
1083 * on this flag in sys_open.
1085 int generic_file_open(struct inode
* inode
, struct file
* filp
)
1087 if (!(filp
->f_flags
& O_LARGEFILE
) && i_size_read(inode
) > MAX_NON_LFS
)
1092 EXPORT_SYMBOL(generic_file_open
);
1095 * This is used by subsystems that don't want seekable
1096 * file descriptors. The function is not supposed to ever fail, the only
1097 * reason it returns an 'int' and not 'void' is so that it can be plugged
1098 * directly into file_operations structure.
1100 int nonseekable_open(struct inode
*inode
, struct file
*filp
)
1102 filp
->f_mode
&= ~(FMODE_LSEEK
| FMODE_PREAD
| FMODE_PWRITE
);
1106 EXPORT_SYMBOL(nonseekable_open
);