examples: Install bhyve files on arm64

Sponsored by: Innovate UK

share/examples: move examples into appropriate packages

Allow a new variable SE_xxxPACKAGE to be used to place an example group
into a package.

Move the following examples into existing appropriate packages:

- bhyve examples into FreeBSD-bhyve
- bootforth examples into FreeBSD-bootloader
- csh examples into FreeBSD-csh
- ipfw examples into FreeBSD-ipfw
- jail examples into FreeBSD-jail
- pf examples into FreeBSD-pf
- ppp examples into FreeBSD-ppp
- printing examples into FreeBSD-lp
- uefisign examples into FreeBSD-efi-tools
- ypldap examples into FreeBSD-yp
- hast examples into FreeBSD-hast

Move all other examples into the new 'FreeBSD-examples' package.

This removes a significant number of files from the FreeBSD-utilities
package.

Reviewed by: imp, manu
Pull Request: https://github.com/freebsd/freebsd-src/pull/1176

share/examples/IPv6/USAGE: remove

This document dates from the KAME days and, among other things,
references the 'prefix' command which has not existed for a long time.
Since IPv6 configuration is now documented in the Handbook, remove this
obsolete file.

Reviewed by: imp
Pull Request: https://github.com/freebsd/freebsd-src/pull/1094

Retire old diskless setup scripts

These scripts predate /etc/rc.diskless* and use a different scheme. A
comment was added to them back in 2002 noting they were 3 years old at
that point.

Reviewed by: emaste
Differential Revision: https://reviews.freebsd.org/D41951

Remove $FreeBSD$: one-line sh pattern

Remove /^\s*#[#!]?\s*\$FreeBSD\$.*$\n/

Avoid staging conflict for examples/pf

If we are staging, let examples/pf stage its bits.

snd_uaudio(4): Add some examples accessing USB MIDI devices.

Differential Revision: https://reviews.freebsd.org/D36195
MFC after: 1 week
Sponsored by: NVIDIA Networking

sound: Add an example of basic sound application

This is an example demonstrating the usage of the OSS-compatible APIs
provided by the sound(4) subsystem. It reads frames from a dsp node and
writes them to the same dsp node.

MFC after: 2 weeks
Reviewed by: hselasky, bcr
Differential revision: https://reviews.freebsd.org/D30149

flua: Add a libjail module

libjail is pretty small, so it makes for a good proof of concept demonstrating
how a system library can be wrapped to create a loadable Lua module for flua.

* Introduce 3lua section for man pages
* Add libjail module

Reviewed by: kevans, manpages
Relnotes: yes
Differential Revision: https://reviews.freebsd.org/D26080

pkgbase: Move login.access to usb.bin/login

Also remove the etc-examples target as we don't have any files
to handle here.

Reviewed by: bapt

Remove iBCS2, part1: userspace

iBCS2 was disconnected from the build in 2015 (see r291419)

bsdconfig parts submitted by dteske.

Reviewed by: kib (previous version)
Sponsored by: The FreeBSD Foundation

MK_EFI - Add uefisign and friends to this knob and ensure that we don't
try to build them if MK_OPENSSL is unset.

Reviewed by: emaste imp kevans
Sponsored by: Limelight Networks
Differential Revision: https://reviews.freebsd.org/D15211

Convert share/examples/Makefile over to using FILES and FILESDIR.

The goal is to avoid using install directly so we can make changes the affect
how the entire system is installed, without having to touch many places.

This is part of the packaging base work.

Reviewed by: will
Approved by: bapt (mentor), allanjude (mentor)
Differential Revision: https://reviews.freebsd.org/D1513

Install files added in SVN's r295373, r295457, r295542

Reported by: woodsb02
MFC after: 3 days
X-MFC to: stable/11

Unbreak install

Reported by: cy

Add HAS_TESTS to all Makefiles that are currently using the
`SUBDIR.${MK_TESTS}+= tests` idiom.

This is a follow up to r321912.

Convert traditional ${MK_TESTS} conditional idiom for including test
directories to SUBDIR.${MK_TESTS} idiom

This is being done to pave the way for future work (and homogenity) in
^/projects/make-check-sandbox .

No functional change intended.

MFC after: 1 weeks

Remove unneccessary call to mtree, which, when building as an unprivileged
user (with -DNO_ROOT), resulted in warnings looking like these:

share/man/cat8:
user (9, 3819, not modified: Operation not permitted)
permissions (0755, 0700, modified)

The BSD.usr.mk is already taken care of in etc/Makefile.

Submitted by: Alex Richardson <alr48@cl.cam.ac.uk>
Reviewed by: bdrewery
MFC after: 1 month
Sponsored by: DARPA, AFRL
Differential Revision: https://reviews.freebsd.org/D9212

share: normalize paths using SRCTOP-relative paths or :H when possible

This simplifies make logic/output

MFC after: 1 month
Sponsored by: Dell EMC Isilon

Fix packaging /usr/share/examples/etc.

Reported by: woodsb02
MFC after: 3 days
X-MFC-With: r308148
Sponsored by: The FreeBSD Foundation

Install/Connect ypldap.conf(5) on examples.

