README revision 64047
121173SjkhThis is the top level of the FreeBSD source directory. This file 250479Speterwas last revised on: 350479Speter$FreeBSD: head/README 64047 2000-07-31 09:22:50Z alex $ 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 1664047Salexthe kernel and the modules. Please see the top of the Makefile 1728014Sjkhin this directory for more information on the standard build targets 1828014Sjkhand compile-time flags. 1921173Sjkh 2021369SmaxBuilding a kernel with config(8) is a somewhat more involved process, 2121173Sjkhdocumentation for which can be found at: 2221173Sjkh http://www.freebsd.org/handbook/kernelconfig.html 2321369SmaxAnd in the config(8) man page. 2421173Sjkh 2521173SjkhThe sample kernel configuration files reside in the sys/i386/conf 2621173Sjkhsub-directory (assuming that you've installed the kernel sources), the 2721173Sjkhfile named GENERIC being the one used to build your initial installation 2864047Salexkernel. The file NOTES contains entries and documentation for all possible 2964047Salexdevices, not just those commonly used. It is the successor of the ancient 3064047SalexLINT file, but in contrast to LINT, it is not buildable as a kernel but a 3164047Salexpure reference and documentation file. 3221173Sjkh 3321173Sjkh 3421173SjkhSource Roadmap: 3521173Sjkh--------------- 3621173Sjkhbin System/User commands. 3721173Sjkh 3821173Sjkhcontrib Packages contributed by 3rd parties. 3921173Sjkh 4064047Salexcrypto Cryptography stuff (see crypto/README). 4121173Sjkh 4221173Sjkhetc Template files for /etc 4321173Sjkh 4421173Sjkhgames Amusements. 4521173Sjkh 4621173Sjkhgnu Various commands and libraries under the GNU Public License. 4721173Sjkh Please see gnu/COPYING* for more information. 4821173Sjkh 4921173Sjkhinclude System include files. 5021173Sjkh 5139122SmarkmkerberosIV Kerberos package. 5237283Sjkh 5321173Sjkhlib System libraries. 5421173Sjkh 5521173Sjkhlibexec System daemons. 5621173Sjkh 5721173Sjkhrelease Release building Makefile & associated tools. 5821173Sjkh 5921173Sjkhsbin System commands. 6021173Sjkh 6121173Sjkhsecure DES and DES-related utilities - NOT FOR EXPORT! 6221173Sjkh 6321173Sjkhshare Shared resources. 6421173Sjkh 6521173Sjkhsys Kernel sources. 6621173Sjkh 6721173Sjkhtools Utilities for regression testing and miscellaneous tasks. 6821173Sjkh 6921173Sjkhusr.bin User commands. 7021173Sjkh 7121173Sjkhusr.sbin System administration commands. 7221173Sjkh 7321173Sjkh 7421173SjkhFor information on synchronizing your source tree with one or more of 7521173Sjkhthe FreeBSD Project's development branches, please see: 7621173Sjkh 7721173Sjkh http://www.freebsd.org/handbook/synching.html 78