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 r267867 from head:

Remove example cvsup config files.

MFC cleanup of libusb20 example

r257779 by hselasky:

- Use libusb20_strerror() function instead of custom usb_error() one.
- Rename "aux.[ch]" to "util.[ch]" which is a more common name for
utility functions and allows checkout on some non-FreeBSD systems
where the "aux.*" namespace is reserved.
- Fix some compile warnings while at it.

r257796 by glebius:

Finish r257779.

PR: 183728

Add sample test programs.

This is a MFC of the following into stable/10:
- r258299 Add some sample test programs.
- r258552 Generate plain sh test programs from a source file.

As usual, "make tinderbox" clean on ref10-amd64.

MFC 256365
Remove most of the ATF tools and the _atf user.

Approved by: re

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

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

- Trim an unused and bogus Makefile for mount_smbfs.
- Reconnect with some minor modifications, in particular now selsocket()
internals are adapted to use sbintime units after recent'ish calloutng
switch.

Add bhyve to examples.

Requested by: alfred, julian
Obtained from: NetApp

Disconnect files removed in r248151

Tone down the encouragement to use cvsup. Add directions to the handbook
pages that cover the more current methods and bring closer to reality.

Add ATF to the build. This is may be a bit rought around the egdes,
but committing it helps to get everyone on the same page and makes
sure we make progress.

Tinderbox breakages that are the result of this commit are entirely
the committer's fault -- in other words: buildworld testing on amd64
only.

Credits follow:

Submitted by: Garrett Cooper <yanegomi@gmail.com>
Sponsored by: Isilon Systems
Based on work by: keramida@
Thanks to: gnn@, mdf@, mlaier@, sjg@
Special thanks to: keramida@

Disconnect non-MPSAFE SMBFS from the build in preparation for dropping
GIANT from VFS. In addition, disconnect also netsmb, which is a base
requirement for SMBFS.

In the while SMBFS regular users can use FUSE interface and smbnetfs
port to work with their SMBFS partitions.

Also, there are ongoing efforts by vendor to support in-kernel smbfs,
so there are good chances that it will get relinked once properly locked.

This is not targeted for MFC.

Disconnect non-MPSAFE NWFS from the build in preparation for dropping
GIANT from VFS. In addition, disconnect also netncp, which is a base
requirement for NWFS.

In the possibility of a future maintenance of the code and later
readd to the FreeBSD base, maybe we should think about a better location
for netncp. I'm not entirely sure the / top location is actually right,
however I will let network people to comment on that more specifically.

This is not targeted for MFC.

Disconnect non-MPSAFE PORTALFS from the build in preparation for dropping
GIANT from VFS.

This is not targeted for MFC.

Remove documentation and www cvsup files as they are no longer useful
with the switch to subversion.

Approved by: gjb (man pages)
Approved by: cperciva (example files, implicit)
MFC after: 1 week

Add some examples about how to use FreeBSD's libusb20 in your own
code.

- Make the default values for tcsh more user friendly
- Add an examples file with many of the not accepted suggestions from the discussion

PR: conf/160689
Reviewed by: many
Discussed on: current
Approved by: cperciva

Add ses/srcs/eltsub.h to the list of files to be installed.
It is required for user-level SES example tools build.

Uuencode the sample "binary" firmware image file (instead of explicitly
adding \0 bytes). This is a technique that would be used in an actual
driver and is more suitable as an example.

Reviewed by: mlaier

Unbreak installworld after r220205.

Noticed by: np
Pointy hat to: emaste

Actually install the example Khelp module committed in r218545.

Sponsored by: FreeBSD Foundation
MFC after: 4 weeks
X-MFC with: r218545

Add Makefile entry to install two new example files.

MFC after: 2 weeks

indent.pro example: actually install the sample file

Please welcome HAST - Highly Avalable Storage.

HAST allows to transparently store data on two physically separated machines
connected over the TCP/IP network. HAST works in Primary-Secondary
(Master-Backup, Master-Slave) configuration, which means that only one of the
cluster nodes can be active at any given time. Only Primary node is able to
handle I/O requests to HAST-managed devices. Currently HAST is limited to two
cluster nodes in total.

