freebsd kernel with SKQ
Go to file
Ed Schouten 4ef9bd22ed Improve typing of POSIX search tree functions.
Back in 2015 when I reimplemented these functions to use an AVL tree, I
was annoyed by the weakness of the typing of these functions. Both tree
nodes and keys are represented by 'void *', meaning that things like the
documentation for these functions are an absolute train wreck.

To make things worse, users of these functions need to cast the return
value of tfind()/tsearch() from 'void *' to 'type_of_key **' in order to
access the key. Technically speaking such casts violate aliasing rules.
I've observed actual breakages as a result of this by enabling features
like LTO.

I've filed a bug report at the Austin Group. Looking at the way the bug
got resolved, they made a pretty good step in the right direction. A new
type 'posix_tnode' has been added to correspond to tree nodes. It is
still defined as 'void' for source-level compatibility, but in the very
far future it could be replaced by a proper structure type containing a
key pointer.

MFC after:	1 month
Differential Revision:	https://reviews.freebsd.org/D8205
2016-10-13 18:25:40 +00:00
bin sh: Do not import IFS's value from the environment. 2016-10-08 13:40:12 +00:00
cddl Corrected non-portable reuse of va_list in dt_printf() 2016-10-11 16:12:12 +00:00
contrib MFV r307214: 2016-10-13 11:40:34 +00:00
crypto Merge OpenSSL 1.0.2j. 2016-09-26 14:22:17 +00:00
etc Install etc/rc.d/zfsbe when MK_ZFS != no 2016-10-13 07:10:27 +00:00
gnu Avoid using 'head' in generating groff doc date 2016-10-12 15:49:20 +00:00
include Improve typing of POSIX search tree functions. 2016-10-13 18:25:40 +00:00
kerberos5 DIRDEPS_BUILD: Update dependencies 2016-06-14 16:55:05 +00:00
lib Improve typing of POSIX search tree functions. 2016-10-13 18:25:40 +00:00
libexec Use SRCTOP instead of the longhand version for defining the path to contrib/atf 2016-09-20 16:24:22 +00:00
release Use the armv6 GENERIC kernel in the release images on hardware this kernel 2016-10-12 15:29:22 +00:00
rescue DIRDEPS_BUILD: Build crunchide for the host. 2016-09-01 23:52:25 +00:00
sbin Fix spurious white space introduced in r301059 2016-10-09 03:20:58 +00:00
secure Merge OpenSSL 1.0.2j. 2016-09-26 14:22:17 +00:00
share Extract suffix rules into bsd.suffixes[-posix].mk. 2016-10-12 00:42:46 +00:00
sys With build without TCP_HHOOK and with INVARIANTS. Before mutex.h came 2016-10-13 18:02:29 +00:00
targets DIRDEPS_BUILD: Connect new directories. 2016-09-23 22:46:19 +00:00
tests Skip test on MIPS as we don't have shared page implemented yet. 2016-10-10 14:21:40 +00:00
tools Also, remove etc/rc.d/zfsbe when MK_ZFS == no 2016-10-13 07:12:20 +00:00
usr.bin Fix printf format warning. 2016-10-11 17:11:17 +00:00
usr.sbin 'b' is short for --binary, it isn't 'a'. 2016-10-13 17:03:54 +00:00
.arcconfig callsign isn't required anymore 2016-09-29 06:19:45 +00:00
.arclint phabricator related changes: 2015-04-20 20:33:22 +00:00
COPYRIGHT Bump copyright year. 2015-12-31 11:21:45 +00:00
LOCKS
MAINTAINERS Remove myself from kern_timeout.c yeah! 2016-07-27 20:37:32 +00:00
Makefile Add a 'make print-dir' that simply traverses all directories and prints them. 2016-08-31 19:30:52 +00:00
Makefile.inc1 groff is not needed in the bootstrap tools if the system is built 2016-10-08 18:57:11 +00:00
Makefile.libcompat Fix in-tree GCC builds after r304681. 2016-08-23 19:29:37 +00:00
ObsoleteFiles.inc Remove mqtest{3,4} from the obsoleted list. 2016-10-11 15:55:45 +00:00
README README: remove nonexistent 'games' directory. 2016-05-18 10:43:13 +00:00
UPDATING In the TCP stack, the hhook(9) framework provides hooks for kernel modules 2016-10-12 02:16:42 +00:00

This is the top level of the FreeBSD source directory.  This file
was last revised on:
$FreeBSD$

For copyright information, please see the file COPYRIGHT in this
directory (additional copyright information also exists for some
sources in this tree - please see the specific source directories for
more information).

The Makefile in this directory supports a number of targets for
building components (or all) of the FreeBSD source tree.  See build(7)
and http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html
for more information, including setting make(1) variables.

The `buildkernel` and `installkernel` targets build and install
the kernel and the modules (see below).  Please see the top of
the Makefile in this directory for more information on the
standard build targets and compile-time flags.

Building a kernel is a somewhat more involved process.  See build(7), config(8),
and http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html
for more information.

Note: If you want to build and install the kernel with the
`buildkernel` and `installkernel` targets, you might need to build
world before.  More information is available in the handbook.

The kernel configuration files reside in the sys/<arch>/conf
sub-directory.  GENERIC is the default configuration used in release builds.
NOTES contains entries and documentation for all possible
devices, not just those commonly used.


Source Roadmap:
---------------

bin		System/user commands.

cddl		Various commands and libraries under the Common Development
		and Distribution License.

contrib		Packages contributed by 3rd parties.

crypto		Cryptography stuff (see crypto/README).

etc		Template files for /etc.

gnu		Various commands and libraries under the GNU Public License.
		Please see gnu/COPYING* for more information.

include		System include files.

kerberos5	Kerberos5 (Heimdal) package.

lib		System libraries.

libexec		System daemons.

release		Release building Makefile & associated tools.

rescue		Build system for statically linked /rescue utilities.

sbin		System commands.

secure		Cryptographic libraries and commands.

share		Shared resources.

sys		Kernel sources.

tests		Regression tests which can be run by Kyua.  See tests/README
		for additional information.

tools		Utilities for regression testing and miscellaneous tasks.

usr.bin		User commands.

usr.sbin	System administration commands.


For information on synchronizing your source tree with one or more of
the FreeBSD Project's development branches, please see:

  http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/synching.html