freebsd with flexible iflib nic queues
Go to file
Peter Wemm c0345a84aa Introduce minidumps. Full physical memory crash dumps are still available
via the debug.minidump sysctl and tunable.

Traditional dumps store all physical memory.  This was once a good thing
when machines had a maximum of 64M of ram and 1GB of kvm.  These days,
machines often have many gigabytes of ram and a smaller amount of kvm.
libkvm+kgdb don't have a way to access physical ram that is not mapped
into kvm at the time of the crash dump, so the extra ram being dumped
is mostly wasted.

Minidumps invert the process.  Instead of dumping physical memory in
in order to guarantee that all of kvm's backing is dumped, minidumps
instead dump only memory that is actively mapped into kvm.

amd64 has a direct map region that things like UMA use.  Obviously we
cannot dump all of the direct map region because that is effectively
an old style all-physical-memory dump.  Instead, introduce a bitmap
and two helper routines (dump_add_page(pa) and dump_drop_page(pa)) that
allow certain critical direct map pages to be included in the dump.
uma_machdep.c's allocator is the intended consumer.

Dumps are a custom format.  At the very beginning of the file is a header,
then a copy of the message buffer, then the bitmap of pages present in
the dump, then the final level of the kvm page table trees (2MB mappings
are expanded into a 4K page mappings), then the sparse physical pages
according to the bitmap.  libkvm can now conveniently access the kvm
page table entries.

Booting my test 8GB machine, forcing it into ddb and forcing a dump
leads to a 48MB minidump.  While this is a best case, I expect minidumps
to be in the 100MB-500MB range.  Obviously, never larger than physical
memory of course.

minidumps are on by default.  It would want be necessary to turn them off
if it was necessary to debug corrupt kernel page table management as that
would mess up minidumps as well.

Both minidumps and regular dumps are supported on the same machine.
2006-04-21 04:24:50 +00:00
bin Whitespace nits. 2006-04-17 17:55:11 +00:00
contrib Re-add option -C to usage(). 2006-04-19 12:19:06 +00:00
crypto Fix utmp. There is some clever logic in configure.ac which attempts to 2006-03-23 21:31:42 +00:00
etc After some discussion we believe that having SERVERS to REQUIRE: 2006-04-20 12:30:12 +00:00
games Remove a corrupted fortune ending in line noise. Even googling did not 2006-04-17 12:14:46 +00:00
gnu Clean the product of patch(1). 2006-04-10 09:00:19 +00:00
include - make reentrant version of netdb functions glibc style API, and 2006-04-15 16:20:27 +00:00
kerberos5 Reimplementation of world/kernel build options. For details, see: 2006-03-17 18:54:44 +00:00
lib Document how the backoff delay is calculated. 2006-04-19 17:46:27 +00:00
libexec *thwack*! all the world's not i386. 2006-03-29 12:29:01 +00:00
release Some grammar/language improvements, more to come. Also note some 2006-04-18 19:35:48 +00:00
rescue Pass -DCRUNCH down to standard targets in individual makefiles. 2006-04-10 09:32:50 +00:00
sbin Add a missing .Pp call. 2006-04-19 19:21:42 +00:00
secure Clean generated headers. 2006-04-10 08:47:18 +00:00
share Spelling/grammar fixes. 2006-04-21 01:33:04 +00:00
sys Introduce minidumps. Full physical memory crash dumps are still available 2006-04-21 04:24:50 +00:00
tools Fix an obvious bug. 2006-04-18 12:37:44 +00:00
usr.bin Indentation fixes 2006-04-19 19:09:21 +00:00
usr.sbin add debug msg 2006-04-20 05:03:21 +00:00
COPYRIGHT Happy new year, a little late 2006-01-15 22:06:10 +00:00
LOCKS Document commit constraints for RELENG_6_*. 2006-01-13 06:51:43 +00:00
MAINTAINERS Saying that asr(4) has a maintainer is like saying that a politician has 2006-04-01 21:19:15 +00:00
Makefile Add the new "showconfig" target that displays build configuration. 2006-03-18 14:30:23 +00:00
Makefile.inc1 Sort bootstrap-tools entries. 2006-03-31 14:10:35 +00:00
ObsoleteFiles.inc Record the /lib/libgpib.so.1 move to /usr/lib. 2006-04-13 13:19:10 +00:00
README Add a note explaining what the rescue/ directory is for. 2006-03-01 20:14:55 +00:00
UPDATING Fix the "make distribution" example; it should be run from src/. 2006-04-07 11:36:25 +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.

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