History

pid: add pidfd_open()

This adds the pidfd_open() syscall. It allows a caller to retrieve pollable pidfds for a process which did not get created via CLONE_PIDFD, i.e. for a process that is created via traditional fork()/clone() calls that is only referenced by a PID: int pidfd = pidfd_open(1234, 0); ret = pidfd_send_signal(pidfd, SIGSTOP, NULL, 0); With the introduction of pidfds through CLONE_PIDFD it is possible to created pidfds at process creation time. However, a lot of processes get created with traditional PID-based calls such as fork() or clone() (without CLONE_PIDFD). For these processes a caller can currently not create a pollable pidfd. This is a problem for Android's low memory killer (LMK) and service managers such as systemd. Both are examples of tools that want to make use of pidfds to get reliable notification of process exit for non-parents (pidfd polling) and race-free signal sending (pidfd_send_signal()). They intend to switch to this API for process supervision/management as soon as possible. Having no way to get pollable pidfds from PID-only processes is one of the biggest blockers for them in adopting this api. With pidfd_open() making it possible to retrieve pidfds for PID-based processes we enable them to adopt this api. In line with Arnd's recent changes to consolidate syscall numbers across architectures, I have added the pidfd_open() syscall to all architectures at the same time.

Christian Brauner committed 7 years ago

Commit 32fcb421 parent 740378d2 files · +70 −0Browse files

Unified · Split

2 files
  1. include/linux/syscalls.h +1 −0
  2. kernel/pid.c +69 −0
include/linux/syscalls.h+1−0
@@ -929,6 +929,7 @@ asmlinkage long sys_clock_adjtime32(clockid_t which_clock, · 928 unmodified lines
929929 struct old_timex32 __user *tx);
930930 asmlinkage long sys_syncfs(int fd);
931931 asmlinkage long sys_setns(int fd, int nstype);
932+asmlinkage long sys_pidfd_open(pid_t pid, unsigned int flags);
932933 asmlinkage long sys_sendmmsg(int fd, struct mmsghdr __user *msg,
933934 unsigned int vlen, unsigned flags);
934935 asmlinkage long sys_process_vm_readv(pid_t pid,
kernel/pid.c+69−0
@@ -37,6 +37,8 @@ · 36 unmodified lines
3737 #include <linux/syscalls.h>
3838 #include <linux/proc_ns.h>
3939 #include <linux/proc_fs.h>
40+#include <linux/anon_inodes.h>
41+#include <linux/sched/signal.h>
4042 #include <linux/sched/task.h>
4143 #include <linux/idr.h>
4244
@@ -452,6 +454,73 @@ struct pid *find_ge_pid(int nr, struct pid_namespace *ns) · 409 unmodified lines
452454 return idr_get_next(&ns->idr, &nr);
453455 }
454456
457+/**
458+ * pidfd_create() - Create a new pid file descriptor.
459+ *
460+ * @pid: struct pid that the pidfd will reference
461+ *
462+ * This creates a new pid file descriptor with the O_CLOEXEC flag set.
463+ *
464+ * Note, that this function can only be called after the fd table has
465+ * been unshared to avoid leaking the pidfd to the new process.
466+ *
467+ * Return: On success, a cloexec pidfd is returned.
468+ * On error, a negative errno number will be returned.
469+ */
470+static int pidfd_create(struct pid *pid)
471+{
472+ int fd;
473+
474+ fd = anon_inode_getfd("[pidfd]", &pidfd_fops, get_pid(pid),
475+ O_RDWR | O_CLOEXEC);
476+ if (fd < 0)
477+ put_pid(pid);
478+
479+ return fd;
480+}
481+
482+/**
483+ * pidfd_open() - Open new pid file descriptor.
484+ *
485+ * @pid: pid for which to retrieve a pidfd
486+ * @flags: flags to pass
487+ *
488+ * This creates a new pid file descriptor with the O_CLOEXEC flag set for
489+ * the process identified by @pid. Currently, the process identified by
490+ * @pid must be a thread-group leader. This restriction currently exists
491+ * for all aspects of pidfds including pidfd creation (CLONE_PIDFD cannot
492+ * be used with CLONE_THREAD) and pidfd polling (only supports thread group
493+ * leaders).
494+ *
495+ * Return: On success, a cloexec pidfd is returned.
496+ * On error, a negative errno number will be returned.
497+ */
498+SYSCALL_DEFINE2(pidfd_open, pid_t, pid, unsigned int, flags)
499+{
500+ int fd, ret;
501+ struct pid *p;
502+
503+ if (flags)
504+ return -EINVAL;
505+
506+ if (pid <= 0)
507+ return -EINVAL;
508+
509+ p = find_get_pid(pid);
510+ if (!p)
511+ return -ESRCH;
512+
513+ ret = 0;
514+ rcu_read_lock();
515+ if (!pid_task(p, PIDTYPE_TGID))
516+ ret = -EINVAL;
517+ rcu_read_unlock();
518+
519+ fd = ret ?: pidfd_create(p);
520+ put_pid(p);
521+ return fd;
522+}
523+
455524 void __init pid_idr_init(void)
456525 {
457526 /* Verify no one has done anything silly: */

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t