freebsd kernel with SKQ
Go to file
Poul-Henning Kamp 75067f4f70 Add an extensible version of our *printf(3) implementation to libc
on probationary terms:  it may go away again if it transpires it is
a bad idea.

This extensible printf version will only be used if either
    environment variable USE_XPRINTF is defined
or
    one of the extension functions are called.
or
    the global variable __use_xprintf is set greater than zero.

In all other cases our traditional printf implementation will
be used.

The extensible version is slower than the default printf, mostly
because less opportunity for combining I/O operation exists when
faced with extensions.  The default printf on the other hand
is a bad case of spaghetti code.

The extension API has a GLIBC compatible part and a FreeBSD version
of same.  The FreeBSD version exists because the GLIBC version may
run afoul of our FILE * locking in multithreaded programs and it
even further eliminate the opportunities for combining I/O operations.

Include three demo extensions which can be enabled if desired: time
(%T), hexdump (%H) and strvis (%V).

%T can format time_t (%T), struct timeval (%lT) and struct timespec (%llT)
   in one of two human readable duration formats:
	"%.3llT" -> "20349.245"
	"%#.3llT" -> "5h39m9.245"

%H will hexdump a sequence of bytes and takes a pointer and a length
   argument.  The width specifies number of bytes per line.
	"%4H" -> "65 72 20 65"
	"%+4H" -> "0000 65 72 20 65"
	"%#4H" -> "65 72 20 65  |er e|"
	"%+#4H" -> "0000 65 72 20 65  |er e|"

%V will dump a string in strvis format.
	"%V" -> "Hello\tWor\377ld"	(C-style)
	"%0V" -> "Hello\011Wor\377ld"	(octal)
	"%+V" -> "Hello%09Wor%FFld"	(http-style)

Tests, comments, bugreports etc are most welcome.
2005-12-16 18:56:39 +00:00
bin o Now when SIG_IGN signal action for SIGCHLD reap zombies 2005-12-14 17:26:29 +00:00
contrib -mdoc sweep. 2005-11-18 10:56:28 +00:00
crypto Correct a man-in-the-middle SSL version rollback vulnerability. 2005-10-11 11:50:36 +00:00
etc Remove usbd(8) and all references to it. It is no longer necessary 2005-12-15 01:04:51 +00:00
games Add missing John Gilmore quote. 2005-12-12 15:47:33 +00:00
gnu Prepare for MACHINE and hw.machine switching to "pc98" on FreeBSD/pc98. 2005-12-05 14:22:12 +00:00
include Add an extensible version of our *printf(3) implementation to libc 2005-12-16 18:56:39 +00:00
kerberos5 Apply the .PHONY attribute to the ../make*/make* targets. This 2005-11-10 21:03:58 +00:00
lib Add an extensible version of our *printf(3) implementation to libc 2005-12-16 18:56:39 +00:00
libexec Fix a bug in dlinfo(RTLD_DI_SERINFOSIZE) requests. For each search path 2005-11-11 19:57:41 +00:00
release Remove one more reference to usbd.conf. 2005-12-15 01:14:35 +00:00
rescue Install nextboot in /rescue as /rescue/nextboot rather than 2005-12-15 18:29:01 +00:00
sbin Document the pfsync(4) specific maxupd parameter, with text mostly taken 2005-12-16 11:38:18 +00:00
secure Revert last revision by phk@, it's redundant since bsd.incs.mk 2005-11-19 07:04:17 +00:00
share Make the SYNOPSIS section a bit more informative. 2005-12-15 21:02:16 +00:00
sys Use sf_buf_alloc() instead of vm_map_find() on exec_map to create the 2005-12-16 18:34:14 +00:00
tools Fix compiling on platforms with 64bit time_t. 2005-12-16 06:02:44 +00:00
usr.bin Fix the name of the country I was born. 2005-12-14 17:33:12 +00:00
usr.sbin Remove usbd(8) and all references to it. It is no longer necessary 2005-12-15 01:04:51 +00:00
COPYRIGHT Complete 2005 transition. 2005-01-01 07:29:20 +00:00
LOCKS Document the previously existing RELENG_[45]_* security branch locks. 2005-06-02 22:57:30 +00:00
MAINTAINERS Remove extra geom_zero. 2005-12-12 01:28:19 +00:00
Makefile Fix a bug in previous revision: skip LINT if it exists, not NOTES 2005-11-28 11:14:36 +00:00
Makefile.inc1 Use cross-compile friendly spelling of CPUTYPE. 2005-12-07 22:55:29 +00:00
ObsoleteFiles.inc Remove usbd(8) and all references to it. It is no longer necessary 2005-12-15 01:04:51 +00:00
README
UPDATING note shuffle of commonly used programs in tools/tools/ath 2005-12-11 23:18:58 +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, the most
commonly used one being ``world'', which rebuilds and installs
everything in the FreeBSD system from the source tree except the
kernel, the kernel-modules and the contents of /etc.  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, documentation
for which can be found at:
   http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html
And in the config(8) man page.
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 sample kernel configuration files reside in the sys/<arch>/conf
sub-directory (assuming that you've installed the kernel sources), the
file named GENERIC being the one used to build your initial installation
kernel.  The file NOTES contains entries and documentation for all possible
devices, not just those commonly used.  It is the successor of the ancient
LINT file, but in contrast to LINT, it is not buildable as a kernel but a
pure reference and documentation file.


Source Roadmap:
---------------
bin		System/user commands.

contrib		Packages contributed by 3rd parties.

crypto		Cryptography stuff (see crypto/README).

etc		Template files for /etc.

games		Amusements.

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.

sbin		System commands.

secure		Cryptographic libraries and commands.

share		Shared resources.

sys		Kernel sources.

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