- 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 r279896:
Document m_collapse().

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

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

Remove description of deprecated IP fragment checksum support.
Since SMPng it wasn't really supported anymore and if it worked
then only by chance. Only very few drivers ever supported it.

Discussed with: yongari
MFC after: 2 weeks

The argument len of m_pullup(9) could be less than or equal to MHLEN.

Reviewed by: glebius

Fix MINCLSIZE. It should be MHLEN + 1.

Reviewed by: glebius

Typo and mdoc(7) style fixes.

PR: 168117
Submitted by: Nobuyuki Koganemaru (kogane&jp!freebsd!org)
MFC after: 3 days

It is already seven years since mbuf allocator uses same
M_WAITOK/M_NOWAIT flags as malloc(9). Update manual page.

Submitted by: Vadim Goncharov <vadimnuclight tpu.ru>

mdoc: drop redundant .Pp and .LP calls

They have no effect when coming in pairs, or before .Bl/.Bd

Document the MEXTADD macro.

MFC after: 2 weeks

Replaced the misleading uses of a historical artefact M_TRYWAIT with M_WAIT.
Removed dead code that assumed that M_TRYWAIT can return NULL; it's not true
since the advent of MBUMA.

Reviewed by: arch

There are ongoing disputes as to whether we want to switch to directly using
UMA flags M_WAITOK/M_NOWAIT for mbuf(9) allocation.

Give MEXTADD() another argument to make both void pointers to the
free function controlable, instead of passing the KVA of the buffer
storage as the first argument.

Fix all conventional users of the API to pass the KVA of the buffer
as the first argument, to make this a no-op commit.

Likely break the only non-convetional user of the API, after informing
the relevant committer.

Update the mbuf(9) manual page, which was already out of sync on
this point.

Bump __FreeBSD_version to 800016 as there is no way to tell how
many arguments a CPP macro needs any other way.

This paves the way for giving sendfile(9) a way to wait for the
passed storage to have been accessed before returning.

This does not affect the memory layout or size of mbufs.

Parental oversight by: sam and rwatson.

No MFC is anticipated.

Document m_pulldown().

Obtained from: MBUF issues in 4.4BSD IPv6/IPsec support (itojun)

Expand history and authors section of mbuf.9 man page to discuss recent
transition to mbuma (FreeBSD 5.3) and the fact that mbufs are now limited
almost entirely to packet storage, with straight UMA zones being used for
most other network data types.

Explicitly emphasize a facet of m_pullup() that some people seem to
frequently forget. i.e. that you can not keep using pointers to
within the old chain.

o GC MT_FTABLE removed in rev. 1.192 mbuf.h.
o Correct MT_HEADER define.

promote fast ipsec's m_clone routine for public use; it is renamed
m_unshare and the caller can now control how mbufs are allocated

Reviewed by: andre, luigi, mlaier
MFC after: 1 week

Remove references to MEXT_ADD_REF, MEXT_REM_REF and MEXT_IS_REF
which were removed with rev. 1.179 of mbuf.h.

Sponsored by: TCP/IP Optimization Fundraise 2005

describe m_align

Use 'manual page' instead of 'man page' for consistency.

Approved by: re (hrs)

Assorted markup fixes and minor wordsmithing.

Approved by: re

add m_copyup function.. This can be used to help make our ip stack less
alignment restrictive, and help performance on some ethernet cards which
currently copy the entire packet a couple bytes to get the packet aligned
properly...

Wordsmithing by: dwhite
Obtained from: NetBSD (code only)
I'll clean it up later: rwatson

Expand contractions.

Expand *n't contractions.

document m_append

document that m_free returns m_next of the free'd mbuf

MT_TAG is dead.

Mechanically kill hard sentence breaks and double whitespaces.

Forgot to bump the document date, *blush*.

Document mbuf tags based on the OpenBSD manpage.

Submitted by: Gleb Smirnoff

o Document m_getcl(9).

Submitted by: Gleb Smirnoff
MFC after: 2 weeks

o Add a missed description for m_free(9).

Optained from: NetBSD
MFC after: 1 week

Assorted mdoc(7) fixes.

Fix last commit to conform to mdoc style.

Submitted by: hmp

Document the m_defrag function. (Mostly copied from the description
in uipc_mbuf.c)

mtod() returns pointer to the specified type, not necessarily "void *".

Document the functions m_apply() and m_getptr().

