Annotation of www/index.html, Revision 1.6
1.1 deraadt 1: <http>
2: <head>
3: <title>OpenBSD</title>
4: </head>
5: <h2>OpenBSD</h2>
6:
7: <hr>
8: The OpenBSD project involves continuing development of a multiplatform
9: 4.4BSD-based Unix-like operating system.
10:
11: <p>
12: OpenBSD looks a lot like NetBSD (which it is derived from, following
13: the 4.4BSD roots), but is now being developed seperately. Good changes
14: from other free operating systems will be merged in (of course, depending
15: on various factors like developer time for example.)
16:
17: <p>
18: <ul>
19: <li><a href=#curplat>Supported platforms</a>
20: <li><a href=#futplat>New platforms under development</a>
21: <li><a href=#snapshots>Binary snapshots</a>
22: <li><a href=#devel>How we help developers and users</a>
23: </ul>
24:
25: <a name=curplat>
26: <h3><hr>Platforms currently supported.</h3>
27:
28: Note: for some of these platforms, the platform-independent code may
29: be identical to that found in NetBSD because there isn't a specific
30: OpenBSD developer. For other ports the differences are significant.
31: If you find an empty page that means nothing of consequence that is
32: directly port-specific has changed from NetBSD. (Of course there are
33: differences, but they just aren't in the /sys/arch/XXXX directory).
34:
35: <dl>
36: <dt><a href=alpha.html>alpha</a> <dd> DEC Alpha-based machines.
37: <dt><a href=amiga.html>amiga</a> <dd> Commodore Amiga.
38: <dt><a href=atari.html>atari</a> <dd> Atari TT and Falcon models.
39: <dt><a href=hp300.html>hp300</a> <dd> Hewlett-Packard HP300/HP400 machines.
40: <dt><a href=i386.html>i386</a> <dd> Your standard run-of-the-mill PC.
41: <dt><a href=mac68k.html>mac68k</a> <dd> Most MC680x0-based Apple Macintosh models.
42: <dt><a href=mvme68k.html>mvme68k</a> <dd> Motorola MVME147/16x/17x MC680[346]0-based VME cards.
43: <dt><a href=pc532.html>pc532</a> <dd> A rare NS32532-based computer.
44: <dt><a href=pmax.html>pmax</a> <dd> DEC MIPS-based machines.
45: <dt><a href=sparc.html>sparc</a> <dd> Sun's Sun4 and sun4c models (sun4m soon!).
46: <dt><a href=sun3.html>sun3</a> <dd> Sun's sun3 models.
47: <dt><a href=vax.html>vax</a> <dd> DEC's VAX computers.
48: </dl>
49:
50: <a name=futplat>
51: <h3><hr>New platforms under development.</h3>
52: <dl>
53: <dt><a href=arm32.html>arm32</a> <dd> Acorn ARM6+ computers.
54: <dt><a href=mvme88k.html>mvme88k</a> <dd> Motorola MVME18x/19x MC88xxx-based VME cards
55: <dt><a href=pica.html>pica</a> <dd> Acer PICA R4400
56: </dl>
57:
58: <p>
59: <h3>Platforms not being developed, but which should be</h3>
60: Either there is enough free code available to make porting to these
61: machines relatively easy, or it's a port which should be done.
62: <dl>
63: <dt><a href=hppa.html>hppa</a> <dd> Hewlett-Packard PA-RISC HP700/HP800 models.
64: <dt><a href=iris.html>iris</a> <dd> SGI Iris machines.
65: <dt><a href=ppc.html>ppc</a> <dd> various IBM, Apple, and Motorola PowerPC-based machines.
66: </dl>
67:
68: <a name=snapshots>
69: <h3><hr>Binary Snapshots.</h3>
70: Snapshots will be made available from time to time in the following
71: directories:<p>
72: <ul>
73: <li><a href=ftp://ftp.openbsd.org/pub/OpenBSD/snapshots>
74: ftp://ftp.openbsd.org/pub/OpenBSD/snapshots</a><br>
75: located at Rutgers University, eastern USA.
76: <!-- davem@openbsd.org -->
77: <li><a href=ftp://ftp.ibp.fr/pub/OpenBSD/snapshots>
78: ftp://ftp.ibp.fr/pub/OpenBSD/snapshots/</a><br>
79: located in France.
80: <!-- ftpmaint@ftp.ibp.fr -->
81: <li><a href=ftp://hal.cs.umr.edu/pub/OpenBSD/snapshots>
82: ftp://hal.cs.umr.edu/pub/OpenBSD/snapshots/</a><br>
83: located in University of Missouri-Rolla, mid-western USA.
84: <!-- johns@cs.umr.edu -->
85: </ul>
86: You should also read the <a href=snapshots.html>
87: general description about OpenBSD snapshots</a>.
88:
89: <p>
90: The page for each platform (listed above) provides a link to the
91: specific snapshot ftp area, as well as other information you might
92: find neccessary or handy.
93:
94: <a name=devel>
95: <h3><hr>How we help developers and users.</h3>
96: We are moving quickly to setup `infrastructure'... as things get working
97: this section will be updated.
98:
99: <dl>
100: <dt><h4>Mailing Lists:</h4>
101: <dd>Some mailing lists are used for the development and use of OpenBSD.
102: In each case, send mail to
103: <a href=mailto:majordomo@OpenBSD.org>majordomo@OpenBSD.org</a>
104: with a message body of "<strong>subscribe mailing-list-name</strong>".
105: <p>
106: These are the mailing lists:
107: <dl>
108: <dt><strong>announce</strong>
109: <dd>important announcements. Since this is a low volume list
110: it is excellent for people who just want to follow important events.
111: <dt><strong>tech</strong>
112: <dd>technical discussions
113: <dt><strong>misc</strong>
114: <dd>user questions and answers
115: <dt><strong>source-changes</strong>
116: <dd>automated mailout of CVS source tree changes
117: </ul>
118: <p>
119: For further assistance, send a message body of "<strong>help</strong>",
120: and you will receive a reply outlining all your options.
121:
122: <dt><h4>FTP:</h4>
123: <dd>This is a list of currently known ftp servers:<p>
124: <ul>
125: <li><a href=ftp://ftp.openbsd.org/pub/OpenBSD>
126: ftp://ftp.openbsd.org/pub/OpenBSD</a><br>
127: located at Rutgers University, eastern USA.
128: <!-- davem@openbsd.org -->
129: <li><a href=ftp://ftp.ibp.fr/pub/OpenBSD>
130: ftp://ftp.ibp.fr/pub/OpenBSD</a><br>
131: located in France.
132: <!-- ftpmaint@ftp.ibp.fr -->
133: <li><a href=ftp://hal.cs.umr.edu/pub/OpenBSD>
134: ftp://hal.cs.umr.edu/pub/OpenBSD</a><br>
135: located in University of Missouri-Rolla, mid-western USA.
136: <!-- johns@cs.umr.edu -->
137: </ul>
138: <p>
139:
140: The file structure of the FTP servers is as follows:
141: <p>
142: <strong><dl>
143: <dt>pub/OpenBSD/snapshots/
144: <dt>pub/OpenBSD/src/
145: </dl>
146: </strong>
147: <p>
148:
149: If you add a new FTP mirror site, please contact
150: <a href=mailto:deraadt@theos.com> the FTP maintainer</a>.
151:
152: <dt><h4>SUP:</h4>
153: <dd>Sorry, SUP is not ready for use yet.
154:
155: <dt><h4>CVS Access:</h4>
156: <dd>CVS is used to manage the OpenBSD source tree. This allows developers
1.6 ! david 157: to edit source files on their local machines, and automatically track and
! 158: merge in any changes made in the OpenBSD CVS repository. It is also easy
! 159: for <strong>anyone</strong> to see the logs of, check out, or "diff" the
! 160: source files in the OpenBSD source tree.
1.1 deraadt 161: <p>
162:
163: CVS is available at <a href=ftp://prep.ai.mit.edu/pub/gnu/cvs-1.6.tar.gz>
164: ftp://prep.ai.mit.edu/pub/gnu/cvs-1.6.tar.gz</a>. Versions earlier
165: than 1.6 are not recommended, and may not work.<p>
166:
167: There are two levels of source tree access:<p>
168:
169: <dl>
170: <dt><strong>Read-write access for developers</strong>
171: <dd>Developers who need to commit changes to the source tree must have
172: an account on the OpenBSD machines. Getting this access will be a
173: natural result of working on the sources with other OpenBSD developers.
174: <p>
175: The OpenBSD cvs server is in Calgary, Alberta, Canada.
176: <p>
177: <dt><strong>Read-only access for everyone</strong>
1.5 deraadt 178: <dd>Anyone can access the read-only CVS repositories. These copies
179: of the read-write CVS repository are mirrored often. To use one,
180: set your <strong>CVSROOT</strong> environment variable to one of
181: the following values:
1.1 deraadt 182: <p>
183: <ul>
184: <li><strong>CVSROOT=anoncvs@anoncvs.openbsd.org:/cvs</strong><br>
1.4 deraadt 185: located at Washington University, St. Louis, mid-west USA.<br>
1.5 deraadt 186: protocols: rsh, ssh, ssh port 2022.<br>
187: updated every 4 hours.
1.4 deraadt 188: <li><strong>CVSROOT=anoncvs@hal.cs.umr.edu:/cvs</strong><br>
189: located at University of Missouri-Rolla, Rolla, MO, mid-west USA.<br>
1.5 deraadt 190: protocols: ssh, ssh port 2022.<br>
191: unknown update frequency.
1.1 deraadt 192: </ul>
193: </dl>
194: <p>
195: <strong>IMPORTANT NOTE:</strong>
196: There are a few issues relating to cryptographic software that everyone
197: should be aware of:
198: <ul>
199: <li>The OpenBSD sources are from Canada. It is legal to export crypto
200: software from Canada to the world.
201: <li>However, if you are outside the USA or Canada, you should not
1.5 deraadt 202: fetch the cryptographic sections of the OpenBSD sources from an
203: anoncvs server located in the USA. The files in question are...
1.1 deraadt 204: <ul>
205: <li>src/kerberosIV/*
206: <li>src/lib/libc/crypt/crypt.c
207: <li>src/lib/libc/crypt/morecrypt.c
208: </ul>
209: Because of the USA ITAR munitions list,
210: crypto software may only be exported to Canada from the USA.
1.5 deraadt 211: <li><strong>At the moment all the anoncvs servers are in the USA.
212: OpenBSD is looking for people willing to run an anoncvs server
213: in Europe!</strong>
1.1 deraadt 214: </ul>
215: <p>
1.5 deraadt 216: A sample use of an anoncvs CVS server would be:
1.1 deraadt 217: <pre>
218: % setenv CVSROOT anoncvs@anoncvs.openbsd.org:/cvs
219: % cd /tmp
220: % cvs get sparc
221: [copies the files from the repository to your machine]
222: % cvs log sparc/sparc/locore.s
223: [shows the commit log for the chosen file ]
224: % cvs diff -bc -r1.1 -r1.5 sparc/sparc/locore.s
225: [shows the changes between revisions 1.1 and rev 1.5]
226: </pre>
227: The CVS man page (included with the CVS sources) has much more
228: information about how CVS can be used.<p>
229: <p>
230: The anoncvs service gives fledgling developers a chance to learn CVS
231: operation and get thoroughly involved in the development process
232: before getting "commit" access -- as a result of showing useful
233: skills and high quality results they will naturally later be given
234: developer access.
235: As well, people providing patches can create their "diff"s relative
236: to the CVS tree, which will ease integration.<p>
237:
238: <p>
239: The CVS client uses rsh to talk to the CVS server.
240: If some local security measure like a firewall (or imperfect protocol
241: emulators like slirp) prevents you from using rsh, you may be able
1.5 deraadt 242: to use <a href=http://www.cs.hut.fi/ssh>ssh</a> instead (If you are
243: running Solaris, there is a kernel bug which causes problems -- contact
244: johns@cs.umr.edu for further details). In this case, one sets the
245: environment variable <strong>CVS_RSH</strong> to point to ssh
246: (typically <strong>/usr/local/bin/ssh</strong>). To reduce the
247: performance hit the anoncvs server would take it is recommended
248: (and requested) that you disable encryption. If your local site
249: prevents you from connecting out to port 22 (which ssh defaults to
1.1 deraadt 250: using) use port 2022.
1.5 deraadt 251:
252: <p>
1.1 deraadt 253: Do not be tempted to turn on compression since CVS already compresses.
254: Use something like the following in your <strong>$HOME/.ssh/config</strong>
255: file.
256: <pre>
257: Host anoncvs.openbsd.org
258: Cipher none
259: Port 2022
260: </pre>
261: If you wish to be a new anoncvs mirror site, please contact
262: <a href=mailto:deraadt@theos.com>the anoncvs maintainer</a>.
263: Anoncvs mirrors require about 250MB of disk, and use up to 8MB of swap
264: per anoncvs user (assuming the user does a large operation; while smaller
265: operations use fewer resources, anoncvs still makes much more of an
266: impact than ftp or sup). Such anoncvs machines should have excellent
267: network connectivity for the area they are expected to serve.<p>
268:
269: </dl>
270:
1.2 deraadt 271: <p>
272: A few places run OpenBSD... you can see them described in the
273: <a href=gallery.html>Gallery</a>.
274:
1.1 deraadt 275: <hr>
276: <a href=mailto:www@openbsd.org>www@openbsd.org</a>