xref: /src/README.md (revision 7c0631790c64b818abe97b5f0f63c8a8fa0c8b94)
126e87919SWarner LoshFreeBSD Source:
226e87919SWarner Losh---------------
326e87919SWarner LoshThis is the top level of the FreeBSD source directory.  This file
426e87919SWarner Loshwas last revised on:
526e87919SWarner Losh$FreeBSD$
626e87919SWarner Losh
7*7c063179SEitan AdlerFreeBSD is an operating system used to power modern servers,
8*7c063179SEitan Adlerdesktops, and embedded platforms. A large community has
9*7c063179SEitan Adlercontinually developed it for more than thirty years. Its
10*7c063179SEitan Adleradvanced networking, security, and storage features have
11*7c063179SEitan Adlermade FreeBSD the platform of choice for many of the
12*7c063179SEitan Adlerbusiest web sites and most pervasive embedded networking
13*7c063179SEitan Adlerand storage devices.
14*7c063179SEitan Adler
1526e87919SWarner LoshFor copyright information, please see the file COPYRIGHT in this
16*7c063179SEitan Adlerdirectory. Additional copyright information also exists for some
1726e87919SWarner Loshsources in this tree - please see the specific source directories for
18*7c063179SEitan Adlermore information.
1926e87919SWarner Losh
2026e87919SWarner LoshThe Makefile in this directory supports a number of targets for
21*7c063179SEitan Adlerbuilding components (or all) of the FreeBSD source tree.  See build(7), config(8),
22*7c063179SEitan Adlerhttps://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html, and
23*7c063179SEitan Adlerhttps://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html
2426e87919SWarner Loshfor more information, including setting make(1) variables.
2526e87919SWarner Losh
2626e87919SWarner LoshSource Roadmap:
2726e87919SWarner Losh---------------
2826e87919SWarner Losh```
2926e87919SWarner Loshbin		System/user commands.
3026e87919SWarner Losh
3126e87919SWarner Loshcddl		Various commands and libraries under the Common Development
3226e87919SWarner Losh		and Distribution License.
3326e87919SWarner Losh
3426e87919SWarner Loshcontrib		Packages contributed by 3rd parties.
3526e87919SWarner Losh
3626e87919SWarner Loshcrypto		Cryptography stuff (see crypto/README).
3726e87919SWarner Losh
3826e87919SWarner Loshetc		Template files for /etc.
3926e87919SWarner Losh
4026e87919SWarner Loshgnu		Various commands and libraries under the GNU Public License.
4126e87919SWarner Losh		Please see gnu/COPYING* for more information.
4226e87919SWarner Losh
4326e87919SWarner Loshinclude		System include files.
4426e87919SWarner Losh
4526e87919SWarner Loshkerberos5	Kerberos5 (Heimdal) package.
4626e87919SWarner Losh
4726e87919SWarner Loshlib		System libraries.
4826e87919SWarner Losh
4926e87919SWarner Loshlibexec		System daemons.
5026e87919SWarner Losh
5126e87919SWarner Loshrelease		Release building Makefile & associated tools.
5226e87919SWarner Losh
5326e87919SWarner Loshrescue		Build system for statically linked /rescue utilities.
5426e87919SWarner Losh
5526e87919SWarner Loshsbin		System commands.
5626e87919SWarner Losh
5726e87919SWarner Loshsecure		Cryptographic libraries and commands.
5826e87919SWarner Losh
5926e87919SWarner Loshshare		Shared resources.
6026e87919SWarner Losh
618960a019SMark Johnstonstand		Boot loader sources.
628960a019SMark Johnston
6326e87919SWarner Loshsys		Kernel sources.
6426e87919SWarner Losh
65*7c063179SEitan Adlersys/<arch>/conf Kernel configuration file
66*7c063179SEitan Adler
6726e87919SWarner Loshtests		Regression tests which can be run by Kyua.  See tests/README
6826e87919SWarner Losh		for additional information.
6926e87919SWarner Losh
7026e87919SWarner Loshtools		Utilities for regression testing and miscellaneous tasks.
7126e87919SWarner Losh
7226e87919SWarner Loshusr.bin		User commands.
7326e87919SWarner Losh
7426e87919SWarner Loshusr.sbin	System administration commands.
7526e87919SWarner Losh```
7626e87919SWarner Losh
7726e87919SWarner LoshFor information on synchronizing your source tree with one or more of
7826e87919SWarner Loshthe FreeBSD Project's development branches, please see:
7926e87919SWarner Losh
80745ddc10SEitan Adler  https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/current-stable.html
81