README revision 93217
121173SjkhThis is the top level of the FreeBSD source directory. This file 250479Speterwas last revised on: 350479Speter$FreeBSD: head/README 93217 2002-03-26 12:35:49Z ru $ 421173Sjkh 521173SjkhFor copyright information, please see the file COPYRIGHT in this 621173Sjkhdirectory (additional copyright information also exists for some 721173Sjkhsources in this tree - please see the specific source directories for 821173Sjkhmore information). 921173Sjkh 1021173SjkhThe Makefile in this directory supports a number of targets for 1121173Sjkhbuilding components (or all) of the FreeBSD source tree, the most 1221173Sjkhcommonly used one being ``world'', which rebuilds and installs 1321173Sjkheverything in the FreeBSD system from the source tree except the 1464047Salexkernel, the kernel-modules and the contents of /etc. The 1564047Salex``buildkernel'' and ``installkernel'' targets build and install 1664057Salexthe kernel and the modules (see below). Please see the top of 1764057Salexthe Makefile in this directory for more information on the 1864057Salexstandard build targets and compile-time flags. 1921173Sjkh 2064057SalexBuilding a kernel is a somewhat more involved process, documentation 2164057Salexfor which can be found at: 2293217Sru http://www.FreeBSD.org/handbook/kernelconfig.html 2321369SmaxAnd in the config(8) man page. 2464057SalexNote: If you want to build and install the kernel with the 2593217Sru``buildkernel'' and ``installkernel'' targets, you might need to build 2664057Salexworld before. More information is available in the handbook. 2721173Sjkh 2893217SruThe sample kernel configuration files reside in the sys/<arch>/conf 2921173Sjkhsub-directory (assuming that you've installed the kernel sources), the 3021173Sjkhfile named GENERIC being the one used to build your initial installation 3164047Salexkernel. The file NOTES contains entries and documentation for all possible 3264047Salexdevices, not just those commonly used. It is the successor of the ancient 3364047SalexLINT file, but in contrast to LINT, it is not buildable as a kernel but a 3464047Salexpure reference and documentation file. 3521173Sjkh 3621173Sjkh 3721173SjkhSource Roadmap: 3821173Sjkh--------------- 3993217Srubin System/user commands. 4021173Sjkh 4121173Sjkhcontrib Packages contributed by 3rd parties. 4221173Sjkh 4364047Salexcrypto Cryptography stuff (see crypto/README). 4421173Sjkh 4593217Sruetc Template files for /etc. 4621173Sjkh 4721173Sjkhgames Amusements. 4821173Sjkh 4921173Sjkhgnu Various commands and libraries under the GNU Public License. 5021173Sjkh Please see gnu/COPYING* for more information. 5121173Sjkh 5221173Sjkhinclude System include files. 5321173Sjkh 5493217Srukerberos5 Kerberos5 (Heimdal) package. 5537283Sjkh 5693217SrukerberosIV KerberosIV (eBones) package. 5793217Sru 5821173Sjkhlib System libraries. 5921173Sjkh 6021173Sjkhlibexec System daemons. 6121173Sjkh 6221173Sjkhrelease Release building Makefile & associated tools. 6321173Sjkh 6421173Sjkhsbin System commands. 6521173Sjkh 6665298Smarkmsecure Cryptographic libraries and commands. 6721173Sjkh 6821173Sjkhshare Shared resources. 6921173Sjkh 7021173Sjkhsys Kernel sources. 7121173Sjkh 7221173Sjkhtools Utilities for regression testing and miscellaneous tasks. 7321173Sjkh 7421173Sjkhusr.bin User commands. 7521173Sjkh 7621173Sjkhusr.sbin System administration commands. 7721173Sjkh 7821173Sjkh 7921173SjkhFor information on synchronizing your source tree with one or more of 8021173Sjkhthe FreeBSD Project's development branches, please see: 8121173Sjkh 8293217Sru http://www.FreeBSD.org/handbook/synching.html 83