1 // SPDX-License-Identifier: GPL-2.0
5 * Copyright (C) 1991, 1992, 1999 Linus Torvalds
9 #include <linux/file.h>
10 #include <linux/poll.h>
11 #include <linux/slab.h>
12 #include <linux/module.h>
13 #include <linux/init.h>
15 #include <linux/log2.h>
16 #include <linux/mount.h>
17 #include <linux/pseudo_fs.h>
18 #include <linux/magic.h>
19 #include <linux/pipe_fs_i.h>
20 #include <linux/uio.h>
21 #include <linux/highmem.h>
22 #include <linux/pagemap.h>
23 #include <linux/audit.h>
24 #include <linux/syscalls.h>
25 #include <linux/fcntl.h>
26 #include <linux/memcontrol.h>
27 #include <linux/watch_queue.h>
28 #include <linux/sysctl.h>
30 #include <linux/uaccess.h>
31 #include <asm/ioctls.h>
36 * New pipe buffers will be restricted to this size while the user is exceeding
37 * their pipe buffer quota. The general pipe use case needs at least two
38 * buffers: one for data yet to be read, and one for new data. If this is less
39 * than two, then a write to a non-empty pipe may block even if the pipe is not
40 * full. This can occur with GNU make jobserver or similar uses of pipes as
41 * semaphores: multiple processes may be waiting to write tokens back to the
42 * pipe before reading tokens: https://lore.kernel.org/lkml/1628086770.5rn8p04n6j.none@localhost/.
44 * Users can reduce their pipe buffers with F_SETPIPE_SZ below this at their
45 * own risk, namely: pipe writes to non-full pipes may block until the pipe is
48 #define PIPE_MIN_DEF_BUFFERS 2
51 * The max size that a non-root user is allowed to grow the pipe. Can
52 * be set by root in /proc/sys/fs/pipe-max-size
54 static unsigned int pipe_max_size
= 1048576;
56 /* Maximum allocatable pages per user. Hard limit is unset by default, soft
57 * matches default values.
59 static unsigned long pipe_user_pages_hard
;
60 static unsigned long pipe_user_pages_soft
= PIPE_DEF_BUFFERS
* INR_OPEN_CUR
;
63 * We use head and tail indices that aren't masked off, except at the point of
64 * dereference, but rather they're allowed to wrap naturally. This means there
65 * isn't a dead spot in the buffer, but the ring has to be a power of two and
67 * -- David Howells 2019-09-23.
69 * Reads with count = 0 should always return 0.
70 * -- Julian Bradfield 1999-06-07.
72 * FIFOs and Pipes now generate SIGIO for both readers and writers.
73 * -- Jeremy Elson <jelson@circlemud.org> 2001-08-16
75 * pipe_read & write cleanup
76 * -- Manfred Spraul <manfred@colorfullife.com> 2002-05-09
79 #define cmp_int(l, r) ((l > r) - (l < r))
81 #ifdef CONFIG_PROVE_LOCKING
82 static int pipe_lock_cmp_fn(const struct lockdep_map
*a
,
83 const struct lockdep_map
*b
)
85 return cmp_int((unsigned long) a
, (unsigned long) b
);
89 void pipe_lock(struct pipe_inode_info
*pipe
)
92 mutex_lock(&pipe
->mutex
);
94 EXPORT_SYMBOL(pipe_lock
);
96 void pipe_unlock(struct pipe_inode_info
*pipe
)
99 mutex_unlock(&pipe
->mutex
);
101 EXPORT_SYMBOL(pipe_unlock
);
103 void pipe_double_lock(struct pipe_inode_info
*pipe1
,
104 struct pipe_inode_info
*pipe2
)
106 BUG_ON(pipe1
== pipe2
);
115 static void anon_pipe_buf_release(struct pipe_inode_info
*pipe
,
116 struct pipe_buffer
*buf
)
118 struct page
*page
= buf
->page
;
121 * If nobody else uses this page, and we don't already have a
122 * temporary page, let's keep track of it as a one-deep
123 * allocation cache. (Otherwise just release our reference to it)
125 if (page_count(page
) == 1 && !pipe
->tmp_page
)
126 pipe
->tmp_page
= page
;
131 static bool anon_pipe_buf_try_steal(struct pipe_inode_info
*pipe
,
132 struct pipe_buffer
*buf
)
134 struct page
*page
= buf
->page
;
136 if (page_count(page
) != 1)
138 memcg_kmem_uncharge_page(page
, 0);
139 __SetPageLocked(page
);
144 * generic_pipe_buf_try_steal - attempt to take ownership of a &pipe_buffer
145 * @pipe: the pipe that the buffer belongs to
146 * @buf: the buffer to attempt to steal
149 * This function attempts to steal the &struct page attached to
150 * @buf. If successful, this function returns 0 and returns with
151 * the page locked. The caller may then reuse the page for whatever
152 * he wishes; the typical use is insertion into a different file
155 bool generic_pipe_buf_try_steal(struct pipe_inode_info
*pipe
,
156 struct pipe_buffer
*buf
)
158 struct page
*page
= buf
->page
;
161 * A reference of one is golden, that means that the owner of this
162 * page is the only one holding a reference to it. lock the page
165 if (page_count(page
) == 1) {
171 EXPORT_SYMBOL(generic_pipe_buf_try_steal
);
174 * generic_pipe_buf_get - get a reference to a &struct pipe_buffer
175 * @pipe: the pipe that the buffer belongs to
176 * @buf: the buffer to get a reference to
179 * This function grabs an extra reference to @buf. It's used in
180 * the tee() system call, when we duplicate the buffers in one
183 bool generic_pipe_buf_get(struct pipe_inode_info
*pipe
, struct pipe_buffer
*buf
)
185 return try_get_page(buf
->page
);
187 EXPORT_SYMBOL(generic_pipe_buf_get
);
190 * generic_pipe_buf_release - put a reference to a &struct pipe_buffer
191 * @pipe: the pipe that the buffer belongs to
192 * @buf: the buffer to put a reference to
195 * This function releases a reference to @buf.
197 void generic_pipe_buf_release(struct pipe_inode_info
*pipe
,
198 struct pipe_buffer
*buf
)
202 EXPORT_SYMBOL(generic_pipe_buf_release
);
204 static const struct pipe_buf_operations anon_pipe_buf_ops
= {
205 .release
= anon_pipe_buf_release
,
206 .try_steal
= anon_pipe_buf_try_steal
,
207 .get
= generic_pipe_buf_get
,
210 /* Done while waiting without holding the pipe lock - thus the READ_ONCE() */
211 static inline bool pipe_readable(const struct pipe_inode_info
*pipe
)
213 unsigned int head
= READ_ONCE(pipe
->head
);
214 unsigned int tail
= READ_ONCE(pipe
->tail
);
215 unsigned int writers
= READ_ONCE(pipe
->writers
);
217 return !pipe_empty(head
, tail
) || !writers
;
220 static inline unsigned int pipe_update_tail(struct pipe_inode_info
*pipe
,
221 struct pipe_buffer
*buf
,
224 pipe_buf_release(pipe
, buf
);
227 * If the pipe has a watch_queue, we need additional protection
228 * by the spinlock because notifications get posted with only
229 * this spinlock, no mutex
231 if (pipe_has_watch_queue(pipe
)) {
232 spin_lock_irq(&pipe
->rd_wait
.lock
);
233 #ifdef CONFIG_WATCH_QUEUE
234 if (buf
->flags
& PIPE_BUF_FLAG_LOSS
)
235 pipe
->note_loss
= true;
238 spin_unlock_irq(&pipe
->rd_wait
.lock
);
243 * Without a watch_queue, we can simply increment the tail
244 * without the spinlock - the mutex is enough.
251 pipe_read(struct kiocb
*iocb
, struct iov_iter
*to
)
253 size_t total_len
= iov_iter_count(to
);
254 struct file
*filp
= iocb
->ki_filp
;
255 struct pipe_inode_info
*pipe
= filp
->private_data
;
256 bool wake_writer
= false, wake_next_reader
= false;
259 /* Null read succeeds. */
260 if (unlikely(total_len
== 0))
264 mutex_lock(&pipe
->mutex
);
267 * We only wake up writers if the pipe was full when we started reading
268 * and it is no longer full after reading to avoid unnecessary wakeups.
270 * But when we do wake up writers, we do so using a sync wakeup
271 * (WF_SYNC), because we want them to get going and generate more
275 /* Read ->head with a barrier vs post_one_notification() */
276 unsigned int head
= smp_load_acquire(&pipe
->head
);
277 unsigned int tail
= pipe
->tail
;
278 unsigned int mask
= pipe
->ring_size
- 1;
280 #ifdef CONFIG_WATCH_QUEUE
281 if (pipe
->note_loss
) {
282 struct watch_notification n
;
290 n
.type
= WATCH_TYPE_META
;
291 n
.subtype
= WATCH_META_LOSS_NOTIFICATION
;
292 n
.info
= watch_sizeof(n
);
293 if (copy_to_iter(&n
, sizeof(n
), to
) != sizeof(n
)) {
299 total_len
-= sizeof(n
);
300 pipe
->note_loss
= false;
304 if (!pipe_empty(head
, tail
)) {
305 struct pipe_buffer
*buf
= &pipe
->bufs
[tail
& mask
];
306 size_t chars
= buf
->len
;
310 if (chars
> total_len
) {
311 if (buf
->flags
& PIPE_BUF_FLAG_WHOLE
) {
319 error
= pipe_buf_confirm(pipe
, buf
);
326 written
= copy_page_to_iter(buf
->page
, buf
->offset
, chars
, to
);
327 if (unlikely(written
< chars
)) {
333 buf
->offset
+= chars
;
336 /* Was it a packet buffer? Clean up and exit */
337 if (buf
->flags
& PIPE_BUF_FLAG_PACKET
) {
343 wake_writer
|= pipe_full(head
, tail
, pipe
->max_usage
);
344 tail
= pipe_update_tail(pipe
, buf
, tail
);
348 break; /* common path: read succeeded */
349 if (!pipe_empty(head
, tail
)) /* More to do? */
357 if ((filp
->f_flags
& O_NONBLOCK
) ||
358 (iocb
->ki_flags
& IOCB_NOWAIT
)) {
362 mutex_unlock(&pipe
->mutex
);
365 * We only get here if we didn't actually read anything.
367 * However, we could have seen (and removed) a zero-sized
368 * pipe buffer, and might have made space in the buffers
371 * You can't make zero-sized pipe buffers by doing an empty
372 * write (not even in packet mode), but they can happen if
373 * the writer gets an EFAULT when trying to fill a buffer
374 * that already got allocated and inserted in the buffer
377 * So we still need to wake up any pending writers in the
378 * _very_ unlikely case that the pipe was full, but we got
381 if (unlikely(wake_writer
))
382 wake_up_interruptible_sync_poll(&pipe
->wr_wait
, EPOLLOUT
| EPOLLWRNORM
);
383 kill_fasync(&pipe
->fasync_writers
, SIGIO
, POLL_OUT
);
386 * But because we didn't read anything, at this point we can
387 * just return directly with -ERESTARTSYS if we're interrupted,
388 * since we've done any required wakeups and there's no need
389 * to mark anything accessed. And we've dropped the lock.
391 if (wait_event_interruptible_exclusive(pipe
->rd_wait
, pipe_readable(pipe
)) < 0)
395 wake_next_reader
= true;
396 mutex_lock(&pipe
->mutex
);
398 if (pipe_empty(pipe
->head
, pipe
->tail
))
399 wake_next_reader
= false;
400 mutex_unlock(&pipe
->mutex
);
403 wake_up_interruptible_sync_poll(&pipe
->wr_wait
, EPOLLOUT
| EPOLLWRNORM
);
404 if (wake_next_reader
)
405 wake_up_interruptible_sync_poll(&pipe
->rd_wait
, EPOLLIN
| EPOLLRDNORM
);
406 kill_fasync(&pipe
->fasync_writers
, SIGIO
, POLL_OUT
);
412 static inline int is_packetized(struct file
*file
)
414 return (file
->f_flags
& O_DIRECT
) != 0;
417 /* Done while waiting without holding the pipe lock - thus the READ_ONCE() */
418 static inline bool pipe_writable(const struct pipe_inode_info
*pipe
)
420 unsigned int head
= READ_ONCE(pipe
->head
);
421 unsigned int tail
= READ_ONCE(pipe
->tail
);
422 unsigned int max_usage
= READ_ONCE(pipe
->max_usage
);
424 return !pipe_full(head
, tail
, max_usage
) ||
425 !READ_ONCE(pipe
->readers
);
429 pipe_write(struct kiocb
*iocb
, struct iov_iter
*from
)
431 struct file
*filp
= iocb
->ki_filp
;
432 struct pipe_inode_info
*pipe
= filp
->private_data
;
435 size_t total_len
= iov_iter_count(from
);
437 bool was_empty
= false;
438 bool wake_next_writer
= false;
441 * Reject writing to watch queue pipes before the point where we lock
443 * Otherwise, lockdep would be unhappy if the caller already has another
445 * If we had to support locking a normal pipe and a notification pipe at
446 * the same time, we could set up lockdep annotations for that, but
447 * since we don't actually need that, it's simpler to just bail here.
449 if (pipe_has_watch_queue(pipe
))
452 /* Null write succeeds. */
453 if (unlikely(total_len
== 0))
456 mutex_lock(&pipe
->mutex
);
458 if (!pipe
->readers
) {
459 send_sig(SIGPIPE
, current
, 0);
465 * If it wasn't empty we try to merge new data into
468 * That naturally merges small writes, but it also
469 * page-aligns the rest of the writes for large writes
470 * spanning multiple pages.
473 was_empty
= pipe_empty(head
, pipe
->tail
);
474 chars
= total_len
& (PAGE_SIZE
-1);
475 if (chars
&& !was_empty
) {
476 unsigned int mask
= pipe
->ring_size
- 1;
477 struct pipe_buffer
*buf
= &pipe
->bufs
[(head
- 1) & mask
];
478 int offset
= buf
->offset
+ buf
->len
;
480 if ((buf
->flags
& PIPE_BUF_FLAG_CAN_MERGE
) &&
481 offset
+ chars
<= PAGE_SIZE
) {
482 ret
= pipe_buf_confirm(pipe
, buf
);
486 ret
= copy_page_from_iter(buf
->page
, offset
, chars
, from
);
487 if (unlikely(ret
< chars
)) {
493 if (!iov_iter_count(from
))
499 if (!pipe
->readers
) {
500 send_sig(SIGPIPE
, current
, 0);
507 if (!pipe_full(head
, pipe
->tail
, pipe
->max_usage
)) {
508 unsigned int mask
= pipe
->ring_size
- 1;
509 struct pipe_buffer
*buf
;
510 struct page
*page
= pipe
->tmp_page
;
514 page
= alloc_page(GFP_HIGHUSER
| __GFP_ACCOUNT
);
515 if (unlikely(!page
)) {
516 ret
= ret
? : -ENOMEM
;
519 pipe
->tmp_page
= page
;
522 /* Allocate a slot in the ring in advance and attach an
523 * empty buffer. If we fault or otherwise fail to use
524 * it, either the reader will consume it or it'll still
525 * be there for the next write.
527 pipe
->head
= head
+ 1;
529 /* Insert it into the buffer array */
530 buf
= &pipe
->bufs
[head
& mask
];
532 buf
->ops
= &anon_pipe_buf_ops
;
535 if (is_packetized(filp
))
536 buf
->flags
= PIPE_BUF_FLAG_PACKET
;
538 buf
->flags
= PIPE_BUF_FLAG_CAN_MERGE
;
539 pipe
->tmp_page
= NULL
;
541 copied
= copy_page_from_iter(page
, 0, PAGE_SIZE
, from
);
542 if (unlikely(copied
< PAGE_SIZE
&& iov_iter_count(from
))) {
550 if (!iov_iter_count(from
))
554 if (!pipe_full(head
, pipe
->tail
, pipe
->max_usage
))
557 /* Wait for buffer space to become available. */
558 if ((filp
->f_flags
& O_NONBLOCK
) ||
559 (iocb
->ki_flags
& IOCB_NOWAIT
)) {
564 if (signal_pending(current
)) {
571 * We're going to release the pipe lock and wait for more
572 * space. We wake up any readers if necessary, and then
573 * after waiting we need to re-check whether the pipe
574 * become empty while we dropped the lock.
576 mutex_unlock(&pipe
->mutex
);
578 wake_up_interruptible_sync_poll(&pipe
->rd_wait
, EPOLLIN
| EPOLLRDNORM
);
579 kill_fasync(&pipe
->fasync_readers
, SIGIO
, POLL_IN
);
580 wait_event_interruptible_exclusive(pipe
->wr_wait
, pipe_writable(pipe
));
581 mutex_lock(&pipe
->mutex
);
582 was_empty
= pipe_empty(pipe
->head
, pipe
->tail
);
583 wake_next_writer
= true;
586 if (pipe_full(pipe
->head
, pipe
->tail
, pipe
->max_usage
))
587 wake_next_writer
= false;
588 mutex_unlock(&pipe
->mutex
);
591 * If we do do a wakeup event, we do a 'sync' wakeup, because we
592 * want the reader to start processing things asap, rather than
593 * leave the data pending.
595 * This is particularly important for small writes, because of
596 * how (for example) the GNU make jobserver uses small writes to
597 * wake up pending jobs
599 * Epoll nonsensically wants a wakeup whether the pipe
600 * was already empty or not.
602 if (was_empty
|| pipe
->poll_usage
)
603 wake_up_interruptible_sync_poll(&pipe
->rd_wait
, EPOLLIN
| EPOLLRDNORM
);
604 kill_fasync(&pipe
->fasync_readers
, SIGIO
, POLL_IN
);
605 if (wake_next_writer
)
606 wake_up_interruptible_sync_poll(&pipe
->wr_wait
, EPOLLOUT
| EPOLLWRNORM
);
607 if (ret
> 0 && sb_start_write_trylock(file_inode(filp
)->i_sb
)) {
608 int err
= file_update_time(filp
);
611 sb_end_write(file_inode(filp
)->i_sb
);
616 static long pipe_ioctl(struct file
*filp
, unsigned int cmd
, unsigned long arg
)
618 struct pipe_inode_info
*pipe
= filp
->private_data
;
619 unsigned int count
, head
, tail
, mask
;
623 mutex_lock(&pipe
->mutex
);
627 mask
= pipe
->ring_size
- 1;
629 while (tail
!= head
) {
630 count
+= pipe
->bufs
[tail
& mask
].len
;
633 mutex_unlock(&pipe
->mutex
);
635 return put_user(count
, (int __user
*)arg
);
637 #ifdef CONFIG_WATCH_QUEUE
638 case IOC_WATCH_QUEUE_SET_SIZE
: {
640 mutex_lock(&pipe
->mutex
);
641 ret
= watch_queue_set_size(pipe
, arg
);
642 mutex_unlock(&pipe
->mutex
);
646 case IOC_WATCH_QUEUE_SET_FILTER
:
647 return watch_queue_set_filter(
648 pipe
, (struct watch_notification_filter __user
*)arg
);
656 /* No kernel lock held - fine */
658 pipe_poll(struct file
*filp
, poll_table
*wait
)
661 struct pipe_inode_info
*pipe
= filp
->private_data
;
662 unsigned int head
, tail
;
664 /* Epoll has some historical nasty semantics, this enables them */
665 WRITE_ONCE(pipe
->poll_usage
, true);
668 * Reading pipe state only -- no need for acquiring the semaphore.
670 * But because this is racy, the code has to add the
671 * entry to the poll table _first_ ..
673 if (filp
->f_mode
& FMODE_READ
)
674 poll_wait(filp
, &pipe
->rd_wait
, wait
);
675 if (filp
->f_mode
& FMODE_WRITE
)
676 poll_wait(filp
, &pipe
->wr_wait
, wait
);
679 * .. and only then can you do the racy tests. That way,
680 * if something changes and you got it wrong, the poll
681 * table entry will wake you up and fix it.
683 head
= READ_ONCE(pipe
->head
);
684 tail
= READ_ONCE(pipe
->tail
);
687 if (filp
->f_mode
& FMODE_READ
) {
688 if (!pipe_empty(head
, tail
))
689 mask
|= EPOLLIN
| EPOLLRDNORM
;
690 if (!pipe
->writers
&& filp
->f_pipe
!= pipe
->w_counter
)
694 if (filp
->f_mode
& FMODE_WRITE
) {
695 if (!pipe_full(head
, tail
, pipe
->max_usage
))
696 mask
|= EPOLLOUT
| EPOLLWRNORM
;
698 * Most Unices do not set EPOLLERR for FIFOs but on Linux they
699 * behave exactly like pipes for poll().
708 static void put_pipe_info(struct inode
*inode
, struct pipe_inode_info
*pipe
)
712 spin_lock(&inode
->i_lock
);
713 if (!--pipe
->files
) {
714 inode
->i_pipe
= NULL
;
717 spin_unlock(&inode
->i_lock
);
720 free_pipe_info(pipe
);
724 pipe_release(struct inode
*inode
, struct file
*file
)
726 struct pipe_inode_info
*pipe
= file
->private_data
;
728 mutex_lock(&pipe
->mutex
);
729 if (file
->f_mode
& FMODE_READ
)
731 if (file
->f_mode
& FMODE_WRITE
)
734 /* Was that the last reader or writer, but not the other side? */
735 if (!pipe
->readers
!= !pipe
->writers
) {
736 wake_up_interruptible_all(&pipe
->rd_wait
);
737 wake_up_interruptible_all(&pipe
->wr_wait
);
738 kill_fasync(&pipe
->fasync_readers
, SIGIO
, POLL_IN
);
739 kill_fasync(&pipe
->fasync_writers
, SIGIO
, POLL_OUT
);
741 mutex_unlock(&pipe
->mutex
);
743 put_pipe_info(inode
, pipe
);
748 pipe_fasync(int fd
, struct file
*filp
, int on
)
750 struct pipe_inode_info
*pipe
= filp
->private_data
;
753 mutex_lock(&pipe
->mutex
);
754 if (filp
->f_mode
& FMODE_READ
)
755 retval
= fasync_helper(fd
, filp
, on
, &pipe
->fasync_readers
);
756 if ((filp
->f_mode
& FMODE_WRITE
) && retval
>= 0) {
757 retval
= fasync_helper(fd
, filp
, on
, &pipe
->fasync_writers
);
758 if (retval
< 0 && (filp
->f_mode
& FMODE_READ
))
759 /* this can happen only if on == T */
760 fasync_helper(-1, filp
, 0, &pipe
->fasync_readers
);
762 mutex_unlock(&pipe
->mutex
);
766 unsigned long account_pipe_buffers(struct user_struct
*user
,
767 unsigned long old
, unsigned long new)
769 return atomic_long_add_return(new - old
, &user
->pipe_bufs
);
772 bool too_many_pipe_buffers_soft(unsigned long user_bufs
)
774 unsigned long soft_limit
= READ_ONCE(pipe_user_pages_soft
);
776 return soft_limit
&& user_bufs
> soft_limit
;
779 bool too_many_pipe_buffers_hard(unsigned long user_bufs
)
781 unsigned long hard_limit
= READ_ONCE(pipe_user_pages_hard
);
783 return hard_limit
&& user_bufs
> hard_limit
;
786 bool pipe_is_unprivileged_user(void)
788 return !capable(CAP_SYS_RESOURCE
) && !capable(CAP_SYS_ADMIN
);
791 struct pipe_inode_info
*alloc_pipe_info(void)
793 struct pipe_inode_info
*pipe
;
794 unsigned long pipe_bufs
= PIPE_DEF_BUFFERS
;
795 struct user_struct
*user
= get_current_user();
796 unsigned long user_bufs
;
797 unsigned int max_size
= READ_ONCE(pipe_max_size
);
799 pipe
= kzalloc(sizeof(struct pipe_inode_info
), GFP_KERNEL_ACCOUNT
);
803 if (pipe_bufs
* PAGE_SIZE
> max_size
&& !capable(CAP_SYS_RESOURCE
))
804 pipe_bufs
= max_size
>> PAGE_SHIFT
;
806 user_bufs
= account_pipe_buffers(user
, 0, pipe_bufs
);
808 if (too_many_pipe_buffers_soft(user_bufs
) && pipe_is_unprivileged_user()) {
809 user_bufs
= account_pipe_buffers(user
, pipe_bufs
, PIPE_MIN_DEF_BUFFERS
);
810 pipe_bufs
= PIPE_MIN_DEF_BUFFERS
;
813 if (too_many_pipe_buffers_hard(user_bufs
) && pipe_is_unprivileged_user())
814 goto out_revert_acct
;
816 pipe
->bufs
= kcalloc(pipe_bufs
, sizeof(struct pipe_buffer
),
820 init_waitqueue_head(&pipe
->rd_wait
);
821 init_waitqueue_head(&pipe
->wr_wait
);
822 pipe
->r_counter
= pipe
->w_counter
= 1;
823 pipe
->max_usage
= pipe_bufs
;
824 pipe
->ring_size
= pipe_bufs
;
825 pipe
->nr_accounted
= pipe_bufs
;
827 mutex_init(&pipe
->mutex
);
828 lock_set_cmp_fn(&pipe
->mutex
, pipe_lock_cmp_fn
, NULL
);
833 (void) account_pipe_buffers(user
, pipe_bufs
, 0);
840 void free_pipe_info(struct pipe_inode_info
*pipe
)
844 #ifdef CONFIG_WATCH_QUEUE
845 if (pipe
->watch_queue
)
846 watch_queue_clear(pipe
->watch_queue
);
849 (void) account_pipe_buffers(pipe
->user
, pipe
->nr_accounted
, 0);
850 free_uid(pipe
->user
);
851 for (i
= 0; i
< pipe
->ring_size
; i
++) {
852 struct pipe_buffer
*buf
= pipe
->bufs
+ i
;
854 pipe_buf_release(pipe
, buf
);
856 #ifdef CONFIG_WATCH_QUEUE
857 if (pipe
->watch_queue
)
858 put_watch_queue(pipe
->watch_queue
);
861 __free_page(pipe
->tmp_page
);
866 static struct vfsmount
*pipe_mnt __ro_after_init
;
869 * pipefs_dname() is called from d_path().
871 static char *pipefs_dname(struct dentry
*dentry
, char *buffer
, int buflen
)
873 return dynamic_dname(buffer
, buflen
, "pipe:[%lu]",
874 d_inode(dentry
)->i_ino
);
877 static const struct dentry_operations pipefs_dentry_operations
= {
878 .d_dname
= pipefs_dname
,
881 static struct inode
* get_pipe_inode(void)
883 struct inode
*inode
= new_inode_pseudo(pipe_mnt
->mnt_sb
);
884 struct pipe_inode_info
*pipe
;
889 inode
->i_ino
= get_next_ino();
891 pipe
= alloc_pipe_info();
895 inode
->i_pipe
= pipe
;
897 pipe
->readers
= pipe
->writers
= 1;
898 inode
->i_fop
= &pipefifo_fops
;
901 * Mark the inode dirty from the very beginning,
902 * that way it will never be moved to the dirty
903 * list because "mark_inode_dirty()" will think
904 * that it already _is_ on the dirty list.
906 inode
->i_state
= I_DIRTY
;
907 inode
->i_mode
= S_IFIFO
| S_IRUSR
| S_IWUSR
;
908 inode
->i_uid
= current_fsuid();
909 inode
->i_gid
= current_fsgid();
910 simple_inode_init_ts(inode
);
921 int create_pipe_files(struct file
**res
, int flags
)
923 struct inode
*inode
= get_pipe_inode();
930 if (flags
& O_NOTIFICATION_PIPE
) {
931 error
= watch_queue_init(inode
->i_pipe
);
933 free_pipe_info(inode
->i_pipe
);
939 f
= alloc_file_pseudo(inode
, pipe_mnt
, "",
940 O_WRONLY
| (flags
& (O_NONBLOCK
| O_DIRECT
)),
943 free_pipe_info(inode
->i_pipe
);
948 f
->private_data
= inode
->i_pipe
;
951 res
[0] = alloc_file_clone(f
, O_RDONLY
| (flags
& O_NONBLOCK
),
953 if (IS_ERR(res
[0])) {
954 put_pipe_info(inode
, inode
->i_pipe
);
956 return PTR_ERR(res
[0]);
958 res
[0]->private_data
= inode
->i_pipe
;
961 stream_open(inode
, res
[0]);
962 stream_open(inode
, res
[1]);
966 static int __do_pipe_flags(int *fd
, struct file
**files
, int flags
)
971 if (flags
& ~(O_CLOEXEC
| O_NONBLOCK
| O_DIRECT
| O_NOTIFICATION_PIPE
))
974 error
= create_pipe_files(files
, flags
);
978 error
= get_unused_fd_flags(flags
);
983 error
= get_unused_fd_flags(flags
);
988 audit_fd_pair(fdr
, fdw
);
991 /* pipe groks IOCB_NOWAIT */
992 files
[0]->f_mode
|= FMODE_NOWAIT
;
993 files
[1]->f_mode
|= FMODE_NOWAIT
;
1004 int do_pipe_flags(int *fd
, int flags
)
1006 struct file
*files
[2];
1007 int error
= __do_pipe_flags(fd
, files
, flags
);
1009 fd_install(fd
[0], files
[0]);
1010 fd_install(fd
[1], files
[1]);
1016 * sys_pipe() is the normal C calling standard for creating
1017 * a pipe. It's not the way Unix traditionally does this, though.
1019 static int do_pipe2(int __user
*fildes
, int flags
)
1021 struct file
*files
[2];
1025 error
= __do_pipe_flags(fd
, files
, flags
);
1027 if (unlikely(copy_to_user(fildes
, fd
, sizeof(fd
)))) {
1030 put_unused_fd(fd
[0]);
1031 put_unused_fd(fd
[1]);
1034 fd_install(fd
[0], files
[0]);
1035 fd_install(fd
[1], files
[1]);
1041 SYSCALL_DEFINE2(pipe2
, int __user
*, fildes
, int, flags
)
1043 return do_pipe2(fildes
, flags
);
1046 SYSCALL_DEFINE1(pipe
, int __user
*, fildes
)
1048 return do_pipe2(fildes
, 0);
1052 * This is the stupid "wait for pipe to be readable or writable"
1055 * See pipe_read/write() for the proper kind of exclusive wait,
1056 * but that requires that we wake up any other readers/writers
1057 * if we then do not end up reading everything (ie the whole
1058 * "wake_next_reader/writer" logic in pipe_read/write()).
1060 void pipe_wait_readable(struct pipe_inode_info
*pipe
)
1063 wait_event_interruptible(pipe
->rd_wait
, pipe_readable(pipe
));
1067 void pipe_wait_writable(struct pipe_inode_info
*pipe
)
1070 wait_event_interruptible(pipe
->wr_wait
, pipe_writable(pipe
));
1075 * This depends on both the wait (here) and the wakeup (wake_up_partner)
1076 * holding the pipe lock, so "*cnt" is stable and we know a wakeup cannot
1077 * race with the count check and waitqueue prep.
1079 * Normally in order to avoid races, you'd do the prepare_to_wait() first,
1080 * then check the condition you're waiting for, and only then sleep. But
1081 * because of the pipe lock, we can check the condition before being on
1084 * We use the 'rd_wait' waitqueue for pipe partner waiting.
1086 static int wait_for_partner(struct pipe_inode_info
*pipe
, unsigned int *cnt
)
1088 DEFINE_WAIT(rdwait
);
1091 while (cur
== *cnt
) {
1092 prepare_to_wait(&pipe
->rd_wait
, &rdwait
, TASK_INTERRUPTIBLE
);
1095 finish_wait(&pipe
->rd_wait
, &rdwait
);
1097 if (signal_pending(current
))
1100 return cur
== *cnt
? -ERESTARTSYS
: 0;
1103 static void wake_up_partner(struct pipe_inode_info
*pipe
)
1105 wake_up_interruptible_all(&pipe
->rd_wait
);
1108 static int fifo_open(struct inode
*inode
, struct file
*filp
)
1110 struct pipe_inode_info
*pipe
;
1111 bool is_pipe
= inode
->i_sb
->s_magic
== PIPEFS_MAGIC
;
1116 spin_lock(&inode
->i_lock
);
1117 if (inode
->i_pipe
) {
1118 pipe
= inode
->i_pipe
;
1120 spin_unlock(&inode
->i_lock
);
1122 spin_unlock(&inode
->i_lock
);
1123 pipe
= alloc_pipe_info();
1127 spin_lock(&inode
->i_lock
);
1128 if (unlikely(inode
->i_pipe
)) {
1129 inode
->i_pipe
->files
++;
1130 spin_unlock(&inode
->i_lock
);
1131 free_pipe_info(pipe
);
1132 pipe
= inode
->i_pipe
;
1134 inode
->i_pipe
= pipe
;
1135 spin_unlock(&inode
->i_lock
);
1138 filp
->private_data
= pipe
;
1139 /* OK, we have a pipe and it's pinned down */
1141 mutex_lock(&pipe
->mutex
);
1143 /* We can only do regular read/write on fifos */
1144 stream_open(inode
, filp
);
1146 switch (filp
->f_mode
& (FMODE_READ
| FMODE_WRITE
)) {
1150 * POSIX.1 says that O_NONBLOCK means return with the FIFO
1151 * opened, even when there is no process writing the FIFO.
1154 if (pipe
->readers
++ == 0)
1155 wake_up_partner(pipe
);
1157 if (!is_pipe
&& !pipe
->writers
) {
1158 if ((filp
->f_flags
& O_NONBLOCK
)) {
1159 /* suppress EPOLLHUP until we have
1161 filp
->f_pipe
= pipe
->w_counter
;
1163 if (wait_for_partner(pipe
, &pipe
->w_counter
))
1172 * POSIX.1 says that O_NONBLOCK means return -1 with
1173 * errno=ENXIO when there is no process reading the FIFO.
1176 if (!is_pipe
&& (filp
->f_flags
& O_NONBLOCK
) && !pipe
->readers
)
1180 if (!pipe
->writers
++)
1181 wake_up_partner(pipe
);
1183 if (!is_pipe
&& !pipe
->readers
) {
1184 if (wait_for_partner(pipe
, &pipe
->r_counter
))
1189 case FMODE_READ
| FMODE_WRITE
:
1192 * POSIX.1 leaves this case "undefined" when O_NONBLOCK is set.
1193 * This implementation will NEVER block on a O_RDWR open, since
1194 * the process can at least talk to itself.
1201 if (pipe
->readers
== 1 || pipe
->writers
== 1)
1202 wake_up_partner(pipe
);
1211 mutex_unlock(&pipe
->mutex
);
1215 if (!--pipe
->readers
)
1216 wake_up_interruptible(&pipe
->wr_wait
);
1221 if (!--pipe
->writers
)
1222 wake_up_interruptible_all(&pipe
->rd_wait
);
1227 mutex_unlock(&pipe
->mutex
);
1229 put_pipe_info(inode
, pipe
);
1233 const struct file_operations pipefifo_fops
= {
1235 .read_iter
= pipe_read
,
1236 .write_iter
= pipe_write
,
1238 .unlocked_ioctl
= pipe_ioctl
,
1239 .release
= pipe_release
,
1240 .fasync
= pipe_fasync
,
1241 .splice_write
= iter_file_splice_write
,
1245 * Currently we rely on the pipe array holding a power-of-2 number
1246 * of pages. Returns 0 on error.
1248 unsigned int round_pipe_size(unsigned int size
)
1250 if (size
> (1U << 31))
1253 /* Minimum pipe size, as required by POSIX */
1254 if (size
< PAGE_SIZE
)
1257 return roundup_pow_of_two(size
);
1261 * Resize the pipe ring to a number of slots.
1263 * Note the pipe can be reduced in capacity, but only if the current
1264 * occupancy doesn't exceed nr_slots; if it does, EBUSY will be
1267 int pipe_resize_ring(struct pipe_inode_info
*pipe
, unsigned int nr_slots
)
1269 struct pipe_buffer
*bufs
;
1270 unsigned int head
, tail
, mask
, n
;
1272 bufs
= kcalloc(nr_slots
, sizeof(*bufs
),
1273 GFP_KERNEL_ACCOUNT
| __GFP_NOWARN
);
1274 if (unlikely(!bufs
))
1277 spin_lock_irq(&pipe
->rd_wait
.lock
);
1278 mask
= pipe
->ring_size
- 1;
1282 n
= pipe_occupancy(head
, tail
);
1284 spin_unlock_irq(&pipe
->rd_wait
.lock
);
1290 * The pipe array wraps around, so just start the new one at zero
1291 * and adjust the indices.
1294 unsigned int h
= head
& mask
;
1295 unsigned int t
= tail
& mask
;
1297 memcpy(bufs
, pipe
->bufs
+ t
,
1298 n
* sizeof(struct pipe_buffer
));
1300 unsigned int tsize
= pipe
->ring_size
- t
;
1302 memcpy(bufs
+ tsize
, pipe
->bufs
,
1303 h
* sizeof(struct pipe_buffer
));
1304 memcpy(bufs
, pipe
->bufs
+ t
,
1305 tsize
* sizeof(struct pipe_buffer
));
1314 pipe
->ring_size
= nr_slots
;
1315 if (pipe
->max_usage
> nr_slots
)
1316 pipe
->max_usage
= nr_slots
;
1320 if (!pipe_has_watch_queue(pipe
)) {
1321 pipe
->max_usage
= nr_slots
;
1322 pipe
->nr_accounted
= nr_slots
;
1325 spin_unlock_irq(&pipe
->rd_wait
.lock
);
1327 /* This might have made more room for writers */
1328 wake_up_interruptible(&pipe
->wr_wait
);
1333 * Allocate a new array of pipe buffers and copy the info over. Returns the
1334 * pipe size if successful, or return -ERROR on error.
1336 static long pipe_set_size(struct pipe_inode_info
*pipe
, unsigned int arg
)
1338 unsigned long user_bufs
;
1339 unsigned int nr_slots
, size
;
1342 if (pipe_has_watch_queue(pipe
))
1345 size
= round_pipe_size(arg
);
1346 nr_slots
= size
>> PAGE_SHIFT
;
1352 * If trying to increase the pipe capacity, check that an
1353 * unprivileged user is not trying to exceed various limits
1354 * (soft limit check here, hard limit check just below).
1355 * Decreasing the pipe capacity is always permitted, even
1356 * if the user is currently over a limit.
1358 if (nr_slots
> pipe
->max_usage
&&
1359 size
> pipe_max_size
&& !capable(CAP_SYS_RESOURCE
))
1362 user_bufs
= account_pipe_buffers(pipe
->user
, pipe
->nr_accounted
, nr_slots
);
1364 if (nr_slots
> pipe
->max_usage
&&
1365 (too_many_pipe_buffers_hard(user_bufs
) ||
1366 too_many_pipe_buffers_soft(user_bufs
)) &&
1367 pipe_is_unprivileged_user()) {
1369 goto out_revert_acct
;
1372 ret
= pipe_resize_ring(pipe
, nr_slots
);
1374 goto out_revert_acct
;
1376 return pipe
->max_usage
* PAGE_SIZE
;
1379 (void) account_pipe_buffers(pipe
->user
, nr_slots
, pipe
->nr_accounted
);
1384 * Note that i_pipe and i_cdev share the same location, so checking ->i_pipe is
1385 * not enough to verify that this is a pipe.
1387 struct pipe_inode_info
*get_pipe_info(struct file
*file
, bool for_splice
)
1389 struct pipe_inode_info
*pipe
= file
->private_data
;
1391 if (file
->f_op
!= &pipefifo_fops
|| !pipe
)
1393 if (for_splice
&& pipe_has_watch_queue(pipe
))
1398 long pipe_fcntl(struct file
*file
, unsigned int cmd
, unsigned int arg
)
1400 struct pipe_inode_info
*pipe
;
1403 pipe
= get_pipe_info(file
, false);
1407 mutex_lock(&pipe
->mutex
);
1411 ret
= pipe_set_size(pipe
, arg
);
1414 ret
= pipe
->max_usage
* PAGE_SIZE
;
1421 mutex_unlock(&pipe
->mutex
);
1425 static const struct super_operations pipefs_ops
= {
1426 .destroy_inode
= free_inode_nonrcu
,
1427 .statfs
= simple_statfs
,
1431 * pipefs should _never_ be mounted by userland - too much of security hassle,
1432 * no real gain from having the whole file system mounted. So we don't need
1433 * any operations on the root directory. However, we need a non-trivial
1434 * d_name - pipe: will go nicely and kill the special-casing in procfs.
1437 static int pipefs_init_fs_context(struct fs_context
*fc
)
1439 struct pseudo_fs_context
*ctx
= init_pseudo(fc
, PIPEFS_MAGIC
);
1442 ctx
->ops
= &pipefs_ops
;
1443 ctx
->dops
= &pipefs_dentry_operations
;
1447 static struct file_system_type pipe_fs_type
= {
1449 .init_fs_context
= pipefs_init_fs_context
,
1450 .kill_sb
= kill_anon_super
,
1453 #ifdef CONFIG_SYSCTL
1454 static int do_proc_dopipe_max_size_conv(unsigned long *lvalp
,
1456 int write
, void *data
)
1461 val
= round_pipe_size(*lvalp
);
1467 unsigned int val
= *valp
;
1468 *lvalp
= (unsigned long) val
;
1474 static int proc_dopipe_max_size(const struct ctl_table
*table
, int write
,
1475 void *buffer
, size_t *lenp
, loff_t
*ppos
)
1477 return do_proc_douintvec(table
, write
, buffer
, lenp
, ppos
,
1478 do_proc_dopipe_max_size_conv
, NULL
);
1481 static const struct ctl_table fs_pipe_sysctls
[] = {
1483 .procname
= "pipe-max-size",
1484 .data
= &pipe_max_size
,
1485 .maxlen
= sizeof(pipe_max_size
),
1487 .proc_handler
= proc_dopipe_max_size
,
1490 .procname
= "pipe-user-pages-hard",
1491 .data
= &pipe_user_pages_hard
,
1492 .maxlen
= sizeof(pipe_user_pages_hard
),
1494 .proc_handler
= proc_doulongvec_minmax
,
1497 .procname
= "pipe-user-pages-soft",
1498 .data
= &pipe_user_pages_soft
,
1499 .maxlen
= sizeof(pipe_user_pages_soft
),
1501 .proc_handler
= proc_doulongvec_minmax
,
1506 static int __init
init_pipe_fs(void)
1508 int err
= register_filesystem(&pipe_fs_type
);
1511 pipe_mnt
= kern_mount(&pipe_fs_type
);
1512 if (IS_ERR(pipe_mnt
)) {
1513 err
= PTR_ERR(pipe_mnt
);
1514 unregister_filesystem(&pipe_fs_type
);
1517 #ifdef CONFIG_SYSCTL
1518 register_sysctl_init("fs", fs_pipe_sysctls
);
1523 fs_initcall(init_pipe_fs
);