Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

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

Merge r258702: Fix some misinformation in netgraph manual pages.

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

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

Add more references.

Submitted by: Dmitry Luhtionov <dmitryluhtionov@gmail.com>
MFC after: 1 week

Fix incorrect usage of 'assure' and 'insure'.

Approved by: rrs (mentor)

Fix typos, spelling, formatting and mdoc mistakes found by Nobuyuki while
translating these manual pages. Minor corrections by me.

Submitted by: Nobuyuki Koganemaru <n-kogane@syd.odn.ne.jp>

Remove now-obsolete Xref to ng_atmpif.4 from netgraph.4.

MFC after: 3 weeks
Spotted by: antoine

Remove ISDN4BSD (I4B) from HEAD as it is not MPSAFE and
parts relied on the now removed NET_NEEDS_GIANT.
Most of I4B has been disconnected from the build
since July 2007 in HEAD/RELENG_7.

This is what was removed:
- configuration in /etc/isdn
- examples
- man pages
- kernel configuration
- sys/i4b (drivers, layers, include files)
- user space tools
- i4b support from ppp
- further documentation

Discussed with: rwatson, re

Revert parts of 1.51 and add a missing \& after "i.e." that is not the
end of a sentence. Ruslan notes that:

* The part about hexadecimal representation was intentional -- node ID
is parsed as the ng_parse_hint32_type, and is represented
(input/output) as a hexadecimal number

* "This value" was more correct, as the alternative name is
"[<value>]:" where <value> is hexadecimal value of the node ID.

* "ID based name" (which is "[<hexid>]:") was correct, and what's now is
incorrect -- node ID (number) cannot be equivalent to a name.

Various textual improvements.

Sort xrefs.

Scheduled mdoc(7) sweep.

Synchronize reference list to the ng_xxx(4) manpages of netgraph nodes
with the actually installed manpages by adding the missing ones. This
way they can be found more easily.

MFC after: 2 days

Slight cosmetic changes.
Also introduce a macro to be called by persistent nodes to signal their
persistence during shutdown to hide this mechanism from the node author.

Make node flags have a consistent style in naming.

Document the change.

The description of ng_mesg.cmd should call it "cmd" to match the struct
definition and netgraph.h.

PR: docs/66539
Submitted by: Michel Lavondes <fox@vader.aacc.cc.md.us>

Markup overhaul and minor word smithing.

Bring this manpage more up-to-date with the current code.

Submitted by: Gleb Smirnoff
Reviewed by: julian, ru

Document that the length of a command string is now 32. Also change all
occurences of the old *LEN definitions to the new *SIZ definitions.

Correct the example how to compare a nodename.
strncmp(name, "fred", NG_NODELEN) may step behind "fred" if the node
name is really fred.

Reminded by: ru

Hiten's patchset for section four manpages, slightly edited by me.

Correct the path to the modules directory.

Ispell sweep of share/man/man4.

mdoc(7) police: removed duplicate xref.

Consistently use 'queueing' instead of 'queuing'. Both spellings are
correct, but the former seems to be preferred. This makes all of the
section-4 manual pages consistent in this respect.

Revert my queueing -> queuing commit. Both spellings are correct, and
some people prefer the former.

Submitted by: ken, nectar

Spelling police: queueing -> queuing

PR: 29985
Submitted by: Joseph Mallett <jmallett@xMach.org>

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

mdoc(7) police: join split punctuation to macro calls.

