- Copy stable/10@285827 to releng/10.2 in preparation for 10.2-RC1
builds.
- Update newvers.sh to reflect RC1.
- Update __FreeBSD_version to reflect 10.2.
- Update default pkg(8) configuration to use the quarterly branch.[1]

Discussed with: re, portmgr [1]
Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

MFC r272884:

accept(2) may and can return EAGAIN, document it.

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

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

accept(2): Update portability note for accept4().

The accept(2) man page warns that O_NONBLOCK and other properties on the
new socket may vary across implementations. However, this issue only
applies to accept() and not to accept4(). On the other hand, accept4()
is not commonly available yet.

Reported by: pluknet
Reviewed by: bjk
Approved by: re (kib)

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

Add accept4() system call.

The accept4() function, compared to accept(), allows setting the new file
descriptor atomically close-on-exec and explicitly controlling the
non-blocking status on the new socket. (Note that the latter point means
that accept() is not equivalent to any form of accept4().)

The linuxulator's accept4 implementation leaves a race window where the new
file descriptor is not close-on-exec because it calls sys_accept(). This
implementation leaves no such race window (by using falloc() flags). The
linuxulator could be fixed and simplified by using the new code.

Like accept(), accept4() is async-signal-safe, a cancellation point and
permitted in capability mode.

Keep up with negative addrlen check removal in r249649.

accept(2): Mention inheritance of O_ASYNC and signal destination.

While almost nobody uses O_ASYNC, and rightly so, the inheritance of the
related properties across accept() is a portability issue like the
inheritance of O_NONBLOCK.

Attempt to reduce accidental foot-shooting by pointing out that
accept(2)ed sockets do not necessarily inherit O_NONBLOCK from
listening sockets on non-FreeBSD platforms.

Feet shot: cperciva
MFC after: 1 month

Add Xr to getsockname(2)

Per Regents of the University of Calfornia letter, remove advertising
clause.

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

Document the fact that accept(2) may return EINVAL when addrlen is
negative (in addition to returning EINVAL when called on a descriptor
that is not a socket).

Submitted by: Arne H Juul <arnej@europe.yahoo-inc.com>
PR: docs/80587

Mechanically kill hard sentence breaks.

Be specific about which socket properties are inherited from the original
socket upon accept(2).

PR: docs/54995, kern/45733

Add restrict qualifiers. (docs)

PR: 44394
Submitted by: Craig Rodrigues <rodrige@attbi.com>

Clarify that the second argument to accept() may be a null pointer if
no peer address information is desired.

PR: 56044
Submitted by: Felix Opatz <felix@zotteljedi.de> and
Bernd Luevelsmeyer <bdluevel@heitec.net>
MFC after: 1 month

mdoc(7) police: "The .Fa argument.".

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

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.

mdoc(7) police: sort xrefs.

Some updates to mention accept filters and how
listen queues work in a syncache world.

MFC after: 3 days

Nuke the paragraph that says "One can obtain user connection request
data without confirming the connection by issuing a recvmsg(2) [...]".
There's no such code in the kernel.

PR: 26861
Submitted by: Richard A Steenbergen <ras@e-gerbil.net>,
Tom Rhodes <darklogik@pittgoth.com>

Remove the internal implementation details of wrapping syscalls,
which do not match the reality anyway.

Approved by: deischen, bde

mdoc(7) police: Use the new .In macro for #include statements.

mdoc(7) police: removed HISTORY info from the .Os call.

mdoc(7) police: remove extraneous .Pp before and/or after .Sh.

Fix my ambiguous message about ECONNABORTED.

Submitted by: Ian Dowse <iedowse@maths.tcd.ie>

Add ECONNABORTED to the ERRORS section.

Replace .Va references to function arguments to .Fa references.

Content-free commit: only remove trailing whitespace

The accept() function is a call, not an argument. Also, add: serial
comma, missing-hyphen, and a word-erase character.

Use `Er' variable to define first column width in ERRORS section. It was
initially suggested by mdoc(7) style, but was broken over the years

Introduce ".Lb" macro to libc manpages.

More libraries manpages updates following.

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.

General clean-up of socket.h and associated sources to synchronise up
with NetBSD and the Single Unix Specification v2.

This updates some structures with other, almost equivalent types and
effort is under way to get the whole more consistent.

Also removes a double definition of INET6 and some other clean-ups.

Reviewed by: green, bde, phk
Some part obtained from: NetBSD, SUSv2 specification

$Id$ -> $FreeBSD$

The accept(2) call can fail with EINTR (at least in the threaded context).

PR: docs/8858

Update to reflect reality.
PR: kern/8629

Added EMFILE and ENFILE to errors section.

Obtained from: OpenBSD

add xrefs for getpeername, so other people that look for it can find it.. :)

Update a bunch of man pages to use .Fn instead
of .Nm when referencing funciton names.

Reviewed by: julian and (hsu?)
Submitted by: John Birrel(L?)

changes for threadsafe operations

This commit was generated by cvs2svn to compensate for changes in r1573,
which included commits to RCS files with non-trunk default branches.

BSD 4.4 Lite Lib Sources