Requested by: Maxim Konovalov

Fix MSIZE definition location.

PR: docs/62129
Submitted by: Lee Brotherston <lee@nerds.org.uk> (PR),
Marc Silver <marcs@draenor.org> (patch)
Approved by: blackend (mentor)

As I've been pointed out by Andrew Gallatin, there are some
network interface cards smart (or twisted?) enough to be able
to calculate a TCP/UDP checksum for a packet fragmented by the
host CPU. Therefore the paragraph on the case has been revised.

A couple of minor clarifications.

Add a description for the hardware-assisted checksumming
facilities based on http://people.freebsd.org/~jlemon/csum.txt
and my own observations.

Reformat the list of essential mbuf fields according
to the nice style used in ifnet(9).
This includes specifying field types, starting descriptions
with a capital letter, and ending them with a full stop.
Improve the language a bit, as well.

Update the list of mbuf types from <sys/mbuf.h>.

Update the list of possible mbuf flags from <sys/mbuf.h>.

Remove an extra 'for' in the HISTORY section.

mdoc(7): Properly mark C headers.

Name a function argument "mbuf", not "buf", if it is
a pointer to struct mbuf for clarity and consistency.

Add missing descriptions of macros M_ALIGN and MH_ALIGN.
Remove a reference to the defunct macro M_COPY_PKTHDR;
document the new functions m_dup_pkthdr() and m_move_pkthdr(),
and the macro variant of the latter, M_MOVE_PKTHDR().

Add more markup to the mbuf(9) manpage. This includes:

- tagging plaintext "mbuf", "mbuf cluster", and "mbuf chain"
with .Vt (variable type) since all of them are ways of managing
data, i.e., they can be seen as data types;

- using .Vt/.Va instead of .Li (literal) where appropriate;

- tagging plaintext words that actually refer to function arguments
with .Fa.

Suggested by: ru

Use .Va, not .Fa, to refer to structure members.

mdoc(7) contains an ambiguous statement on the issue,
but our mdoc(7) police's opinion is solid.

Suggested by: ru

Assorted mdoc(7), grammar, spelling, and punctuation fixes.

Approved by: re (blanket)

Remove an extraneous `.El' that was reported by `groff -z`.

Approved by: des (mentor), re (scottl)

Add a description of m_defragrandomfailures.

Add info on how to use the MBUF_STRESS_TEST options. (Only 1 option
at present.)

Return bits which were removed in revision 1.22.

Requested by: imp

Catch up to WAIT/NOWAIT cleanup.

Caution programmers not to confuse M_DONTWAIT with M_NOWAIT. They
are not the same.

Suggested by: Hiten Pandya <hiten@unixdaemons.com>

mdoc(7) police: catch up to the code changes.

Approved by: re

Add m_fixhdr() and m_length().

Update function definitions and required include files to reflect
the current state of the system.

Approved by: alfred

Fixed bitrot in synopsis. Const'ification of m_copydata() had not reached
here.

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

mdoc(7) police: s/BSD/.Bx/ where appropriate.

mdoc(7) police: expand plain text xrefs.

mdoc(7) police:

Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by: Silence from cvs diff -b
MFC after: 7 days

mdoc(7) police: sanitize previous revision changes.

Document recently-implemented m_getm().

Fixed missing and/or wrong and/or extra includes in synopsis.

mdoc(7) police: split punctuation characters + misc fixes.

Prepare for mdoc(7)NG.

Change M_WAIT to M_TRYWAIT, the new name of the flag.

Add description of M_WRITABLE macro and new M_RDONLY flag. Try my best to
conform to line break mdoc FreeBSD standards, although I am new to this.

Reviewed by: sheldonh

Miscellaneous content fixes:

* xref sysctl
* do not mark kern.ipc.mbuf_wait up as a function argument.
* do not mix case of function argument names
* a mbuf -> an mbuf
* if -> whether
* typos

Whitespace only: fix hard sentence breaks now, before people really
get stuck into this page.

Fixup some wrong statements in the new mbuf(9) man page.
Also introduce a bunch of (missed?) macros and functions.
This man page still needs a lot of work, most likely a re-ordering
of the macros/functions, and a more complete, more accurate, listing of
available routines.
A good and worthy start nonetheless.

Add a prototype mbuf.9 man page. Probably needs work, but it's a good
start.

PR: docs/22053
Submitted by: Yar Tikhiy <yar@comp.chem.msu.su>