1 // SPDX-License-Identifier: GPL-2.0
5 * Copyright (C) 1991, 1992 Linus Torvalds
8 #include <linux/syscalls.h>
9 #include <linux/init.h>
11 #include <linux/sched/task.h>
13 #include <linux/filelock.h>
14 #include <linux/file.h>
15 #include <linux/capability.h>
16 #include <linux/dnotify.h>
17 #include <linux/slab.h>
18 #include <linux/module.h>
19 #include <linux/pipe_fs_i.h>
20 #include <linux/security.h>
21 #include <linux/ptrace.h>
22 #include <linux/signal.h>
23 #include <linux/rcupdate.h>
24 #include <linux/pid_namespace.h>
25 #include <linux/user_namespace.h>
26 #include <linux/memfd.h>
27 #include <linux/compat.h>
28 #include <linux/mount.h>
29 #include <linux/rw_hint.h>
31 #include <linux/poll.h>
32 #include <asm/siginfo.h>
33 #include <linux/uaccess.h>
37 #define SETFL_MASK (O_APPEND | O_NONBLOCK | O_NDELAY | O_DIRECT | O_NOATIME)
39 static int setfl(int fd, struct file * filp, unsigned int arg)
41 struct inode * inode = file_inode(filp);
45 * O_APPEND cannot be cleared if the file is marked as append-only
46 * and the file is open for write.
48 if (((arg ^ filp->f_flags) & O_APPEND) && IS_APPEND(inode))
51 /* O_NOATIME can only be set by the owner or superuser */
52 if ((arg & O_NOATIME) && !(filp->f_flags & O_NOATIME))
53 if (!inode_owner_or_capable(file_mnt_idmap(filp), inode))
56 /* required for strict SunOS emulation */
57 if (O_NONBLOCK != O_NDELAY)
61 /* Pipe packetized mode is controlled by O_DIRECT flag */
62 if (!S_ISFIFO(inode->i_mode) &&
64 !(filp->f_mode & FMODE_CAN_ODIRECT))
67 if (filp->f_op->check_flags)
68 error = filp->f_op->check_flags(arg);
73 * ->fasync() is responsible for setting the FASYNC bit.
75 if (((arg ^ filp->f_flags) & FASYNC) && filp->f_op->fasync) {
76 error = filp->f_op->fasync(fd, filp, (arg & FASYNC) != 0);
82 spin_lock(&filp->f_lock);
83 filp->f_flags = (arg & SETFL_MASK) | (filp->f_flags & ~SETFL_MASK);
84 filp->f_iocb_flags = iocb_flags(filp);
85 spin_unlock(&filp->f_lock);
92 * Allocate an file->f_owner struct if it doesn't exist, handling racing
93 * allocations correctly.
95 int file_f_owner_allocate(struct file *file)
97 struct fown_struct *f_owner;
99 f_owner = file_f_owner(file);
103 f_owner = kzalloc(sizeof(struct fown_struct), GFP_KERNEL);
107 rwlock_init(&f_owner->lock);
108 f_owner->file = file;
109 /* If someone else raced us, drop our allocation. */
110 if (unlikely(cmpxchg(&file->f_owner, NULL, f_owner)))
114 EXPORT_SYMBOL(file_f_owner_allocate);
116 void file_f_owner_release(struct file *file)
118 struct fown_struct *f_owner;
120 f_owner = file_f_owner(file);
122 put_pid(f_owner->pid);
127 void __f_setown(struct file *filp, struct pid *pid, enum pid_type type,
130 struct fown_struct *f_owner;
132 f_owner = file_f_owner(filp);
133 if (WARN_ON_ONCE(!f_owner))
136 write_lock_irq(&f_owner->lock);
137 if (force || !f_owner->pid) {
138 put_pid(f_owner->pid);
139 f_owner->pid = get_pid(pid);
140 f_owner->pid_type = type;
143 const struct cred *cred = current_cred();
144 security_file_set_fowner(filp);
145 f_owner->uid = cred->uid;
146 f_owner->euid = cred->euid;
149 write_unlock_irq(&f_owner->lock);
151 EXPORT_SYMBOL(__f_setown);
153 int f_setown(struct file *filp, int who, int force)
156 struct pid *pid = NULL;
163 /* avoid overflow below */
171 ret = file_f_owner_allocate(filp);
177 pid = find_vpid(who);
183 __f_setown(filp, pid, type, force);
188 EXPORT_SYMBOL(f_setown);
190 void f_delown(struct file *filp)
192 __f_setown(filp, NULL, PIDTYPE_TGID, 1);
195 pid_t f_getown(struct file *filp)
198 struct fown_struct *f_owner;
200 f_owner = file_f_owner(filp);
204 read_lock_irq(&f_owner->lock);
206 if (pid_task(f_owner->pid, f_owner->pid_type)) {
207 pid = pid_vnr(f_owner->pid);
208 if (f_owner->pid_type == PIDTYPE_PGID)
212 read_unlock_irq(&f_owner->lock);
216 static int f_setown_ex(struct file *filp, unsigned long arg)
218 struct f_owner_ex __user *owner_p = (void __user *)arg;
219 struct f_owner_ex owner;
224 ret = copy_from_user(&owner, owner_p, sizeof(owner));
228 switch (owner.type) {
245 ret = file_f_owner_allocate(filp);
250 pid = find_vpid(owner.pid);
251 if (owner.pid && !pid)
254 __f_setown(filp, pid, type, 1);
260 static int f_getown_ex(struct file *filp, unsigned long arg)
262 struct f_owner_ex __user *owner_p = (void __user *)arg;
263 struct f_owner_ex owner = {};
265 struct fown_struct *f_owner;
266 enum pid_type pid_type = PIDTYPE_PID;
268 f_owner = file_f_owner(filp);
270 read_lock_irq(&f_owner->lock);
272 if (pid_task(f_owner->pid, f_owner->pid_type))
273 owner.pid = pid_vnr(f_owner->pid);
275 pid_type = f_owner->pid_type;
280 owner.type = F_OWNER_TID;
284 owner.type = F_OWNER_PID;
288 owner.type = F_OWNER_PGRP;
297 read_unlock_irq(&f_owner->lock);
300 ret = copy_to_user(owner_p, &owner, sizeof(owner));
307 #ifdef CONFIG_CHECKPOINT_RESTORE
308 static int f_getowner_uids(struct file *filp, unsigned long arg)
310 struct user_namespace *user_ns = current_user_ns();
311 struct fown_struct *f_owner;
312 uid_t __user *dst = (void __user *)arg;
313 uid_t src[2] = {0, 0};
316 f_owner = file_f_owner(filp);
318 read_lock_irq(&f_owner->lock);
319 src[0] = from_kuid(user_ns, f_owner->uid);
320 src[1] = from_kuid(user_ns, f_owner->euid);
321 read_unlock_irq(&f_owner->lock);
324 err = put_user(src[0], &dst[0]);
325 err |= put_user(src[1], &dst[1]);
330 static int f_getowner_uids(struct file *filp, unsigned long arg)
336 static bool rw_hint_valid(u64 hint)
338 BUILD_BUG_ON(WRITE_LIFE_NOT_SET != RWH_WRITE_LIFE_NOT_SET);
339 BUILD_BUG_ON(WRITE_LIFE_NONE != RWH_WRITE_LIFE_NONE);
340 BUILD_BUG_ON(WRITE_LIFE_SHORT != RWH_WRITE_LIFE_SHORT);
341 BUILD_BUG_ON(WRITE_LIFE_MEDIUM != RWH_WRITE_LIFE_MEDIUM);
342 BUILD_BUG_ON(WRITE_LIFE_LONG != RWH_WRITE_LIFE_LONG);
343 BUILD_BUG_ON(WRITE_LIFE_EXTREME != RWH_WRITE_LIFE_EXTREME);
346 case RWH_WRITE_LIFE_NOT_SET:
347 case RWH_WRITE_LIFE_NONE:
348 case RWH_WRITE_LIFE_SHORT:
349 case RWH_WRITE_LIFE_MEDIUM:
350 case RWH_WRITE_LIFE_LONG:
351 case RWH_WRITE_LIFE_EXTREME:
358 static long fcntl_get_rw_hint(struct file *file, unsigned int cmd,
361 struct inode *inode = file_inode(file);
362 u64 __user *argp = (u64 __user *)arg;
363 u64 hint = READ_ONCE(inode->i_write_hint);
365 if (copy_to_user(argp, &hint, sizeof(*argp)))
370 static long fcntl_set_rw_hint(struct file *file, unsigned int cmd,
373 struct inode *inode = file_inode(file);
374 u64 __user *argp = (u64 __user *)arg;
377 if (copy_from_user(&hint, argp, sizeof(hint)))
379 if (!rw_hint_valid(hint))
382 WRITE_ONCE(inode->i_write_hint, hint);
385 * file->f_mapping->host may differ from inode. As an example,
386 * blkdev_open() modifies file->f_mapping.
388 if (file->f_mapping->host != inode)
389 WRITE_ONCE(file->f_mapping->host->i_write_hint, hint);
394 /* Is the file descriptor a dup of the file? */
395 static long f_dupfd_query(int fd, struct file *filp)
397 CLASS(fd_raw, f)(fd);
403 * We can do the 'fdput()' immediately, as the only thing that
404 * matters is the pointer value which isn't changed by the fdput.
406 * Technically we didn't need a ref at all, and 'fdget()' was
407 * overkill, but given our lockless file pointer lookup, the
408 * alternatives are complicated.
410 return fd_file(f) == filp;
413 /* Let the caller figure out whether a given file was just created. */
414 static long f_created_query(const struct file *filp)
416 return !!(filp->f_mode & FMODE_CREATED);
419 static int f_owner_sig(struct file *filp, int signum, bool setsig)
422 struct fown_struct *f_owner;
427 if (!valid_signal(signum))
430 ret = file_f_owner_allocate(filp);
435 f_owner = file_f_owner(filp);
437 f_owner->signum = signum;
439 ret = f_owner->signum;
443 static long do_fcntl(int fd, unsigned int cmd, unsigned long arg,
446 void __user *argp = (void __user *)arg;
452 case F_CREATED_QUERY:
453 err = f_created_query(filp);
456 err = f_dupfd(argi, filp, 0);
458 case F_DUPFD_CLOEXEC:
459 err = f_dupfd(argi, filp, O_CLOEXEC);
462 err = f_dupfd_query(argi, filp);
465 err = get_close_on_exec(fd) ? FD_CLOEXEC : 0;
469 set_close_on_exec(fd, argi & FD_CLOEXEC);
475 err = setfl(fd, filp, argi);
477 #if BITS_PER_LONG != 32
478 /* 32-bit arches must use fcntl64() */
482 if (copy_from_user(&flock, argp, sizeof(flock)))
484 err = fcntl_getlk(filp, cmd, &flock);
485 if (!err && copy_to_user(argp, &flock, sizeof(flock)))
488 #if BITS_PER_LONG != 32
489 /* 32-bit arches must use fcntl64() */
496 if (copy_from_user(&flock, argp, sizeof(flock)))
498 err = fcntl_setlk(fd, filp, cmd, &flock);
502 * XXX If f_owner is a process group, the
503 * negative return value will get converted
504 * into an error. Oops. If we keep the
505 * current syscall conventions, the only way
506 * to fix this will be in libc.
508 err = f_getown(filp);
509 force_successful_syscall_return();
512 err = f_setown(filp, argi, 1);
515 err = f_getown_ex(filp, arg);
518 err = f_setown_ex(filp, arg);
520 case F_GETOWNER_UIDS:
521 err = f_getowner_uids(filp, arg);
524 err = f_owner_sig(filp, 0, false);
527 err = f_owner_sig(filp, argi, true);
530 err = fcntl_getlease(filp);
533 err = fcntl_setlease(fd, filp, argi);
536 err = fcntl_dirnotify(fd, filp, argi);
540 err = pipe_fcntl(filp, cmd, argi);
544 err = memfd_fcntl(filp, cmd, argi);
547 err = fcntl_get_rw_hint(filp, cmd, arg);
550 err = fcntl_set_rw_hint(filp, cmd, arg);
558 static int check_fcntl_cmd(unsigned cmd)
561 case F_CREATED_QUERY:
563 case F_DUPFD_CLOEXEC:
573 SYSCALL_DEFINE3(fcntl, unsigned int, fd, unsigned int, cmd, unsigned long, arg)
575 CLASS(fd_raw, f)(fd);
581 if (unlikely(fd_file(f)->f_mode & FMODE_PATH)) {
582 if (!check_fcntl_cmd(cmd))
586 err = security_file_fcntl(fd_file(f), cmd, arg);
588 err = do_fcntl(fd, cmd, arg, fd_file(f));
593 #if BITS_PER_LONG == 32
594 SYSCALL_DEFINE3(fcntl64, unsigned int, fd, unsigned int, cmd,
597 void __user *argp = (void __user *)arg;
598 CLASS(fd_raw, f)(fd);
599 struct flock64 flock;
605 if (unlikely(fd_file(f)->f_mode & FMODE_PATH)) {
606 if (!check_fcntl_cmd(cmd))
610 err = security_file_fcntl(fd_file(f), cmd, arg);
618 if (copy_from_user(&flock, argp, sizeof(flock)))
620 err = fcntl_getlk64(fd_file(f), cmd, &flock);
621 if (!err && copy_to_user(argp, &flock, sizeof(flock)))
629 if (copy_from_user(&flock, argp, sizeof(flock)))
631 err = fcntl_setlk64(fd, fd_file(f), cmd, &flock);
634 err = do_fcntl(fd, cmd, arg, fd_file(f));
642 /* careful - don't use anywhere else */
643 #define copy_flock_fields(dst, src) \
644 (dst)->l_type = (src)->l_type; \
645 (dst)->l_whence = (src)->l_whence; \
646 (dst)->l_start = (src)->l_start; \
647 (dst)->l_len = (src)->l_len; \
648 (dst)->l_pid = (src)->l_pid;
650 static int get_compat_flock(struct flock *kfl, const struct compat_flock __user *ufl)
652 struct compat_flock fl;
654 if (copy_from_user(&fl, ufl, sizeof(struct compat_flock)))
656 copy_flock_fields(kfl, &fl);
660 static int get_compat_flock64(struct flock *kfl, const struct compat_flock64 __user *ufl)
662 struct compat_flock64 fl;
664 if (copy_from_user(&fl, ufl, sizeof(struct compat_flock64)))
666 copy_flock_fields(kfl, &fl);
670 static int put_compat_flock(const struct flock *kfl, struct compat_flock __user *ufl)
672 struct compat_flock fl;
674 memset(&fl, 0, sizeof(struct compat_flock));
675 copy_flock_fields(&fl, kfl);
676 if (copy_to_user(ufl, &fl, sizeof(struct compat_flock)))
681 static int put_compat_flock64(const struct flock *kfl, struct compat_flock64 __user *ufl)
683 struct compat_flock64 fl;
685 BUILD_BUG_ON(sizeof(kfl->l_start) > sizeof(ufl->l_start));
686 BUILD_BUG_ON(sizeof(kfl->l_len) > sizeof(ufl->l_len));
688 memset(&fl, 0, sizeof(struct compat_flock64));
689 copy_flock_fields(&fl, kfl);
690 if (copy_to_user(ufl, &fl, sizeof(struct compat_flock64)))
694 #undef copy_flock_fields
697 convert_fcntl_cmd(unsigned int cmd)
712 * GETLK was successful and we need to return the data, but it needs to fit in
713 * the compat structure.
714 * l_start shouldn't be too big, unless the original start + end is greater than
715 * COMPAT_OFF_T_MAX, in which case the app was asking for trouble, so we return
716 * -EOVERFLOW in that case. l_len could be too big, in which case we just
717 * truncate it, and only allow the app to see that part of the conflicting lock
718 * that might make sense to it anyway
720 static int fixup_compat_flock(struct flock *flock)
722 if (flock->l_start > COMPAT_OFF_T_MAX)
724 if (flock->l_len > COMPAT_OFF_T_MAX)
725 flock->l_len = COMPAT_OFF_T_MAX;
729 static long do_compat_fcntl64(unsigned int fd, unsigned int cmd,
732 CLASS(fd_raw, f)(fd);
739 if (unlikely(fd_file(f)->f_mode & FMODE_PATH)) {
740 if (!check_fcntl_cmd(cmd))
744 err = security_file_fcntl(fd_file(f), cmd, arg);
750 err = get_compat_flock(&flock, compat_ptr(arg));
753 err = fcntl_getlk(fd_file(f), convert_fcntl_cmd(cmd), &flock);
756 err = fixup_compat_flock(&flock);
758 err = put_compat_flock(&flock, compat_ptr(arg));
762 err = get_compat_flock64(&flock, compat_ptr(arg));
765 err = fcntl_getlk(fd_file(f), convert_fcntl_cmd(cmd), &flock);
767 err = put_compat_flock64(&flock, compat_ptr(arg));
771 err = get_compat_flock(&flock, compat_ptr(arg));
774 err = fcntl_setlk(fd, fd_file(f), convert_fcntl_cmd(cmd), &flock);
780 err = get_compat_flock64(&flock, compat_ptr(arg));
783 err = fcntl_setlk(fd, fd_file(f), convert_fcntl_cmd(cmd), &flock);
786 err = do_fcntl(fd, cmd, arg, fd_file(f));
792 COMPAT_SYSCALL_DEFINE3(fcntl64, unsigned int, fd, unsigned int, cmd,
795 return do_compat_fcntl64(fd, cmd, arg);
798 COMPAT_SYSCALL_DEFINE3(fcntl, unsigned int, fd, unsigned int, cmd,
810 return do_compat_fcntl64(fd, cmd, arg);
814 /* Table to convert sigio signal codes into poll band bitmaps */
816 static const __poll_t band_table[NSIGPOLL] = {
817 EPOLLIN | EPOLLRDNORM, /* POLL_IN */
818 EPOLLOUT | EPOLLWRNORM | EPOLLWRBAND, /* POLL_OUT */
819 EPOLLIN | EPOLLRDNORM | EPOLLMSG, /* POLL_MSG */
820 EPOLLERR, /* POLL_ERR */
821 EPOLLPRI | EPOLLRDBAND, /* POLL_PRI */
822 EPOLLHUP | EPOLLERR /* POLL_HUP */
825 static inline int sigio_perm(struct task_struct *p,
826 struct fown_struct *fown, int sig)
828 const struct cred *cred;
832 cred = __task_cred(p);
833 ret = ((uid_eq(fown->euid, GLOBAL_ROOT_UID) ||
834 uid_eq(fown->euid, cred->suid) || uid_eq(fown->euid, cred->uid) ||
835 uid_eq(fown->uid, cred->suid) || uid_eq(fown->uid, cred->uid)) &&
836 !security_file_send_sigiotask(p, fown, sig));
841 static void send_sigio_to_task(struct task_struct *p,
842 struct fown_struct *fown,
843 int fd, int reason, enum pid_type type)
846 * F_SETSIG can change ->signum lockless in parallel, make
847 * sure we read it once and use the same value throughout.
849 int signum = READ_ONCE(fown->signum);
851 if (!sigio_perm(p, fown, signum))
858 /* Queue a rt signal with the appropriate fd as its
859 value. We use SI_SIGIO as the source, not
860 SI_KERNEL, since kernel signals always get
861 delivered even if we can't queue. Failure to
862 queue in this case _should_ be reported; we fall
863 back to SIGIO in that case. --sct */
865 si.si_signo = signum;
869 * Posix definies POLL_IN and friends to be signal
870 * specific si_codes for SIG_POLL. Linux extended
871 * these si_codes to other signals in a way that is
872 * ambiguous if other signals also have signal
873 * specific si_codes. In that case use SI_SIGIO instead
874 * to remove the ambiguity.
876 if ((signum != SIGPOLL) && sig_specific_sicodes(signum))
877 si.si_code = SI_SIGIO;
879 /* Make sure we are called with one of the POLL_*
880 reasons, otherwise we could leak kernel stack into
882 BUG_ON((reason < POLL_IN) || ((reason - POLL_IN) >= NSIGPOLL));
883 if (reason - POLL_IN >= NSIGPOLL)
886 si.si_band = mangle_poll(band_table[reason - POLL_IN]);
888 if (!do_send_sig_info(signum, &si, p, type))
891 fallthrough; /* fall back on the old plain SIGIO signal */
893 do_send_sig_info(SIGIO, SEND_SIG_PRIV, p, type);
897 void send_sigio(struct fown_struct *fown, int fd, int band)
899 struct task_struct *p;
904 read_lock_irqsave(&fown->lock, flags);
906 type = fown->pid_type;
909 goto out_unlock_fown;
911 if (type <= PIDTYPE_TGID) {
913 p = pid_task(pid, PIDTYPE_PID);
915 send_sigio_to_task(p, fown, fd, band, type);
918 read_lock(&tasklist_lock);
919 do_each_pid_task(pid, type, p) {
920 send_sigio_to_task(p, fown, fd, band, type);
921 } while_each_pid_task(pid, type, p);
922 read_unlock(&tasklist_lock);
925 read_unlock_irqrestore(&fown->lock, flags);
928 static void send_sigurg_to_task(struct task_struct *p,
929 struct fown_struct *fown, enum pid_type type)
931 if (sigio_perm(p, fown, SIGURG))
932 do_send_sig_info(SIGURG, SEND_SIG_PRIV, p, type);
935 int send_sigurg(struct file *file)
937 struct fown_struct *fown;
938 struct task_struct *p;
944 fown = file_f_owner(file);
948 read_lock_irqsave(&fown->lock, flags);
950 type = fown->pid_type;
953 goto out_unlock_fown;
957 if (type <= PIDTYPE_TGID) {
959 p = pid_task(pid, PIDTYPE_PID);
961 send_sigurg_to_task(p, fown, type);
964 read_lock(&tasklist_lock);
965 do_each_pid_task(pid, type, p) {
966 send_sigurg_to_task(p, fown, type);
967 } while_each_pid_task(pid, type, p);
968 read_unlock(&tasklist_lock);
971 read_unlock_irqrestore(&fown->lock, flags);
975 static DEFINE_SPINLOCK(fasync_lock);
976 static struct kmem_cache *fasync_cache __ro_after_init;
979 * Remove a fasync entry. If successfully removed, return
980 * positive and clear the FASYNC flag. If no entry exists,
981 * do nothing and return 0.
983 * NOTE! It is very important that the FASYNC flag always
984 * match the state "is the filp on a fasync list".
987 int fasync_remove_entry(struct file *filp, struct fasync_struct **fapp)
989 struct fasync_struct *fa, **fp;
992 spin_lock(&filp->f_lock);
993 spin_lock(&fasync_lock);
994 for (fp = fapp; (fa = *fp) != NULL; fp = &fa->fa_next) {
995 if (fa->fa_file != filp)
998 write_lock_irq(&fa->fa_lock);
1000 write_unlock_irq(&fa->fa_lock);
1003 kfree_rcu(fa, fa_rcu);
1004 filp->f_flags &= ~FASYNC;
1008 spin_unlock(&fasync_lock);
1009 spin_unlock(&filp->f_lock);
1013 struct fasync_struct *fasync_alloc(void)
1015 return kmem_cache_alloc(fasync_cache, GFP_KERNEL);
1019 * NOTE! This can be used only for unused fasync entries:
1020 * entries that actually got inserted on the fasync list
1021 * need to be released by rcu - see fasync_remove_entry.
1023 void fasync_free(struct fasync_struct *new)
1025 kmem_cache_free(fasync_cache, new);
1029 * Insert a new entry into the fasync list. Return the pointer to the
1030 * old one if we didn't use the new one.
1032 * NOTE! It is very important that the FASYNC flag always
1033 * match the state "is the filp on a fasync list".
1035 struct fasync_struct *fasync_insert_entry(int fd, struct file *filp, struct fasync_struct **fapp, struct fasync_struct *new)
1037 struct fasync_struct *fa, **fp;
1039 spin_lock(&filp->f_lock);
1040 spin_lock(&fasync_lock);
1041 for (fp = fapp; (fa = *fp) != NULL; fp = &fa->fa_next) {
1042 if (fa->fa_file != filp)
1045 write_lock_irq(&fa->fa_lock);
1047 write_unlock_irq(&fa->fa_lock);
1051 rwlock_init(&new->fa_lock);
1052 new->magic = FASYNC_MAGIC;
1053 new->fa_file = filp;
1055 new->fa_next = *fapp;
1056 rcu_assign_pointer(*fapp, new);
1057 filp->f_flags |= FASYNC;
1060 spin_unlock(&fasync_lock);
1061 spin_unlock(&filp->f_lock);
1066 * Add a fasync entry. Return negative on error, positive if
1067 * added, and zero if did nothing but change an existing one.
1069 static int fasync_add_entry(int fd, struct file *filp, struct fasync_struct **fapp)
1071 struct fasync_struct *new;
1073 new = fasync_alloc();
1078 * fasync_insert_entry() returns the old (update) entry if
1081 * So free the (unused) new entry and return 0 to let the
1082 * caller know that we didn't add any new fasync entries.
1084 if (fasync_insert_entry(fd, filp, fapp, new)) {
1093 * fasync_helper() is used by almost all character device drivers
1094 * to set up the fasync queue, and for regular files by the file
1095 * lease code. It returns negative on error, 0 if it did no changes
1096 * and positive if it added/deleted the entry.
1098 int fasync_helper(int fd, struct file * filp, int on, struct fasync_struct **fapp)
1101 return fasync_remove_entry(filp, fapp);
1102 return fasync_add_entry(fd, filp, fapp);
1105 EXPORT_SYMBOL(fasync_helper);
1108 * rcu_read_lock() is held
1110 static void kill_fasync_rcu(struct fasync_struct *fa, int sig, int band)
1113 struct fown_struct *fown;
1114 unsigned long flags;
1116 if (fa->magic != FASYNC_MAGIC) {
1117 printk(KERN_ERR "kill_fasync: bad magic number in "
1118 "fasync_struct!\n");
1121 read_lock_irqsave(&fa->fa_lock, flags);
1123 fown = file_f_owner(fa->fa_file);
1126 /* Don't send SIGURG to processes which have not set a
1127 queued signum: SIGURG has its own default signalling
1129 if (!(sig == SIGURG && fown->signum == 0))
1130 send_sigio(fown, fa->fa_fd, band);
1133 read_unlock_irqrestore(&fa->fa_lock, flags);
1134 fa = rcu_dereference(fa->fa_next);
1138 void kill_fasync(struct fasync_struct **fp, int sig, int band)
1140 /* First a quick test without locking: usually
1141 * the list is empty.
1145 kill_fasync_rcu(rcu_dereference(*fp), sig, band);
1149 EXPORT_SYMBOL(kill_fasync);
1151 static int __init fcntl_init(void)
1154 * Please add new bits here to ensure allocation uniqueness.
1155 * Exceptions: O_NONBLOCK is a two bit define on parisc; O_NDELAY
1156 * is defined as O_NONBLOCK on some platforms and not on others.
1158 BUILD_BUG_ON(21 - 1 /* for O_RDONLY being 0 */ !=
1160 (VALID_OPEN_FLAGS & ~(O_NONBLOCK | O_NDELAY)) |
1161 __FMODE_EXEC | __FMODE_NONOTIFY));
1163 fasync_cache = kmem_cache_create("fasync_cache",
1164 sizeof(struct fasync_struct), 0,
1165 SLAB_PANIC | SLAB_ACCOUNT, NULL);
1169 module_init(fcntl_init)