Find a file
Marcel Moolenaar 5f20d75a5f o In revision 1.45 of exception.S we changed exception_restore to
unconditionally restore ar.k7 (kernel memory stack) and ar.k6
   (kernel register stack). I don't know what I was smoking then,
   but if you unconditionally restore ar.k6, you also want to
   compute its value unconditionally. By having the computation
   predicated and dependent on whether we return to user mode, we
   would end up writing junk (= invalid value for ar.bspstore) if
   we would return to kernel mode. But the whole point of the
   unconditional restoration was that there is a grey area where
   we still need to have ar.k6 restored. If we restore with a junk
   value, we would end up wedging the machine on the next interrupt.
   So, unconditionally calculate the value we unconditionally write
   to ar.k6.

o  The previous braino was found while making the following change:
   We used to clear the lower 9 bits of the value we write to ar.k6.
   The meaning being that we know that the kernel register stack is
   at least 512 byte aligned and simply clearing the lower 9 bits
   allows us to return to a context of which we don't have dirty
   registers on the kernel stack, even though the context that
   entered the kernel does have dirty registers on the kernel stack.
   By masking-off the lower bits, we correctly obtain the base of
   the register stack without having to worry that we didn't actually
   reached the base while unwinding it.
   The change is to mask off the lower 13 bits, knowing that the
   kernel register stack is always 8KB aligned. The advantage is that
   we don't have to worry anymore if there's more than 512 bytes of
   dirty registers on the kernel stack. A situation that frequently
   occurs. In exec_setregs() in machdep.c:1.147 or older, we had to
   deal with that situation by copying the active portion of the
   register stack down in multiples of 512 bytes. Now that we mask off
   the lower 13 bits we don't have to do that at all. Contemporary
   IPF processors have a register file that can hold up to 96 stacked
   registers (=784 bytes [incl. 2 NaT collections]). With no indication
   that register files grow beyond a couple of hundred registers, we
   should not have to worry about it anymore... and yes, 640KB is
   enough for everybody :-)
   This change helps setcontext(2) and cpu_set_upcall_kse() in that
   they can return to completely different contexts without having to
   mess with the kernel stack. Of course exec_setregs() doesn't need
   to do that anymore as well.
2003-08-06 21:32:38 +00:00
bin Clarify that the 'state' information consists of characters, not 2003-08-05 10:31:28 +00:00
contrib Change ieee802 to ieee80211. 2003-08-06 15:19:52 +00:00
crypto Very big makeover in the way telnet, telnetd and libtelnet are built. 2003-07-16 20:59:15 +00:00
etc RFC 3561 (ad-hoc on-demand distance vector routing) was ratified 2003-08-06 18:15:10 +00:00
games LANG->LC_ALL 2003-08-04 21:31:53 +00:00
gnu Added description for the libufs(3) library. 2003-08-05 10:29:50 +00:00
include Make C++ safe 2003-07-14 16:31:20 +00:00
kerberos5 Try a lot harder to get dependancies right. This involves some ugly 2003-07-27 16:49:10 +00:00
lib Document that connect(2) can return EINTR, and that it 2003-08-06 14:21:06 +00:00
libexec Make sure that a "make release" (more accurately the bit that makes 2003-07-24 17:19:15 +00:00
release - Unbreak Alpha snapshots (we were still attempting to build a 2003-08-06 08:09:40 +00:00
rescue When using crunchgen, blow away MAKEFLAGS. This fixes make -j <#> -P 2003-08-01 09:04:32 +00:00
sbin Localize 'ls' output 2003-08-06 08:46:21 +00:00
secure Very big makeover in the way telnet, telnetd and libtelnet are built. 2003-07-16 20:59:15 +00:00
share Update screen(1)-related entries with more recent variants 2003-08-05 08:06:38 +00:00
sys o In revision 1.45 of exception.S we changed exception_restore to 2003-08-06 21:32:38 +00:00
tools Add a comment about hcomp. 2003-08-05 19:35:41 +00:00
usr.bin Add Jonathan Postel's year of birth. 2003-08-06 03:38:12 +00:00
usr.sbin introduced a flag bit "ND6_IFF_ACCEPT_RTADV" in the nd_ifinfo structure to 2003-08-05 14:57:11 +00:00
COPYRIGHT Update to add the July 22, 1999 addendum. 1999-09-05 21:33:47 +00:00
MAINTAINERS I'll maintain dhclient from now on. 2003-08-01 17:54:11 +00:00
Makefile - Don't print "elf" before printing "make world" (aout support has been 2003-08-06 11:06:38 +00:00
Makefile.inc1 Don't lint(1) so early in the build. Its OK to keep this for the 2003-07-24 18:14:29 +00:00
README KerberosIV de-orbit burn continues. Disconnect from "make world". 2003-03-08 10:01:26 +00:00
UPDATING Note da(4) quirks being deprecated and the procedure for re-enabling them. 2003-07-29 04:40:33 +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