FreeBSD src
Go to file
Alan Cox c70af4875e As of r257209, all architectures have defined VM_KMEM_SIZE_SCALE. In other
words, every architecture is now auto-sizing the kmem arena.  This revision
changes kmeminit() so that the definition of VM_KMEM_SIZE_SCALE becomes
mandatory and the definition of VM_KMEM_SIZE becomes optional.

Replace or eliminate all existing definitions of VM_KMEM_SIZE.  With
auto-sizing enabled, VM_KMEM_SIZE effectively became an alternate spelling
for VM_KMEM_SIZE_MIN on most architectures.  Use VM_KMEM_SIZE_MIN for
clarity.

Change kmeminit() so that the effect of defining VM_KMEM_SIZE is similar to
that of setting the tunable vm.kmem_size.  Whereas the macros
VM_KMEM_SIZE_{MAX,MIN,SCALE} have had the same effect as the tunables
vm.kmem_size_{max,min,scale}, the effects of VM_KMEM_SIZE and vm.kmem_size
have been distinct.  In particular, whereas VM_KMEM_SIZE was overridden by
VM_KMEM_SIZE_{MAX,MIN,SCALE} and vm.kmem_size_{max,min,scale}, vm.kmem_size
was not.  Remedy this inconsistency.  Now, VM_KMEM_SIZE can be used to set
the size of the kmem arena at compile-time without that value being
overridden by auto-sizing.

Update the nearby comments to reflect the kmem submap being replaced by the
kmem arena.  Stop duplicating the auto-sizing formula in every machine-
dependent vmparam.h and place it in kmeminit() where auto-sizing takes
place.

Reviewed by:	kib (an earlier version)
Sponsored by:	EMC / Isilon Storage Division
2013-11-08 16:25:00 +00:00
bin sh(1),limits(1): Document kqueues (-k) rlimit. 2013-11-01 13:57:30 +00:00
cddl Quiesce warning assigning to void * from const ctf_header_t * by explicity casting 2013-11-04 21:32:07 +00:00
contrib Propagate ancient fix from Junos. 2013-11-07 00:36:39 +00:00
crypto Unbreak the WITHOUT_KERBEROS build and try to reduce the odds of a 2013-09-23 20:35:54 +00:00
etc Build and install the atf tests. 2013-11-08 14:33:41 +00:00
games Refresh the tips for the new pkg system. 2013-10-03 11:51:15 +00:00
gnu Revert r257691, r257645: 2013-11-06 03:36:43 +00:00
include Remove the WITH_LIBICONV_COMPAT hack that seems to do more harm than 2013-11-03 19:04:57 +00:00
kerberos5 Clean up the Kerberos build by turning libheimipcc and libheimipcs into 2013-09-10 18:40:43 +00:00
lib Build and install the atf tests. 2013-11-08 14:33:41 +00:00
libexec Build and install the atf tests. 2013-11-08 14:33:41 +00:00
release Remove extra target from 'memstick' that I forgot to remove before 2013-11-07 18:59:06 +00:00
rescue - Trim an unused and bogus Makefile for mount_smbfs. 2013-06-28 21:00:08 +00:00
sbin devd: lower priority of action execution logging to info 2013-11-07 16:24:31 +00:00
secure Unbreak the WITHOUT_KERBEROS build and try to reduce the odds of a 2013-09-23 20:35:54 +00:00
share Subsume the functionality of MK_ATF into MK_TESTS. 2013-11-08 14:24:47 +00:00
sys As of r257209, all architectures have defined VM_KMEM_SIZE_SCALE. In other 2013-11-08 16:25:00 +00:00
tests Install category Kyuafiles from their category directories. 2013-11-08 14:29:06 +00:00
tools Handle the removal of the test suite when WITHOUT_TESTS=yes. 2013-11-08 14:26:52 +00:00
usr.bin Build and install the atf tests. 2013-11-08 14:33:41 +00:00
usr.sbin I often forget that debugFile can begin with a + for deciding that debug 2013-11-08 10:19:48 +00:00
COPYRIGHT Happy New Year 2013! 2012-12-31 11:22:55 +00:00
LOCKS Explicitly require Security Officer's approval for kernel PRNG bits. 2013-09-17 14:19:05 +00:00
MAINTAINERS Add myself as maintainer for nvme(4), nvd(4) and nvmecontrol(8). 2013-07-31 18:18:02 +00:00
Makefile Remove the armv6eb architecture as it is unused, and almost certainly 2013-09-22 07:30:17 +00:00
Makefile.inc1 Subsume the functionality of MK_ATF into MK_TESTS. 2013-11-08 14:24:47 +00:00
ObsoleteFiles.inc Finish r257779. 2013-11-07 14:05:49 +00:00
README Add the cddl/ directory. 2010-11-14 11:32:56 +00:00
UPDATING Subsume the functionality of MK_ATF into MK_TESTS. 2013-11-08 14:24:47 +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 ``world''
target should only be used in cases where the source tree has not
changed from the currently running version.  See:
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, 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.

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.

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.

rescue		Build system for statically linked /rescue utilities.

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