xref: /netbsd/README.md (revision a4c8afe1)
1NetBSD
2======
3
4NetBSD is a free, fast, secure, and highly portable Unix-like Open
5Source operating system.  It is available for a [wide range of
6platforms](https://wiki.NetBSD.org/ports/), from large-scale servers
7and powerful desktop systems to handheld and embedded devices.
8
9Building
10--------
11
12You can cross-build NetBSD from most UNIX-like operating systems.
13To build for amd64 (x86_64), in the src directory:
14
15    ./build.sh -U -u -j4 -m amd64 -O ~/obj release
16
17Additional build information available in the [BUILDING](BUILDING) file.
18
19Binaries
20--------
21
22- [Daily builds](https://nycdn.NetBSD.org/pub/NetBSD-daily/HEAD/latest/)
23- [Releases](https://cdn.NetBSD.org/pub/NetBSD/)
24
25Testing
26-------
27
28On a running NetBSD system:
29
30    cd /usr/tests; atf-run | atf-report
31
32Troubleshooting
33---------------
34
35- Send bugs and patches [via web form](https://www.NetBSD.org/cgi-bin/sendpr.cgi?gndb=netbsd).
36- Subscribe to the [mailing lists](https://www.NetBSD.org/mailinglists/).
37  The [netbsd-users](https://www.NetBSD.org/mailinglists/#netbsd-users) list is a good choice for many problems; watch [current-users](https://www.NetBSD.org/mailinglists/#current-users) if you follow the bleeding edge of NetBSD-current.
38- Join the community IRC channel [#netbsd @ libera.chat](https://web.libera.chat/#netbsd).
39
40Latest sources
41--------------
42
43To fetch the main CVS repository:
44
45    cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P src
46
47To work in the Git mirror, which is updated every few hours from CVS:
48
49    git clone https://github.com/NetBSD/src.git
50
51Additional Links
52----------------
53
54- [The NetBSD Guide](https://www.NetBSD.org/docs/guide/en/)
55- [NetBSD manual pages](https://man.NetBSD.org/)
56- [NetBSD Cross-Reference](https://nxr.NetBSD.org/)
57