mdoc(7) police: protect trailing full stops of abbreviations
with a trailing zero-width space: `e.g.\&'.

Grammar: 'effect' is a noun and 'affect' is a verb.

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: removed HISTORY info from the .Os call.

mdoc(7) police: sort SEE ALSO xrefs (sort -b -f +2 -3 +1 -2).

Correct cross-references:
ng_bpf.8 --> ng_bpf.4
ng_ether.8 --> ng_ether.4
ng_iface.8 --> ng_iface.4
ng_pppoe.8 --> ng_pppoe.4
ng_socket.8 --> ng_socket.4
ng_tty.8 --> ng_tty.4
ng_{type}.4 --> /dev/null

MFC after: 1 week

Grammar police: "its", not "it's", is the possessive form of "it".

Eliminate mdocNG warnings caused by misplaced or extraneous macro calls.

Preceed/preceeding are not english words. Use precede or preceding.

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

Add the ability to declare ore-ride methods on a per-hook basis
for the rcvdata() and rcvmsg() methods.

Also bring the man page up to sync with my last commit. (and this one)

Implement direct support for semipersistant nodes.
(e.g. ethernet nodes are persistent until you rip out the hardware)
Use this support in the ethernet and sample nodes.
Add some more abstraction on the 'item's so that node and
hook reference counting can be checked easier.
Slight man page correction.
Make pppoe type dependent on ethernet type.
Clean up node shutdown a little.
Move a mutex from MTX_SPIN to MTX_DEF (oops)
Fix small ref-counting bug.
remove warning on one2many type.

mdoc(7) police: removed leading whitespaces that are not inside
Bd/Ed; these hardly degrade the quality of the produced output.

Fixed mdoc(7)NG warnings introduced in the previous revision.

Part 2 of the netgraph rewrite.
This is mostly cosmetic changes, (though I caught a bug or two while
makeing them)
Reviewed by: archie@freebsd.org

Rewrite of netgraph to start getting ready for SMP.
This version is functional and is aproaching solid..
notice I said APROACHING. There are many node types I cannot test
I have tested: echo hole ppp socket vjc iface tee bpf async tty
The rest compile and "Look" right. More changes to follow.
DEBUGGING is enabled in this code to help if people have problems.

Prepare for mdoc(7)NG.

Divorce the kernel binary ABI version number from the message
format version number. (userland programs should not need to be
recompiled when the netgraph kernel internal ABI is changed.

Also fix modules that don;t handle the fact that a caller may not supply
a return message pointer. (benign at the moment because the calling code
checks, but that will change)

Reviewed by: Archie@freebsd.org
This clears out my outstanding netgraph changes.
There is a netgraph change of design in the offing and this is to some
extent a superset of soem of the new functionality and some of the old
functionality that may be removed.

This code works as before, but allows some new features that I want to
work with and evaluate. It is the basis for a version of netgraph
with integral locking for SMP use.

This is running on my test machine with no new problems :-)

mdoc(7) police: do not split author names in the AUTHORS section.

mdoc(7) police: use the new features of the Nm macro.

Update @freebsd.org email addresses to @FreeBSD.org as is the
precedent.

Change archie's and my email addresses from Whistle.com to FreeBSD.org

Move netgraph node type man pages from section 8 to section 4.

Update the man page to reflect the recent changes to the kernel API for
netgraph.

Remove duplicate word

Add a little more history of when netgraph appeared in FreeBSD.

Reviewed by: asmodai

Manual page style work.
Submitted by: Alexey Zelkin <phantom@FreeBSD.org>
thanks!

Fix typo.

Add two new generic control messages, NGM_ASCII2BINARY and
NGM_BINARY2ASCII, which convert control messages to ASCII and back.
This allows control messages to be sent and received in ASCII form
using ngctl(8), which makes ngctl a lot more useful.

This also allows all the type-specific debugging code in libnetgraph
to go away -- instead, we just ask the node itself to do the ASCII
translation for us.

Currently, all generic control messages are supported, as well as
messages associated with the following node types: async, cisco,
ksocket, and ppp.

See /usr/share/examples/netgraph/ngctl for an example of using this.

Also give ngctl(8) the ability to print out incoming data and
control messages at any time. Eventually nghook(8) may be subsumed.

Several other misc. bug fixes.

Reviewed by: julian

Update references.

Fix some spelling errors.

Whistle's Netgraph link-layer (sometimes more) networking infrastructure.
Been in production for 3 years now. Gives Instant Frame relay to if_sr
and if_ar drivers, and PPPOE support soon. See:
ftp://ftp.whistle.com/pub/archie/netgraph/index.html
for on-line manual pages.

Reviewed by: Doug Rabson (dfr@freebsd.org)
Obtained from: Whistle CVS tree