HAST operates on block level - it provides disk-like devices in /dev/hast/
directory for use by file systems and/or applications. Working on block level
makes it transparent for file systems and applications. There in no difference
between using HAST-provided device and raw disk, partition, etc. All of them
are just regular GEOM providers in FreeBSD.

For more information please consult hastd(8), hastctl(8) and hast.conf(5)
manual pages, as well as http://wiki.FreeBSD.org/HAST.

Sponsored by: FreeBSD Foundation
Sponsored by: OMCnet Internet Service GmbH
Sponsored by: TransIP BV

Remove examples for pppd and SLIP-related stuff.

Install firmware(9) examples.

MFC after: 1 month

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

Remove netatm from HEAD as it is not MPSAFE and relies on the now removed
NET_NEEDS_GIANT. netatm has been disconnected from the build for ten
months in HEAD/RELENG_7. Specifics:

- netatm include files
- netatm command line management tools
- libatm
- ATM parts in rescue and sysinstall
- sample configuration files and documents
- kernel support as a module or in NOTES
- netgraph wrapper nodes for netatm
- ctags data for netatm.
- netatm-specific device drivers.

MFC after: 3 weeks
Reviewed by: bz
Discussed with: bms, bz, harti

Disconnect netatm from the build as it is not MPSAFE and relies on
NET_NEEDS_GIANT, which will shortly be removed. This is done in a
away that it may be easily reattached to the build before 7.1 if
appropriate locking is added. Specifics:

- Don't install netatm include files
- Disconnect netatm command line management tools
- Don't build libatm
- Don't include ATM parts in rescue or sysinstall
- Don't install sample configuration files and documents
- Don't build kernel support as a module or in NOTES
- Don't build netgraph wrapper nodes for netatm

This removes the last remaining consumer of NET_NEEDS_GIANT.

Reviewed by: harti
Discussed with: bz, bms
Approved by: re (kensmith)

Retire /usr/share/examples/netgraph/bluetooth/rc.bluetooth.

MFC after: 1 week

Reimplementation of world/kernel build options. For details, see:

http://lists.freebsd.org/pipermail/freebsd-current/2006-March/061725.html

The src.conf(5) manpage is to follow in a few days.

Brought to you by: imp, jhb, kris, phk, ru (all bugs are mine)

Link mdoc/example.9 to the build.

Add support files for using text from the POSIX specification in
FreeBSD manual pages:

- POSIX-copyright contains copyright text to be used in manual pages
which has POSIX text inserted.
- deshallify.sh is a shell script which removes many of the ``shall''
statements from the POSIX text and therefore making the text more
readable.

Real work to make this happen by: nectar, ru

Unbreak the install.

Start the dreaded NOFOO -> NO_FOO conversion.

OK'ed by: core

For variables that are only checked with defined(), don't provide
any fake value.

Bring in some examples (and create space for future work here):
- Add OpenBSD example rulesets as advertised in etc/pf.conf and pf.conf(5)
- Tweak the pointer to fit the FreeBSD default location share/examples/pf
- Account for the new directory in BSD.usr.dist (no hier(7) change required
as share/examples is an opaque item there).

Obtained from: OpenBSD
Reminded by: Thomas T. Veldhouse
PR: docs/71691
MFC after: 2 days

Move references to the recently removed worm directory.

Connect /etc/bluetooth and /usr/share/examples/netgraph/bluetooth to the build.

Reviewed by: imp, simon
Approved by: imp (mentor)

Install new files from examples dir.

Approved by: re (previously)

test -h is deprecated; use -L instead.

PR: bin/40846

Drop support for COPY, -c has been the default mode of install(1)
for a long time now.

Approved by: bde

Don't install any old cruft present in the tree, including
editor backups, .orig or .rej files, etc. Make transition
from SHARED=symlinks to SHARED=copies and vice versa work.

Submitted by: des, ru

s/${INSTALL} -c/${INSTALL} ${COPY}/

