xref: /third_party/FreeBSD/README.md (revision f9f848fa)
1f9f848faSopenharmony_ciFreeBSD Source:
2f9f848faSopenharmony_ci---------------
3f9f848faSopenharmony_ciThis is the top level of the FreeBSD source directory.
4f9f848faSopenharmony_ci
5f9f848faSopenharmony_ciFreeBSD is an operating system used to power modern servers, desktops, and embedded platforms.
6f9f848faSopenharmony_ciA large community has continually developed it for more than thirty years.
7f9f848faSopenharmony_ciIts advanced networking, security, and storage features have made FreeBSD the platform of choice for many of the busiest web sites and most pervasive embedded networking and storage devices.
8f9f848faSopenharmony_ci
9f9f848faSopenharmony_ciFor copyright information, please see [the file COPYRIGHT](COPYRIGHT) in this directory.
10f9f848faSopenharmony_ciAdditional copyright information also exists for some sources in this tree - please see the specific source directories for more information.
11f9f848faSopenharmony_ci
12f9f848faSopenharmony_ciThe Makefile in this directory supports a number of targets for building components (or all) of the FreeBSD source tree.
13f9f848faSopenharmony_ciSee build(7), config(8), [FreeBSD handbook on building userland](https://docs.freebsd.org/en/books/handbook/cutting-edge/#makeworld), and [Handbook for kernels](https://docs.freebsd.org/en/books/handbook/kernelconfig/) for more information, including setting make(1) variables.
14f9f848faSopenharmony_ci
15f9f848faSopenharmony_ciFor information on the CPU architectures and platforms supported by FreeBSD, see the [FreeBSD
16f9f848faSopenharmony_ciwebsite's Platforms page](https://www.freebsd.org/platforms/).
17f9f848faSopenharmony_ci
18f9f848faSopenharmony_ciSource Roadmap:
19f9f848faSopenharmony_ci---------------
20f9f848faSopenharmony_ci| Directory | Description |
21f9f848faSopenharmony_ci| --------- | ----------- |
22f9f848faSopenharmony_ci| bin | System/user commands. |
23f9f848faSopenharmony_ci| cddl | Various commands and libraries under the Common Development and Distribution License. |
24f9f848faSopenharmony_ci| contrib | Packages contributed by 3rd parties. |
25f9f848faSopenharmony_ci| crypto | Cryptography stuff (see [crypto/README](crypto/README)). |
26f9f848faSopenharmony_ci| etc | Template files for /etc. |
27f9f848faSopenharmony_ci| gnu | Commands and libraries under the GNU General Public License (GPL) or Lesser General Public License (LGPL).  Please see gnu/COPYING* for more information. |
28f9f848faSopenharmony_ci| include | System include files. |
29f9f848faSopenharmony_ci| kerberos5 | Kerberos5 (Heimdal) package. |
30f9f848faSopenharmony_ci| lib | System libraries. |
31f9f848faSopenharmony_ci| libexec | System daemons. |
32f9f848faSopenharmony_ci| release | Release building Makefile & associated tools. |
33f9f848faSopenharmony_ci| rescue | Build system for statically linked /rescue utilities. |
34f9f848faSopenharmony_ci| sbin | System commands. |
35f9f848faSopenharmony_ci| secure | Cryptographic libraries and commands. |
36f9f848faSopenharmony_ci| share | Shared resources. |
37f9f848faSopenharmony_ci| stand | Boot loader sources. |
38f9f848faSopenharmony_ci| sys | Kernel sources (see [sys/README.md](sys/README.md)). |
39f9f848faSopenharmony_ci| targets | Support for experimental `DIRDEPS_BUILD` |
40f9f848faSopenharmony_ci| tests | Regression tests which can be run by Kyua.  See [tests/README](tests/README) for additional information. |
41f9f848faSopenharmony_ci| tools | Utilities for regression testing and miscellaneous tasks. |
42f9f848faSopenharmony_ci| usr.bin | User commands. |
43f9f848faSopenharmony_ci| usr.sbin | System administration commands. |
44f9f848faSopenharmony_ci
45f9f848faSopenharmony_ciFor information on synchronizing your source tree with one or more of the FreeBSD Project's development branches, please see [FreeBSD Handbook](https://docs.freebsd.org/en/books/handbook/cutting-edge/#current-stable).
46