Commit | Line | Data |
---|---|---|
984263bc MD |
1 | This is the top level of the FreeBSD source directory. This file |
2 | was last revised on: | |
3 | $FreeBSD: src/README,v 1.15.2.4 2002/04/26 16:01:35 bmah Exp $ | |
62bacdcd | 4 | $DragonFly: src/README,v 1.4 2003/08/14 18:27:49 asmodai Exp $ |
984263bc MD |
5 | |
6 | For copyright information, please see the file COPYRIGHT in this | |
7 | directory (additional copyright information also exists for some | |
8 | sources in this tree - please see the specific source directories for | |
9 | more information). | |
10 | ||
11 | The Makefile in this directory supports a number of targets for | |
12 | building components (or all) of the FreeBSD source tree, the most | |
13 | commonly used one being ``world'', which rebuilds and installs | |
14 | everything in the FreeBSD system from the source tree except the | |
15 | kernel, the kernel-modules and the contents of /etc. The | |
16 | ``buildkernel'' and ``installkernel'' targets build and install | |
17 | the kernel and the modules (see below). Please see the top of | |
18 | the Makefile in this directory for more information on the | |
19 | standard build targets and compile-time flags. | |
20 | ||
21 | Building a kernel is a somewhat more involved process, documentation | |
22 | for which can be found at: | |
23 | http://www.FreeBSD.org/handbook/kernelconfig.html | |
24 | And in the config(8) man page. | |
25 | Note: If you want to build and install the kernel with the | |
26 | ``buildkernel'' and ``installkernel'' targets, you might need to build | |
27 | world before. More information is available in the handbook. | |
28 | ||
29 | The sample kernel configuration files reside in the sys/<arch>/conf | |
30 | sub-directory (assuming that you've installed the kernel sources), the | |
31 | file named GENERIC being the one used to build your initial installation | |
32 | kernel. The file LINT contains entries for all possible devices, not | |
33 | just those commonly used, and is meant more as a general reference | |
34 | than an actual kernel configuration file (a kernel built from it | |
35 | wouldn't even run). | |
36 | ||
37 | ||
38 | Source Roadmap: | |
39 | --------------- | |
40 | bin System/user commands. | |
41 | ||
42 | contrib Packages contributed by 3rd parties. | |
43 | ||
44 | crypto Cryptography stuff (see crypto/README). | |
45 | ||
46 | etc Template files for /etc. | |
47 | ||
48 | games Amusements. | |
49 | ||
50 | gnu Various commands and libraries under the GNU Public License. | |
51 | Please see gnu/COPYING* for more information. | |
52 | ||
53 | include System include files. | |
54 | ||
55 | kerberos5 Kerberos5 (Heimdal) package. | |
56 | ||
984263bc MD |
57 | lib System libraries. |
58 | ||
59 | libexec System daemons. | |
60 | ||
61 | release Release building Makefile & associated tools. | |
62 | ||
63 | sbin System commands. | |
64 | ||
65 | secure Cryptographic libraries and commands. | |
66 | ||
67 | share Shared resources. | |
68 | ||
69 | sys Kernel sources. | |
70 | ||
71 | tools Utilities for regression testing and miscellaneous tasks. | |
72 | ||
73 | usr.bin User commands. | |
74 | ||
75 | usr.sbin System administration commands. |