Update share/examples/* to properly install /usr/share/examples.

As result of this, a new examples package is now created.

Note, this is only effective with 'SHARED=copies' (the default),
as the 'SHARED=symlinks' mechanism will create a symlink to the
source tree version of the file(s).

Sponsored by: The FreeBSD Foundation

Rework META_TARGETS so that it automatically adds META_DEPS to the targets.

This will only be done if the target is defined, so if the target is
defined after bsd.sys.mk is included then it needs to manually add
${META_DEPS} still.

Sponsored by: EMC / Isilon Storage Division

META_MODE: Simplify the META_COOKIE handling to use .USE/.USEBEFORE.

Extend it to other cases of meta mode cookies so they get the proper rm
cookie behavior when a .meta file detects it needs to rebuild and fails.

Sponsored by: EMC / Isilon Storage Division

DIRDEPS_BUILD: Fix staging of share/sendmail and share/examples.

Sponsored by: EMC / Isilon Storage Division

META MODE: These need object directories to handle staging.

Sponsored by: EMC / Isilon Storage Division

Add more SUBDIR_PARALLEL.

MFC after: 3 weeks
Sponsored by: EMC / Isilon Storage Division

Move all the dma(8) components into one single directory

Simplifying maintainance and options (only one place to deal with MK_DMAGENT)

This also makes packaging base less intrusive by getting a single point where
to add tags.

Tag examples with targetted packages

Add key/cert generation script for uefisign(8).

(Forgot about Relnotes in the commit that added uefisign(8), so set it here.)

MFC after: 1 month
Relnotes: yes
Sponsored by: The FreeBSD Foundation

Add MK_BHYVE knob for building and installing bhyve(4), et al

MFC after: 2 weeks
Sponsored by: EMC / Isilon Storage Division

Add MK_HAST knob for building and installing hastd(8), et al

MFC after: 2 weeks
Sponsored by: EMC / Isilon Storage Division

Move MK_BHYVE/MK_HYPERV to architecture specific sections in Makefiles
instead of introducing an architecture specific section in src.opts.mk

Make it clear in the documentation that the options only affect certain
architectures to reduce user confusion if the knobs are tweaked

A better method for abstracting this out will be done in the future in a
different commit

Discussed with/Requested by: imp

Honor MK_NETGRAPH for netgraph components

Clean up more usb related files when MK_USB == no when dealing with
manpages, libraries, and binaries

Conditionalize a number of components in the tree

- bootparamd
- bootpd
- finger/fingerd
- ftp/ftpd
- hastctl/hastd
- iscsid, et al
- rbootd
- talk/talkd
- tcpd, et al
- tftp/tftpd

Add src.conf entries for the various components and do a best effort
at adding components to tools/build/mk/OptionalObsoleteFiles.inc

Make building/installing bhyve optional via MK_BHYVE on amd64

Disable building/installing bhyve from src.opts.mk on unsupported
architectures (!amd64)

Check in first src/tests snapshot from NetBSD anoncvs

Sources were obtained like so:

% export CVSROOT="anoncvs@anoncvs.NetBSD.org:/cvsroot"
% cvs -z9 co -D "09/30/2014 20:45" -P src/tests
% mv src/tests/* tests/dist/.

'*CVS*' has been added to svn:ignore to ease updating periodically from
upstream

Some line ending issues had to be resolved with test outputs and scripts
via dos2unix and by deleting the eol-style property set in usr.bin/sort

Discussed with: rpaulo
Sponsored by: EMC / Isilon Storage Division

Remove example cvsup config files.

MFC after: 1 week

Use src.opts.mk in preference to bsd.own.mk except where we need stuff
from the latter.

Add a mailer.conf example to use dma

Add some sample test programs.

This change adds some sample test cases to share/examples/tests/
demonstrating the basic usage of the atf and plain interfaces.

These test programs are fully-functional and are installed as part
of the test suite, which guarantees that the sample code remains
correct. However, they currently mostly serve as a placeholder for
additional examples and may be incomplete (depending on how you
look at them). I will see what else can be useful while working on
documentation.

As a bonus, the addition of these tests exercise the *.test.mk files,
one of which (plain.test.mk) was not yet in use, and also demonstrates
that it's possible to mix different kinds of test programs into the
same test suite.

Approved by: rpaulo (mentor)

Finish r257779.

PR: usb/183728

Remove most of the ATF tools and the _atf user.

This is necessary because ATF is deprecated and it will be replaced by Kyua.

Submitted by: jmmv@netbsd.org
Reviewed by: Garrett Cooper
Approved by: re

- 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

A new jail(8) with a configuration file, to replace the work currently done
by /etc/rc.d/jail.

MFC r206996: indent.pro example: actually install the sample file

indent.pro example: actually install the sample file

MFC r204076,r204077,r204083,r205279:

r204076:

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

r204077:

Remove some lines left over by accident.

r204083:

Add missing KEYWORD line.

Pointed out by: dougb

r205279 sys:

Simplify loops.

MFC r201213:

Remove examples for pppd and SLIP-related stuff.

PR: conf/144950

Create the altix project branch. The altix project will add support
for the SGI Altix 350 to FreeBSD/ia64. The hardware used for porting
is a two-module system, consisting of a base compute module and a
CPU expansion module. SGI's NUMAFlex architecture can be an excellent
platform to test CPU affinity and NUMA-aware features in FreeBSD.

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

MFC r200440 to stable/8:
Install firmware(9) examples.

Remove examples for pppd and SLIP-related stuff.

Install firmware(9) examples.

MFC after: 1 month

- Import the HEAD csup code which is the basis for the cvsmode work.

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.)