Replaced hacks in sbin/Makefile,v 1.99 and usr.sbin/Makefile,v 1.217
with the NO_IPFILTER make.conf(5) knob.

(So that we can "make the-rest-of-the-world" again.)

Arrange for the smbfs examples to be installed.

We don't install dot.nsmbrc or smbfs.sh.sample, since we already install
the former as /etc/nsmb.conf and the latter is unnecessary, since
boot-time mounts can be arranged directly within /etc/fstab without fear
of breaking the boot when the smbfs port (now unnecessary is removed).

The MFC reminder below is subject to <re@FreeBSD.org> approval
priod to 4.5-RELEASE.

MFC after: 1 week

Back out my last commit. Ruslan (ru) has a better fix.

Make sure the copies: and symlinks: targets exist in the case of the
empty ".for ..." loop.

Back out my previous commit. It is not necessary anymore now that Ruslan
fixed the ipfilter directory with a NOOBJ.

Unbreak make world by adding .CURDIR here and there.

Submitted by: Harry Starr <starr3@gccs.com.au>

Add the ipfilter subdirectory

PR: 26763

Revert previous commit.

Requested by: bde

Remove support for symlinks instead of copies. This also avoids
using mtree. Space is being saved by other means.

$Id$ -> $FreeBSD$

Do nothing for the etc-examples target when SHARED=symlinks, since we'll
end up trying to install into the source directory.

Reported by: bde

Actually install the virgin copies of the /etc files that we so proudly
claim to install in /usr/share/examples/etc/README.examples .

PR: 5207
Reported by: "Wayne M. Barnes" <wayne@barnes1.wustl.edu>

Revert $FreeBSD$ to $Id$

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.

Use -C instead of -c for installing non-header source files.

Do the right thing even if the source tree is a bunch of symlinks, say
lndir'd to a CDROM.
Submitted-By: Richard Wackerbarth <rkw@shrimp.dataplex.net>

Use `make' loops instead of shell loops to install things. This fixes
the verbose output for `make -s install' and gives nicer output for
`make install' and `make -n install'. This method should be used more.

Install meteor and startslip. In fact, install all subdirectories
except CVS. This method should be used more so that SUBDIR lists don't
have to be changed so often (special cases could be handled by short
exclusion lists).

Dive in the deep end and change the examples installation method.. :-/
the 'rm -rf' and cpio was bugging me because rdist used to get false hits
and also it installs the files with the wrong uid.
I've tried this by running a find .. -exec ${INSTALL} ...; instead...

Add sup.

Add startslip example

Added a copy of my little program to find the IP address of the outgoing
interface for a particular remote host.

Requested by: Joerg Wunsch <j@uriah.heep.sax.de>

Do not omit the Makefiles when installing the examples; they are part
of them. Also correct the omission of CVS files by abusing the find
syntax instead of grepping.

Closes PR #bin/636.

Remove syscons example

Don't install Makefile

Make installs better, install the FAQ stuff, don't install CVS-dirs.

added ibcs2 directory.

Add syscons to DIRS list, pointed by wollman

Fixed typo that caused make install to fall if SHARED=copies.

Revert to installing /etc/files from src/etc.

Install /etc from the same source as /usr/share/examples/etc (mostly).

Don't be so aggressive when installing examples. We still delete the
directories or links before we install the new things, but now we don't
delete /usr/share/examples itself, so other examples installed from
other places in the tree will not be touched.

Define NOOBJ so that install doesn't try to get the sources from the
wrong place.

Use ${ECHO} instead of `echo' so that `make -s' is fairly quiet.

Actually install LKM examples.

Added example of how to tell various FreeBSD versions apart.

Make examples install into /usr/share/examples. Like with includes, you
have a choice between SHARED=copies and SHARED=symlinks. The default
is to copy.

I have also added a /usr/share/examples/etc directory, where I hope to
have all sample configuration files which in real use go into /etc installed.
(This way, if the user really screws the real one up, they can always go
back to a known-working distribution copy, even if they don't have sources.)