src/lib/libc/sys/pipe.2, branch upstream/11.1.0

MFC r303104, r303106:

2016-08-03T16:10:53+00:00

Update to reflect the fact that pipe() is a wrapper around the pipe2()
system call.

Reviewed by:	jhb, wblock
Sponsored by:	DAPRA, AFRL

Change wording to use function rather than system call in the
description
as well.

Authored by:	zeising
Reviewed by:	brooks

Approved by:	re (gjb)
Sponsored by:	DAPRA, AFRL

Replace use of the pipe(2) system call with pipe2(2) with a zero flags

2016-06-22T21:11:27+00:00

value.

This eliminates the need for machine dependant assembly wrappers for
pipe(2).

It also make passing an invalid address to pipe(2) return EFAULT rather
than triggering a segfault.  Document this behavior (which was already
true for pipe2(2), but undocumented).

Reviewed by:	andrew
Approved by:	re (gjb)
Sponsored by:	DARPA, AFRL
Differential Revision:	https://reviews.freebsd.org/D6815

Add some missing .Nm for newer syscalls in existing man pages.

2014-01-11T22:00:16+00:00

MFC after:	1 week

accept(2), pipe(2): Fix .Dd.

2013-05-01T22:47:47+00:00

Add pipe2() system call.

2013-05-01T22:42:42+00:00

The pipe2() function is similar to pipe() but allows setting FD_CLOEXEC and
O_NONBLOCK (on both sides) as part of the function.

If p points to two writable ints, pipe2(p, 0) is equivalent to pipe(p).

If the pointer is not valid, behaviour differs: pipe2() writes into the
array from the kernel like socketpair() does, while pipe() writes into the
array from an architecture-specific assembler wrapper.

Reviewed by:	kan, kib

Several cleanups related to pipe(2).

2008-11-11T14:55:59+00:00

- Use `fildes[2]' instead of `*fildes' to make more clear that pipe(2)
  fills an array with two descriptors.

- Remove EFAULT from the manual page. Because of the current calling
  convention, pipe(2) raises a segmentation fault when an invalid
  address is passed.

- Introduce kern_pipe() to make it easier for binary emulations to
  implement pipe(2).

- Make Linux binary emulation use kern_pipe(), which means we don't have
  to recover td_retval after calling the FreeBSD system call.

Approved by:	rdivacky
Discussed on:	arch

Per Regents of the University of Calfornia letter, remove advertising

2007-01-09T00:28:16+00:00

clause.

# If I've done so improperly on a file, please let me know.

- In pipe() return the error returned by pipe_create(), rather then

2006-01-30T08:25:04+00:00

  hardcoded ENFILES, which is incorrect. pipe_create() can fail due
  to ENOMEM.
- Update manual page, describing ENOMEM return code.

Reviewed by:	arch

Eliminate double whitespace.

2004-07-03T22:30:10+00:00

mdoc(7) police: Tidy up the syscall language.

2002-12-18T09:22:32+00:00

Stop calling system calls "function calls".

Use "The .Fn system call" a-la "The .Nm utility".

When referring to a non-BSD implementation in
the HISTORY section, call syscall a function,
to be safe.