README revision 159363
155211SmsmithThis is the top level of the FreeBSD source directory. This file 255211Smsmithwas last revised on: 355211Smsmith$FreeBSD: head/README 159363 2006-06-07 03:33:48Z trhodes $ 455211Smsmith 555211SmsmithFor copyright information, please see the file COPYRIGHT in this 655211Smsmithdirectory (additional copyright information also exists for some 755211Smsmithsources in this tree - please see the specific source directories for 855211Smsmithmore information). 955211Smsmith 1055211SmsmithThe Makefile in this directory supports a number of targets for 1155211Smsmithbuilding components (or all) of the FreeBSD source tree, the most 1255211Smsmithcommonly used one being ``world'', which rebuilds and installs 1355211Smsmitheverything in the FreeBSD system from the source tree except the 1455211Smsmithkernel, the kernel-modules and the contents of /etc. The ``world'' 1555211Smsmithtarget should only be used in cases where the source tree has not 1655211Smsmithchanged from the currently running version. See: 1755211Smsmithhttp://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html 1855211Smsmithfor more information, including setting make(1) variables. 1955211Smsmith 2055211SmsmithThe ``buildkernel'' and ``installkernel'' targets build and install 2155211Smsmiththe kernel and the modules (see below). Please see the top of 2255211Smsmiththe Makefile in this directory for more information on the 2355211Smsmithstandard build targets and compile-time flags. 2455211Smsmith 2539441SmsmithBuilding a kernel is a somewhat more involved process, documentation 2639441Smsmithfor which can be found at: 27119482Sobrien http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html 28119482SobrienAnd in the config(8) man page. 29119482SobrienNote: If you want to build and install the kernel with the 3039441Smsmith``buildkernel'' and ``installkernel'' targets, you might need to build 3139441Smsmithworld before. More information is available in the handbook. 3239441Smsmith 3339441SmsmithThe sample kernel configuration files reside in the sys/<arch>/conf 34173118Sjhbsub-directory (assuming that you've installed the kernel sources), the 3564187Sjhbfile named GENERIC being the one used to build your initial installation 3639441Smsmithkernel. The file NOTES contains entries and documentation for all possible 3739441Smsmithdevices, not just those commonly used. It is the successor of the ancient 38153589SsobomaxLINT file, but in contrast to LINT, it is not buildable as a kernel but a 3955211Smsmithpure reference and documentation file. 4039441Smsmith 41173118Sjhb 4239441SmsmithSource Roadmap: 4355211Smsmith--------------- 4455211Smsmithbin System/user commands. 4539441Smsmith 4639441Smsmithcontrib Packages contributed by 3rd parties. 4755211Smsmith 4855211Smsmithcrypto Cryptography stuff (see crypto/README). 4955211Smsmith 5055211Smsmithetc Template files for /etc. 5155211Smsmith 5255211Smsmithgames Amusements. 53173118Sjhb 54173118Sjhbgnu Various commands and libraries under the GNU Public License. 5555211Smsmith Please see gnu/COPYING* for more information. 5655211Smsmith 5755211Smsmithinclude System include files. 58173118Sjhb 5955211Smsmithkerberos5 Kerberos5 (Heimdal) package. 6055211Smsmith 61173118Sjhblib System libraries. 62173118Sjhb 6355211Smsmithlibexec System daemons. 6455211Smsmith 65173118Sjhbrelease Release building Makefile & associated tools. 6655211Smsmith 6755211Smsmithrescue Build system for statically linked /rescue utilities. 6855211Smsmith 6939441Smsmithsbin System commands. 7055211Smsmith 7155211Smsmithsecure Cryptographic libraries and commands. 7255211Smsmith 7355211Smsmithshare Shared resources. 7455211Smsmith 7555211Smsmithsys Kernel sources. 7655211Smsmith 7755211Smsmithtools Utilities for regression testing and miscellaneous tasks. 7855211Smsmith 7955211Smsmithusr.bin User commands. 8055211Smsmith 8155211Smsmithusr.sbin System administration commands. 8255211Smsmith 8355211Smsmith 8455211SmsmithFor information on synchronizing your source tree with one or more of 8555211Smsmiththe FreeBSD Project's development branches, please see: 8655211Smsmith 8755211Smsmith http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/synching.html 8855211Smsmith