1This is the top level of the FreeBSD source directory.  This file
2was last revised on:
3$FreeBSD$
4
5FreeBSD is an operating system used to power modern servers,
6desktops, and embedded platforms. A large community has
7continually developed it for more than thirty years. Its
8advanced networking, security, and storage features have
9made FreeBSD the platform of choice for many of the
10busiest web sites and most pervasive embedded networking
11and storage devices.
12
13For copyright information, please see the file COPYRIGHT in this
14directory. Additional copyright information also exists for some
15sources in this tree - please see the specific source directories for
16more information.
17
18The Makefile in this directory supports a number of targets for
19building components (or all) of the FreeBSD source tree.  See build(7), config(8),
20https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html, and
21https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html
22for more information, including setting make(1) variables.
23
24Source Roadmap:
25---------------
26
27bin		System/user commands.
28
29cddl		Various commands and libraries under the Common Development
30		and Distribution License.
31
32contrib		Packages contributed by 3rd parties.
33
34crypto		Cryptography stuff (see crypto/README).
35
36etc		Template files for /etc.
37
38gnu		Various commands and libraries under the GNU Public License.
39		Please see gnu/COPYING* for more information.
40
41include		System include files.
42
43kerberos5	Kerberos5 (Heimdal) package.
44
45lib		System libraries.
46
47libexec		System daemons.
48
49release		Release building Makefile & associated tools.
50
51rescue		Build system for statically linked /rescue utilities.
52
53sbin		System commands.
54
55secure		Cryptographic libraries and commands.
56
57share		Shared resources.
58
59stand		Boot loader sources.
60
61sys		Kernel sources.
62
63sys/<arch>/conf Kernel configuration files. GENERIC is the configuration
64		used in release builds. NOTES contains documentation of
65		all possible entries.
66
67tests		Regression tests which can be run by Kyua.  See tests/README
68		for additional information.
69
70tools		Utilities for regression testing and miscellaneous tasks.
71
72usr.bin		User commands.
73
74usr.sbin	System administration commands.
75
76
77For information on synchronizing your source tree with one or more of
78the FreeBSD Project's development branches, please see:
79
80  https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/current-stable.html
81