Tuesday, November 8, 2011

[FreeBSD-Announce] FreeBSD Status Report July-September, 2011

FreeBSD Quarterly Status Report - Q3/2011

Introduction

This report covers FreeBSD-related projects between July and September
2011. It is the third of the four reports planned for 2011. This
quarter was mainly devoted to polishing the bits for the next major
version of FreeBSD, 9.0, which is to be released by then end of this
year.

Thanks to all the reporters for the excellent work! This report
contains 28 entries and we hope you enjoy reading it.

Please note that the deadline for submissions covering the period
between October and December 2011 is January 15th, 2012.
__________________________________________________________________

Projects

* GELI status update
* HAST (Highly Available Storage) status update
* pfSense
* Tool for providing FreeBSD VM Images
* ZFSguru
* ZRouter.org project -- a FreeBSD-based firmware for embedded
devices

FreeBSD Team Reports

* Ports Collection
* The FreeBSD Foundation
* The FreeBSD Release Engineering Team

Network Infrastructure

* 802.11n / atheros
* DIstributed Firewall and Flow-shaper Using Statistical Evidence
(DIFFUSE)
* Ethernet Switch Framework

Kernel

* The new CARP
* VM layer for allocations larger than a page

Documentation

* Doc sprint on IRC, September 5, 2011
* The FreeBSD German Documentation Project Status Report
* The FreeBSD Greek Documentation Project
* The FreeBSD Japanese Documentation Project

Architectures

* FreeBSD/arm on Marvell Armada XP
* FreeBSD/powerpc on AppliedMicro APM86290

Ports

* FreeBSD Haskell Ports
* KDE-FreeBSD
* OpenAFS port
* Portmaster

Miscellaneous

* bsd_day(2011)
* EuroBSDcon 2011
* FreeBSD Developer Summit, Maarssen

Google Summer of Code

* Multibyte Encoding Support in Nvi
__________________________________________________________________

802.11n / atheros

URL: http://wiki.FreeBSD.org/AdrianChadd/AtherosTxAgg

Contact: Adrian Chadd

AR5416, AR9160, and AR9280 functions in both station and hostap mode.
Performance is good.

Software retry of frames is implemented. Aggregation is implemented.

BAR TX is not yet handled. HT protection is not implemented; neither is
MIMO powersave.

Open tasks:

1. BAR TX
2. MIMO powersave
3. Correct handling of flushing TX queues during interface
reset/reconfigure
4. Correct handling of 20<->20/40mhz transitions (without dropping
frames)
5. More intelligent rate control
__________________________________________________________________

bsd_day(2011)

URL: http://bsdday.eu/2011

Contact: Martin Matuska
Contact: Gabor Pali

The purpose of this one-day event was to gather Central European
developers of today's open-source BSD systems to popularize their work
and their organizations, and to meet each other in the real life. We
wanted to motivate potential future developers and users, especially
undergraduate university students, to work with BSD systems.

This year's BSD-Day was be held in Bratislava, Slovakia at Slovak
University of Technology, Faculty of Electrical Engineering and
Information Technology on November 5, 2011.
__________________________________________________________________

DIstributed Firewall and Flow-shaper Using Statistical Evidence (DIFFUSE)

URL: http://caia.swin.edu.au/freebsd/diffused/
URL:
http://www.FreeBSDFoundation.org/project%20announcements.shtml#diffuse
URL: http://caia.swin.edu.au/urp/diffuse/
URL: http://caia.swin.edu.au/urp/diffuse/downloads.html

Contact: Sebastian Zander <szander@swin.edu.au>
Contact: Lawrence Stewart <szander@swin.edu.au>
Contact: Grenville Armitage <garmitage@swin.edu.au>

DIFFUSE enables FreeBSD's IPFW firewall subsystem to classify IP
traffic based on statistical traffic properties.

With DIFFUSE, IPFW computes statistics (such as packet lengths or
inter-packet time intervals) for observed flows, and uses ML (machine
learning) to classify flows into classes. In addition to traditional
packet inspection rules, IPFW rules may now also be expressed in terms
of traffic statistics or classes identified by ML classification. This
can be helpful when direct packet inspection is problematic (perhaps
for administrative reasons, or because port numbers do not reliably
identify applications).

DIFFUSE also enables one instance of IPFW to send flow information and
classes to other IPFW instances, which then can act on such traffic
(e.g. prioritise, accept, deny, etc.) according to its class. This
allows for distributed architectures, where classification at one
location in your network is used to control fire-walling or
rate-shaping actions at other locations.

The FreeBSD Foundation has funded the Centre for Advanced Internet
Architectures at Swinburne University of Technology to undertake the
DIFFUSED (DIFFUSE for freebsD) project, which aims to refine our
publicly released DIFFUSE prototype and integrate all components of the
architecture into FreeBSD.

The project is progressing well in the diffused_head project branch of
the FreeBSD Subversion repository, and is due to be completed by the
end of October 2011. Once the project is completed, the code will be
merged from the project branch into the head branch. An MFC of the code
to 8.x and 9.x should be possible after an appropriate amount of soak
time has elapsed.
__________________________________________________________________

Doc sprint on IRC, September 5, 2011

URL: http://people.FreeBSD.org/~bcr/doc/sprints/20110905-final.html

Contact: Benedict Reuschling
Contact: Dru Lavigne

On September 5, we held another documentation sprint on IRC channel
#bsddocs to discuss various issues that are important for the whole
FreeBSD documentation community. We talked about the status of the
planned documentation repository conversion to SVN and the status of
the XML docbook conversion. At that point in time, we did not have any
documentation regarding the new bsdinstaller in the upcoming release,
which would have been very bad for users that were trying to install
the release. Luckily, a small team formed quickly to start working on a
new bsdinstall chapter from scratch using a separate google code
repository that gjb@ had set up.

Some of the topics we discussed were moved forward and their status was
revisited at EuroBSDcon's devsummit documentation session. Before the
end of the conference, we had a new bsdinstall chapter committed into
the official documentation tree, thanks to the efforts put into the new
chapter by Gavin Atkinson, Warren Block, and Glen Barber. Garrett
Cooper provided valuable instructions on the various installation
methods that are possible with the new bsdinstaller. Thanks to all who
helped make this a reality.

It is nice to see that the things we talked about at the documentation
sprint developed further, which is why we are trying to do these
sprints in regular intervalls.

Open tasks:

1. Plan the next documentation sprint
2. Continue working on the issues that are still open like the
conversion of the repository to SVN
__________________________________________________________________

Ethernet Switch Framework

URL:
http://zrouter.org/hg/FreeBSD/head/file/default/head/sys/dev/switch

Contact: Aleksandr Rybalko

Many embedded devices have an Ethernet switch on board; such switches
are even embedded on some multiport NICs. This embedded switch
framework is designed to give users the ability to easily control basic
features present in managed switches, such as VLANs, QoS, port
mirroring, etc. Currently we are able to control only VLANs on:
* Atheros AR8216/AR8316 (standalone and embedded in AR724X)
* Broadcom BCM5325 switch family (also embedded in BCM5354 SoC)
* Ralink RT3050F/RT3052F internal switch
* Realtek RTL8309
* IP175X
* IP178X

Open tasks:

1. Fix AR8216/AR8316 driver
2. Fix BCM5325 driver, not all ports pass data
3. Add tick handler for RTL8309 to automatically unisolate ports
4. Unify MIB statistic counters access
5. Add mii read/write bus methods
6. Implement pseudo interfaces for switch PHYs
__________________________________________________________________

EuroBSDcon 2011

URL: http://2011.eurobsdcon.org/

Contact: EuroBSDcon Organizers <oc-2011@eurobsdcon.org>
Contact: Gabor Pali

The 10th anniversary European BSD Conference was organized in Maarssen,
The Netherlands with more than 250 registered visitors. There were many
interesting tutorials, including introductions to DTrace and working
with Netgraph. It featured 26 high-quality talks and 2 keynote speakers
on various topics related to FreeBSD, OpenBSD, NetBSD, or even MINIX:
OpenBSD PF, NetBSD NPF, IPv6 support in FreeBSD, virtualization in the
BSD domain, recent developments in OpenSSH, exploration of the recent
FreeNAS, system management with ZFS, practical capabilities for UNIX
known as Capsicum.

It also had a dedicated track for the attendees of the FreeBSD
developer summit, where one could learn more about what is happening
currently in the Project. We had presentations on the new package
management solution, Google Summer of Code 2011, a stacked
cryptographic file system, conversion of documents of different
formats, and status reports on the sparc64 port and the NAND flash
support.
__________________________________________________________________

FreeBSD Developer Summit, Maarssen

URL: http://wiki.FreeBSD.org/201110DevSummit

Contact: Gabor Pali

We had 60 FreeBSD developers and invited guests attending the FreeBSD
Developer Summit organized as part of EuroBSDcon 2011 in Maarssen, The
Netherlands. This year EuroBSDcon organizers offered us their generous
support in handling the details, like registrations, renting the venue,
and providing food for keeping attendees happy.

The Maarssen developer summit spanned over 3 days. It is generally a
workshop-style event that has now adopted the layout of the developer
summit organized successfully in Canada earlier in May. On the first
day, there were working groups on various topics, e.g. Capsicum,
toolchain issues, ports, and documentation. On the second day, there
were various plenary discussions, like how FreeBSD relates to
virtualization or how vendors relate to FreeBSD. Finally, on the third
day, there were many interesting work-in-progress reports given in a
dedicated developer summit track at the main conference.

Photos and slides for the most of the talks are available on the home
page of the summit.
__________________________________________________________________

FreeBSD Haskell Ports

Contact: Gabor Janos PaLI
Contact: Ashish SHUKLA

We updated existing ports to their latest versions and hunted down a
bug in the 9-CURRENT rtld which was causing GHC to crash
intermittently. We also started work on Haskell Platform 2011.3.0.0
(development version) in a separate git branch in our development
repository.

Open tasks:

1. Test GHC to work with clang/LLVM.
2. Add an option to the GHC port to be able to build it with already
installed GHC instead of requiring a separate GHC boostrap tarball.
3. Update Haskell Platform (along with GHC) to 2011.4.0.0 as soon as
it gets out.
4. Add more ports to the Ports collection.
__________________________________________________________________

FreeBSD/arm on Marvell Armada XP

Contact: Grzegorz Bernacki <gjb@semihalf.com>
Contact: Rafal Jaworowski <raj@semihalf.com>

Marvell Armada XP is a complete system-on-chip solution based on the
Sheeva embedded CPUs. These devices integrate up to four ARMv6/v7
compliant Sheeva CPU cores with shared L2 cache.

This work is extending FreeBSD/arm infrastructure towards support for
recent ARM architecture variations along with a basic set of device
drivers for integrated peripherals.

The following code has been implemented since the last status report:
* PCI-Express support
* SMP support
*
+ Created framework for ARM platform dependent code.
+ Initialization and starting of Application Processor.
+ Implementation of sending/handling IPI

Next steps:
* Finalize SMP support (TLB/cache operation broadcast, etc.)
* L2 cache support
* SATA driver
__________________________________________________________________

FreeBSD/powerpc on AppliedMicro APM86290

Contact: Grzegorz Bernacki <gjb@semihalf.com>
Contact: Rafal Jaworowski <raj@semihalf.com>

The APM86290 system-on-chip device is a member of AppliedMicro's
PACKETpro family of embedded processors.

The chip includes two Power Architecture PPC465 processor cores, which
are compliant with the Book-E specification of the architecture, and a
number of integrated peripherals.

This work is extending current Book-E support in FreeBSD towards PPC4xx
processor variants along with device drivers for integrated
peripherials.

The following drivers have been created since the last report:
* Interrupt controller
* EHCI USB driver attachment
* Queue Manager/Traffic Manager support
* Initial support of Ethernet controller
* GPIO, I2C

Next steps:
* Finalize Ethernet controller driver
* L2 cache support
__________________________________________________________________

GELI status update

Contact: Pawel Jakub Dawidek

Selected GELI (disk encryption GEOM class) changes since 2010/Q3
report:
* Implementation of suspend/resume functionality.
* New version subcommand to check GELI providers version.
* New -V option for init subcommand, which allows to create GELI
providers for older FreeBSD versions.
* Significant aesni(4) performance improvements for AES-XTS
algorithm.
__________________________________________________________________

HAST (Highly Available Storage) status update

Contact: Pawel Jakub Dawidek

Contact: Mikolaj Golub

HAST is under active development. Some changes since Q1 report:
* Async replication mode. Unfortunately it will not make it into
9.0-RELEASE (pjd@).
* IPv6 support (pjd@).
* Activemap fix that significantly reduces number of metadata updates
(trociny@).
* Provider's write cache flush after metadata updates (pjd@).
* Possibility to specify pidfile in configuration file (pjd@).
* Many bug fixes and other improvments.
__________________________________________________________________

KDE-FreeBSD

URL: FreeBSD.kde.org
URL:
http://dot.kde.org/2011/06/29/platform-frameworks-kde-hackers-meet-swit
zerland
URL:
http://blogs.FreeBSDish.org/avilla/2011/06/14/call-for-tests-kde-pim-4-
6-0
URL: http://FreeBSD.kde.org/area51.php

Contact: KDE FreeBSD <kde-freebsd@kde.org>

Alberto Villa and Raphael Kubo da Costa went to Randa, Switzerland, to
attend, respectively, the KDE Multimedia/Kdenlive sprint and the
Platform 11 sprint. The sprints afforded them the opportunity to form
closer bonds with the upstream KDE community, to learn about the future
of Qt and KDE and make sure FreeBSD's needs are taken into account. For
more information see the article "From Platform to Frameworks -- KDE
hackers meet in Switzerland" at dot.kde.org.

The KDE on FreeBSD team have continued to improve the experience of KDE
and Qt under FreeBSD. The latest round of improvements include:
* Qt supports Clang as a compiler

The team has also made many releases and upstreamed many fixes and
patches. The latest round of releases include:
* Qt: 4.7.3
* KDE: 4.6.3; 4.6.4; 4.6.5
* Amarok: 2.4.1
* Digikam (and KIPI-plugins): 1.9.0

Further testing is requested for KDE PIM 4.6.0 and Calligra 2.3.72
before the ports are committed. To test the ports please visit Alberto
Villa's call for test and area51.

The team is always looking for more testers and porters so please visit
us at kde-freebsd@kde.org and our homepage.

Open tasks:

1. Testing KDE PIM 4.6.0
__________________________________________________________________

Multibyte Encoding Support in Nvi

URL: http://wiki.FreeBSD.org/ZhihaoSoC2011
URL: https://github.com/lichray/nvi2

Contact: Zhihao Yuan <lichray@gmail.com>

nvi-iconv keeps the behaviors and the license of nvi-1.79 in the base
system and adopts the multibyte encoding support from nvi-1.8x.

Status:
* Known memory leaks, bugs are fixed. make buildworld clear, under
WARNS=1 (the old one was WARNS=0).
* UTF-16 is supported with less hacks.
* The 'windowname' option now restores the xterm title through xprop.
* The file encoding detection modified from file(1) is finished and
considered stable. The detection is always on since nvi-iconv never
change the actual encoding, and the detection failbacks to locale.
* Pavel Timofeev provided a full Russian translation of the catalog.
Thanks to him.
* Now nvi-iconv is able to be compiled with widechar only and without
iconv (inspired by a user on FreeBSDChina.org). In that case, it
only supports your locale.

Open tasks:

1. The wide character support in nvi's message (feedback over the last
line) system.
2. Collect more testing results and get code review.
__________________________________________________________________

OpenAFS port

URL: http://openafs.org
URL: http://wiki.FreeBSD.org/afs

Contact: Benjamin Kaduk <kaduk@mit.edu>
Contact: Derrick Brashear <shadow@gmail.com>

AFS is a distributed network filesystem that originated from the Andrew
Project at Carnegie-Mellon University. OpenAFS 1.6.0 has released, and
is available in the FreeBSD Ports Collection; it is usable under light
load, but heavy usage reveals some issues that remain unresolved. The
OpenAFS kernel module is now built using the bsd.kmod.mk infrastructure
on the git master branch; unfortunately this change required a minor
change in the OS-independent Makefiles and could not be merged in time
for 1.6.0. Some attention has been given to memory leaks, but only one
small leak has been patched so far.

There are several known outstanding issues that are being worked on,
but detailed bug reports are welcome at port-freebsd@openafs.org.

Open tasks:

1. Update VFS locking to allow the use of disk-based client caches as
well as memory-based caches.
2. Track down races and deadlocks that may appear under load.
3. Eliminate a moderate memory leak from the kernel module.
4. PAG (Process Authentication Group) support is not functional.
__________________________________________________________________

pfSense

URL: http://www.pfsense.org/

Contact: Scott Ullrich <sullrich@gmail.com>
Contact: Chris Buechler <cbuechler@gmail.com>

pfSense 2.0 has been released to the world. This brings the past three
years of new feature additions, with significant enhancements to almost
every portion of the system. The changes and new features are
summarized here. This is by far the most widely deployed release we
have put out, thanks to the efforts of thousands of members of the
community.

Open tasks:

1. Work on 2.1 is underway with the biggest changes being IPV6 support
and PBI packaged binaries for the package system.
__________________________________________________________________

Portmaster

URL: http://dougbarton.us/portmaster-proposal.html

Contact: Doug Barton

Portmaster offers several new features since the last quarterly update;
some bug fixes for the package installation code, and various internal
optimizations. The most exciting new feature is probably the ability to
specify the -r option more than once for the same portmaster run. This
greatly increases efficiency when several "branch" and/or "trunk" ports
need updates at the same time, especially for package-building systems.

Open tasks:

1. Splitting out the fetch code is still "on the list" of work to be
done, but it was sidetracked by other priorities in the past
months. I hope to complete it in the quarter to come.
2. Another new feature in the works is support for a list of files for
portmaster to preserve and restore during upgrades of a port.
__________________________________________________________________

Ports Collection

URL: http://www.FreeBSD.org/ports/
URL:
http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributing-ports/
URL: http://portsmon.FreeBSD.org/index.html
URL: http://www.FreeBSD.org/portmgr/index.html
URL: http://blogs.FreeBSDish.org/portmgr/
URL: http://www.twitter.com/freebsd_portmgr/
URL: http://www.facebook.com/group.php?gid=135441496471197

Contact: Thomas Abthorpe
Contact: Port Management Team

The ports tree slowly moves up closer to the 23,000 mark. The PR count
still remains at about 1000.

In Q2 we added 4 new committers, but took in 6 commit bits for safe
keeping.

The Ports Management team have been running -exp runs on an ongoing
basis, verifying how base system updates may affect the ports tree, as
well as providing QA runs for major ports updates. Of note, -exp runs
were done for:
* Python update
* Boost updates
* Gtk3 updates
* clang testing
* pkgng testing
* testing ruby19
* setting the default fortran to lang/gcc46
* setting apache22 as default
* setting the default LDFLAGS in CONFIGURE_ENV

Work continues to refine the new build master pointyhat-west. An
upgrade to -current done in September has proven problematic. We have
enlisted ISC and Josh Paetzel to try to determine a fix. In the
meantime, the source will be downgraded to RELENG_9.

The portsmon instance is being re-homed at Yahoo. Users should not see
any changes. The new instance is currently visible at
portsmonj.FreeBSD.org but will soon take on the portsmon.FreeBSD.org
name. The team would like to express its appreciation to TDC A/S for
the loan of the existing machine for several years.

Work is underway to create a new QAT instance at NYI/NJ.

portmgr also assisted in setting up a sparc64 machine for general
develop access at Yahoo.

Thanks to on-site work by Sean Bruno and Ben Haga, we once again have
access to the powerpc build machine at ISC, and powerpc builds have
been restarted. They also helped us get one more i386 machine back
online.

linimon is working on a set of scripts to more quickly produce
pre-configured PXEboot images for package build nodes.

The update of __FreeBSD_version in param.h to 1000000 proved very
disruptive to the ports tree, triggering lots of bad assumption in code
that interpreted it as FreeBSD 1. A great deal of work has gone into
identifying the instances of broken code and fixing and upstreaming
them. While this is taking place, one recommended workaround is to set
your version to 999999.

Open tasks:

1. Looking for help getting ports to build with clang.
2. Looking for help fixing ports broken on CURRENT. (List needs
updating, too)
3. Looking for help with Tier-2 architectures. (List needs updating,
too)
4. Most ports PRs are assigned, we now need to focus on testing,
committing and closing.
__________________________________________________________________

The FreeBSD Foundation

URL: http://www.FreeBSDFoundation.org/

Contact: Deb Goodkin

The Foundation sponsored KyivBSD 2011 which was held in Kiev, Ukraine
on September 24. We were represented at Ohio LinuxFest in Columbus,
Ohio. And, we approved six travel grants for EuroBSDCon. Stop by and
visit us at the FreeBSD booth during LISA '11, December 7-8, in Boston,
MA.

Three Foundation funded projects were completed during this period:
implementing xlocale APIs to enable porting libc++ by David Chisnall,
implementing DIFFUSE for FreeBSD by Swinburne University, and adding
GEM, KMS, and DRI support for Intel drivers by Konstantin Belousov.

We published our semi-annual newsletter. We purchased servers and other
hardware for the FreeBSD co-location centers at Sentex and NYI.

The work above, as well as many other tasks which we do for the FreeBSD
Project, could not be done without donations. Please help us by making
a donation or asking your company to make a donation. We would be happy
to send marketing literature to you or your company. Find out how to
make a donation at our donate page.

Find out more up-to-date Foundation news by reading our blog and
Facebook page.
__________________________________________________________________

The FreeBSD German Documentation Project Status Report

URL: https://doc.bsdgroup.de

Contact: Johann Kois
Contact: Benedict Reuschling

We managed to update the German version of the documentation just in
time to get it included in the upcoming 9.0-RELEASE. The website
translations were also kept in sync with the ones on FreeBSD.org.

We tried to re-activate committers who did not contribute for some time
but most of them are currently unable to free up enough time. We hope
to gain fresh contributor blood as we are getting occasional reports
about bugs and grammar in the German translation.

Open tasks:

1. Submit grammar, spelling or other errors you find in the German
documents and the website
2. Translate more articles and other open handbook sections
(especially the new chapter about the new FreeBSD installer).
__________________________________________________________________

The FreeBSD Greek Documentation Project

URL: http://www.FreeBSDgr.org
URL: http://www.FreeBSD.org/doc/el/books/handbook

Contact: Manolis Kiagias
Contact: Giorgos Keramidas

After a few rather quiet months, the FreeBSD Greek Documentation
Project is back on track, translating and improving the Handbook, FAQ
and FreeBSD articles. The new bsdinstall chapter has been translated
and is now present in the Handbook. Our experimental Handbook builds
are also available at the project's hub. Three new status pages have
been added:
* Merge Status for the en_US tree shows whether the local en_US repo
is in sync with the official CVS
* Merge Status for the el_GR tree - as above but for the Greek tree
* Pending Commits shows newer yet to be committed versions of the
Greek docs

For more information, please visit http://www.freebsdgr.org. Patches,
fixes and contributions are always welcome.

Open tasks:

1. Translate the remaining chapters of the Handbook to Greek.
2. Complete the translation of the FreeBSD FAQ.
3. Keep the currently translated docs in sync with the English
versions.
__________________________________________________________________

The FreeBSD Japanese Documentation Project

URL: http://www.FreeBSD.org/ja/
URL: http://www.jp.FreeBSD.org/doc-jp/

Contact: Hiroki Sato
Contact: Ryusuke Suzuki

The www/ja and doc/ja_JP.eucJP/books/handbook subtrees have constantly
been updated since the last report.

www/ja: During this period, many areas of outdated content in the
www/ja subtree were updated to the latest versions in the English
counterparts. The Japanese version of 8.2R release announcement was
added and the upcoming 9.0R announcement will be translated in a timely
manner.

Handbook: The Japanese "kernelconfig" section finally caught up with
the original English version. The next targets are "cutting-edge" and
new installer section.

Open tasks:

1. Further translation work for outdated documents in both
doc/ja_JP.eucJP and www/ja.
__________________________________________________________________

The FreeBSD Release Engineering Team

URL: http://www.FreeBSD.org/releng/

Contact: Release Engineering Team

The Release Engineering Team has been coordinating the upcoming FreeBSD
9.0-RELEASE. Thanks to work done by many of the developers. The
release, though delayed, is taking the shape nicely. We have reached
the stage of doing the second Release Candidate. At this time we expect
to have one more Release Candidate, to be followed by the final release
itself.
__________________________________________________________________

The new CARP

URL: http://people.FreeBSD.org/~glebius/newcarp/

Contact: Gleb Smirnoff

I am now working on significant rewrite of CARP in FreeBSD.

The reason for this work is that the CARP protocol actually does not
bring a new interface, but is a property of interface address.
Rewriting it in this way helps to remove several hacks from incoming
packet processing, simplifies some code, makes CARP addresses more sane
from the viewpoint of routing daemons such as quagga/zebra and closes
many CARP-related PRs in GNATS. It also brings support for a single
redundant address on the subnet, the thing that is called "carpdev
feature" in OpenBSD, long awaited in FreeBSD.

For this moment I have a patch against head/ that compiles and works in
my test environment that I am going to deploy soon on some of servers
under my control.

The patch has been reviewed by Bjoern Zeeb (bz@).

Open tasks:

1. More testing requested!
2. Implement arpbalance and ipbalance features. This requires a next
step of rewriting, probably borrowing some ideas from OpenBSD.
3. Update documentation.
__________________________________________________________________

Tool for providing FreeBSD VM Images

URL: https://github.com/yerenkow/freebsd-vm-image

Contact: Alexander Yerenkow <yerenkow@gmail.com>

A set of scripts to make building FreeBSD VM images easy.

Providing a way to make regular build images of the latest version from
SVN. Images currently can be copied with `dd` to USB flash (for testing
on real hardware) and VirtualBox (.vdi).

Open tasks:

1. Build images with ports-set from main port-tree
2. Build images with ports-set from main port-tree plus overrides form
area51 (like experimental images)
3. Build images with special development branches included (like for
testing drivers)
__________________________________________________________________

VM layer for allocations larger than a page

Contact: Alan Cox
Contact: Davide Italiano <davide.italiano@gmail.com>

The aim of this project is to create a new layer that sits between UMA
and the virtual memory system managing chunks of kernel virtual memory
on the order of 2 to 4 MB in size. At the end of the work, UMA
page_alloc() would no longer call directly into the VM system. It would
instead call into this new layer. Thus, uma_large_malloc() and
uma_large_free() would no longer be immediately allocating and
deallocating kernel virtual memory. This results in a gain in terms of
performances (there is a relatively high cost in the approach adopted
until now), and also in terms of reduction of fragmentation (the VM
system uses a first-fit policy of allocation so there is room for
improvements).
__________________________________________________________________

ZFSguru

URL: http://zfsguru.com
URL: http://zfsguru.com

Contact: Jason Edwards

ZFSguru is a newly designed Network Attached Storage operating system,
much like FreeNAS. The difference is that ZFSguru focuses heavily on
ZFS and user friendly operation, and uses a full FreeBSD distribution
with no elements stripped down. This allows people new to FreeBSD and
UNIX in general to access the power of ZFS, while still allowing more
advanced users to tweak their NAS with additional functionality and use
it as a normal FreeBSD distribution.

Started a little over a year ago, the ZFSguru project is making good
progress. It should already be one of the most user friendly
distributions focused on ZFS, and sports some very unique features. The
advanced ZFS benchmarking and convenient Root-on-ZFS installation are
good examples. Priority is given to finishing the missing core
functionality, and extending the number of available service addons
which currently are limited to iSCSI-target and VirtualBox extensions.

Open tasks:

1. Finish ZFS and network related functionality in the web-interface.
2. Introduce new service addons, adding optional functionality to
ZFSguru.
3. Extend the documentation.
__________________________________________________________________

ZRouter.org project -- a FreeBSD-based firmware for embedded devices

URL: http://zrouter.org
URL: http://lists.zrouter.org
URL: http://zrouter.org/hg/zrouter/
URL: http://zrouter.org/hg/FreeBSD/head/

Contact: Aleksandr Rybalko

ZRouter.org is a young project that aims to produce FreeBSD-based
firmware for small boxes such as SOHO router, APs, etc. At the present
time ZRouter.org is able to build working firmware for:
* D-Link DAP-1350
* D-Link DIR-320
* D-Link DIR-320-NRU
* D-Link DIR-330
* D-Link DIR-615-E4
* D-Link DIR-620
* D-Link DIR-632
* D-Link DSA-3110-A1
* D-Link DSR-1000N
* NorthQ NQ-900
* TPLink TL-WR941ND-v3_2
* Ubiquiti RSPRO

Currently we are working on most parts of the core system but we are
also in the planning phase for implementing a simple web-based GUI
which we hope will have taken form before the next FreeBSD status
report.

We still have many items not done, so devices in that list cannot be
called "Production Ready" yet. But we work on that.

It is easy to add new devices, because we have separate definition of
board and SoC(System on Chip), so if you have "Asus WL-500g Premium v2"
for example, you can copy D-Link/DIR-320 directory and tweak to work
for your device. We already have basic support for:
* Broadcom BCM5354
* Broadcom BCM5836
* Ralink RT3052F
* Ralink RT3050F
* Ralink RT5350F
* Atheros AR7161
* Atheros AR7242
* Atheros AR7241
* Atheros AR7240
* Atheros AR9132
* Intel ixp435
* Cavium CN5010

If you have ability and time, please join us at http://zrouter.org
(Redmine iface and mailing lists)

Open tasks:

1. Device drivers
2. Web UI
3. Control scripts
4. Watchdog
5. etc.
__________________________________________________________________

(c) 1995-2011 The FreeBSD Project. All rights reserved.
_______________________________________________
freebsd-announce@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-announce
To unsubscribe, send any mail to "freebsd-announce-unsubscribe@freebsd.org"

Tuesday, November 1, 2011

OpenBSD 5.0 released Nov 1, 2011

------------------------------------------------------------------------
- OpenBSD 5.0 RELEASED -------------------------------------------------

Nov 1, 2011.

We are pleased to announce the official release of OpenBSD 5.0.
This is our 30th release on CD-ROM (and 31th via FTP). We remain
proud of OpenBSD's record of more than ten years with only two remote
holes in the default install.

As in our previous releases, 5.0 provides significant improvements,
including new features, in nearly all areas of the system:

- Improved hardware support, including:
o MSI interrupts for many devices, on those architectures which can
support them (amd64, i386, sparc64 only so far).
o A new dma_alloc(9) API makes it easier for kernel code to allocate
dma-safe memory. Many drivers (especially network drivers) and
subsystems (in particular scsi and the buffer cache) were adapted
to use this.
o As a result, big-memory support has been enabled on all possible
architectures.
o The rather rare bce(4) driver now copies mbufs all the time, to cope
with the hardware having a 1GB limit.
o Added hds(4), a driver for Hitachi Modular Storage SCSI devices.
o Added myx(4), a driver for the Myricom Myri-10G 10GB Ethernet devices.
o Added dfs(4), a driver for Dynamic Frequency Switching on some macppc
systems.
o cardbus(4) and pcmcia(4) support on sgi.
o Suspend/resume support on Loongson Yeelong laptops.
o Interrupt handlers for bnx(4), em(4), ix(4) and sis(4) have been
improved reducing overhead and increasing performance.
o New acpitoshiba(4) driver providing ACPI support for Toshiba laptops.
o Added nvt(4), a driver for the W83795G and W83795ADG hardware monitor.
o Added support to sdhc(4) for the Ricoh 5U823 SD/MMC controller.
o A new fw_update(1) tool to install and update non-free firmware packages.

- Generic network stack improvements:
o Added support for sending Wake on LAN packets using arp(8).
o Permit turning Wake on LAN support on/off using ifconfig(8).
o Added Wake on LAN support to xl(4), re(4), and vr(4).
o Allow ftp-proxy to proxy across rdomains.
o The IPv4 stack will no longer accept ICMP redirects when
acting as a router.
o By default the IPv6 stack will not process ICMP6 redirects.
rtsol(8) will turn it back if -F is used.
o Reworked large parts of the dhclient(8) options processing for better
interoperability.
o Fixed carp(4) to work in IPv6 only setups.
o Make it possible to bind(2) to the local network broadcast address
on datagram and raw sockets.
o The default multicast reject route is now ignored if the UDP socket
uses the IP_MULTICAST_IF socket option.
o Make gre(4) work between systems in the same LAN.
o Removed the link1 mode special addressing mode on lo(4).
o New net.inet.tcp.always_keepalive sysctl, effectively enabling
SO_KEEPALIVE on all TCP sockets.

- Routing daemons and other userland network improvements:
o bgpd(8) no longer bumps the rlimits: the rc.d framework respects
login classes which is a much better solution.
o Correctly set the network filtersets on reload in bgpd(8).
o The routing socket is now sending RTM_DESYNC messages if the
socketbuffer overflows.
o Allow ospfd(8) to send out LS updates and other messages
larger than the MTU.
o Fixed nexthop calculation in ospfd(8) for directly connected P2P links.
o First bits to support opaque LSA in ospfd(8). Only basic redistribute
logic and LSDB handling for now.
o Creating new interfaces will no longer cause a fatal error in ospf6d(8).
o ospf6d(8) handles link-state changes better.
o Better loopback handling in ospf6d(8).
o No longer install extra multicast routes in ripd(8) and ldpd(8).
o Make kqueue(2) work with sosplice(9).
o Enabled sosplice(9) in relayd(8) for TCP.
o Added support for divert-to which provides some benefits over
rdr-to in relayd(8).
o Reload support in relayd(8) has been fixed.
o Fixed trap sending in snmpd(8).
o Make ping6(8) compare minimum amount of bytes between what
was received and what was sent out.
o Make traceroute(8) with type-of-service setted (-t) display
a message if the returned packet has a different tos type.
o Added the socket splicing fields of struct socket to netstat -vP output.
o tcpbench(1) now uses libevent and supports both TCP and UDP modes.
o TCP socket buffer sizes can now be displayed using the netstat(1) -B flag.
o tcpdump(8) can now filter on icmptype and tcpflags.
o bgplg(8) now supports "show ip bgp peer-as".

- pf(4) improvements:
o Make pf(4) reassemble IPv6 fragments. In the forward case, pf
refragments the packets with the same maximum size.
o Allow pf(4) to filter on the rdomain a packet belongs to.
o Make pf(4) allow userland proxies to establish cross rdomain
proxy sessions.
o Added IPv6 ACK prioritization in pf(4).
o Change 'set skip on <...>' to work with interface groups.
o pfsync(4) supports IPv6 as network protocol.
o Switched ftp-proxy(8) over to divert-to instead of rdr-to.
o Switched tftp-proxy(8) over to divert-to instead of rdr-to.
o New very low overhead priority queueing implementation for pf(4) used via
the "prio" keyword.
o Support for least-states in load balancing pools and tables.
o Support for weighted round-robin in load balancing pools and tables.

- SCSI improvements:
o Most SCSI hardware drivers now use the new iopools infrastructure.
o scsi(4) devices are now all provided with a unique devid, which
is displayed during the probe process.
o ASC/ASCQ error codes and verbiage now in sync with
http://www.t10.org/lists/asc-num.txt.
o Progress on iSCSI includes better login, better logout, preliminary
FSM support in iscsid(8), and improved logging and debug information.
o uk(4) can now safely and reliably detach an unknown SCSI device.
o SCSI multipath device and kernel support has been improved.
o vscsi(4) now ensures output always goes to the correct connection.
o vscsi(4) connections can now be reset gracefully.
o scsi(4) devices on fibre channel fabrics no longer inherit the adapter's
address.

- Assorted improvements:
o Kernel randomization speed and quality improved substantially.
o For additional security, security(8) was rewritten in Perl.
o Mandoc 1.11.4: Now accepts eqn(7) input (no fancy formatting yet)
and supports -Tutf8 output (but no utf8 input yet).
o Removed a variety of OS-compat emulation code, leaving just the Linux
support.
o Small improvements to Linux compat (only available on i386).
o Improved our own pkg-config(1) implementation with extended comparison
scheme and implementing various new options.
o The math library, libm, was fully fleshed out to support all C99 required
parts. Many bugs for various architectures were fixed along the way.
o malloc(3) is a lot faster and has a few further security features (more
randomization, as well as the 'S' flag to enable all paranoia checks).
o 'make depend' is no longer neccessary in kernel compilation directories
since the dependencies are calculated automatically.
o Increased the default size of the buffer cache.
o kqueue(2) now works on /dev/random and spliced sockets
o On MBR-based disks, scan through up to 256 extended partition tables
when looking for an OpenBSD partition table.
o Added POSIX 2008 fdopendir(3) and openat(2) functions, as well as the
O_CLOEXEC, O_DIRECTORY, and F_DUPFD_CLOEXEC flags.
o Improved lint format string checks and added a few other checks.
o kdump(8) now dumps stat and sockaddr structures, sysctl mib
strings, and decodes syscall flags and operation bits.
o Improved kernel pool debug checking.
o Improved correctness of signals and various syscalls when rthreads
are in use.
o Kernel malloc(9) space and stacks moved to non-dma memory.
o Fixed some shutdown/reboot hangs on NFS clients.
o UNIX-domain socket paths are now guaranteed to be NUL-terminated.
o Added support for *wprintf(3), wcs{,n}casecmp(3), and wcsdup(3).
o NULL is now a (void *).
o grep(1) now supports a -H option to always print filename headers.
o Whitelist expiry for spamlogd(8) can now be configured via a -W flag.
o ls(1) now supports the POSIX -H option to follow symbolic links specified
on the command line.
o disklabel(8) now tries the next auto-allocation scheme if the current one
fails due to insufficient available partitions.
o bc(1) gained editline(3) support.
o Many enhancements and new functionality has been added to tmux(1).
o disklabel(8) supports absolute resizing of partitions in auto-allocated
labels.
o newfs(8) accepts k/m/g suffixes for the -S and -s options.

- Install/Upgrade process changes:
o Completed support for DUID disk installs, and enabled it fully.
o Install non-free firmwares from the internet upon first boot, based on a
question in the installer.
o svnd(4)-like behaviour became the default for vnd(4) devices. This is
what is used to build the media.

- rc.d(8) framework improvements:
o rc.d(8) is now also used for the base system daemons.
o Backward compatible with the historic way of starting daemons.
o Notify the user by appending (ok) or (failed) in interactive mode.
o Better diagnostics with the introduction of RC_DEBUG.

- OpenSSH 5.9:
o New features:
- Introduce sandboxing of the pre-auth privsep child using an
optional sshd_config(5) "UsePrivilegeSeparation=sandbox" mode
that enables mandatory restrictions on the syscalls the privsep
child can perform.
- Add new SHA256-based HMAC transport integrity modes from
http://www.ietf.org/id/draft-dbider-sha2-mac-for-ssh-02.txt
These modes are hmac-sha2-256, hmac-sha2-256-96, hmac-sha2-512,
and hmac-sha2-512-96, and are available by default in ssh(1)
and sshd(8).
- The pre-authentication sshd(8) privilege separation slave process
now logs via a socket shared with the master process, avoiding
the need to maintain /dev/log inside the chroot.
- ssh(1) now warns when a server refuses X11 forwarding.
- sshd_config(5)'s AuthorizedKeysFile now accepts multiple paths,
separated by whitespace. The undocumented AuthorizedKeysFile2
option is deprecated (though the default for AuthorizedKeysFile
includes .ssh/authorized_keys2).
- sshd_config(5): similarly deprecate UserKnownHostsFile2 and
GlobalKnownHostsFile2 by making UserKnownHostsFile and
GlobalKnownHostsFile accept multiple options and default to
include known_hosts2.
- sshd_config(5)'s ControlPath option now expands %L to the host
portion of the destination host name.
- sshd_config(5) "Host" options now support negated Host matching.
- sshd_config(5): a new RequestTTY option provides control over
when a TTY is requested for a connection, similar to the existing
-t/-tt/-T ssh(1) commandline options.
- ssh-keygen(1): Add -A option. For each of the key types (rsa1,
rsa, dsa and ecdsa) for which host keys do not exist, generate
the host keys with the default key file path, an empty passphrase,
default bits for the key type, and default comment. This is useful
for system initialisation scripts.
- ssh(1): Allow graceful shutdown of multiplexing: request that
mux server removes its listener socket and refuse future
multiplexing requests but don't kill existing connections. This
may be requested using "ssh -O stop ...".
- ssh-add(1): now accepts keys piped from standard input.
- Retain key comments when loading v.2 keys. These will be visible
in "ssh-add -l" and other places. (bz#439)
- ssh(1) and sshd(8): set IPv6 traffic class from IPQoS (as well as
IPv4 ToS/DSCP). (bz#1855)
o The following significant bugs have been fixed in this
release:
- sshd(8): allow GSSAPI authentication to detect when a server-side
failure causes authentication failure and don't count such failures
against MaxAuthTries. (bz#1244)
- ssh-keysign(8): now signs hostbased authentication challenges
correctly using ECDSA keys. (bz#1858)

- Over 7,200 ports, major robustness and speed improvements in package tools.
- Many pre-built packages for each architecture:
o i386: 7008 o sparc64: 6456
o alpha: 6046 o sh: 3721
o amd64: 6960 o powerpc: 6691
o sparc: 3277 o arm: 2963
o hppa: 6125 o vax: 1409
o mips64: 5689 o mips64el: 5709

- Some highlights:
o Gnome 2.32.2 o KDE 3.5.10
o Xfce 4.8.0 o MySQL 5.1.54
o PostgreSQL 9.0.5 o Postfix 2.8.4
o OpenLDAP 2.3.43 and 2.4.25 o Mozilla Firefox 3.5.19, 3.6.18 and 5.0
o Mozilla Thunderbird 5.0 o GHC 7.0.4
o LibreOffice 3.4.1.3 o Emacs 21.4, 22.3 and 23.3
o Vim 7.3.154 o PHP 5.2.17 and 5.3.6
o Python 2.4.6, 2.5.4 and 2.7.1 o Ruby 1.8.7.352 and 1.9.2.200
o Mono 2.10.2 o Chromium 12.0.742.122
o Groff 1.21

- As usual, steady improvements in manual pages and other documentation.
o Base system and Xenocara manuals are now installed as source code,
making grep(1) more useful in /usr/share/man/ and /usr/X11R6/man/.
o If both formatted and source versions of manuals are installed,
man(1) automatically displays the newer version of each page.

- The system includes the following major components from outside suppliers:
o Xenocara (based on X.Org 7.6 with xserver 1.9 + patches,
freetype 2.4.5, fontconfig 2.8.0, Mesa 7.8.2, xterm 270,
xkeyboard-config 2.3 and more)
o Gcc 2.95.3 (+ patches), 3.3.5 (+ patches) and 4.2.1 (+patches)
o Perl 5.12.2 (+ patches)
o Our improved and secured version of Apache 1.3, with
SSL/TLS and DSO support
o OpenSSL 1.0.0a (+ patches)
o Sendmail 8.14.5, with libmilter
o Bind 9.4.2-P2 (+ patches)
o Lynx 2.8.7rel.2 with HTTPS and IPv6 support (+ patches)
o Sudo 1.7.2p8
o Ncurses 5.7
o Heimdal 0.7.2 (+ patches)
o Arla 0.35.7
o Binutils 2.15 (+ patches)
o Gdb 6.3 (+ patches)

If you'd like to see a list of what has changed between OpenBSD 4.9
and 5.0, look at

http://www.OpenBSD.org/plus50.html

Even though the list is a summary of the most important changes
made to OpenBSD, it still is a very very long list.

------------------------------------------------------------------------
- SECURITY AND ERRATA --------------------------------------------------

We provide patches for known security threats and other important
issues discovered after each CD release. As usual, between the
creation of the OpenBSD 5.0 FTP/CD-ROM binaries and the actual 4.9
release date, our team found and fixed some new reliability problems
(note: most are minor and in subsystems that are not enabled by
default). Our continued research into security means we will find
new security problems -- and we always provide patches as soon as
possible. Therefore, we advise regular visits to

http://www.OpenBSD.org/security.html
and
http://www.OpenBSD.org/errata.html

Security patch announcements are sent to the security-announce@OpenBSD.org
mailing list. For information on OpenBSD mailing lists, please see:

http://www.OpenBSD.org/mail.html

------------------------------------------------------------------------
- CD-ROM SALES ---------------------------------------------------------

OpenBSD 5.0 is also available on CD-ROM. The 3-CD set costs $50 CDN and
is available via mail order and from a number of contacts around the
world. The set includes a colourful booklet which carefully explains the
installation of OpenBSD. A new set of cute little stickers is also
included (sorry, but our FTP mirror sites do not support STP, the Sticker
Transfer Protocol). As an added bonus, the second CD contains an audio
track, a song entitled "What Me Worry?". MP3 and OGG versions of
the audio track can be found on the first CD.

Lyrics (and an explanation) for the songs may be found at:

http://www.OpenBSD.org/lyrics.html#50

Profits from CD sales are the primary income source for the OpenBSD
project -- in essence selling these CD-ROM units ensures that OpenBSD
will continue to make another release six months from now.

The OpenBSD 5.0 CD-ROMs are bootable on the following four platforms:

o i386
o amd64
o macppc
o sparc64

(Other platforms must boot from floppy, network, or other method).

For more information on ordering CD-ROMs, see:

http://www.OpenBSD.org/orders.html

The above web page lists a number of places where OpenBSD CD-ROMs
can be purchased from. For our default mail order, go directly to:

https://https.OpenBSD.org/cgi-bin/order

All of our developers strongly urge you to buy a CD-ROM and support
our future efforts. Additionally, donations to the project are
highly appreciated, as described in more detail at:

http://www.OpenBSD.org/goals.html#funding

------------------------------------------------------------------------
- OPENBSD FOUNDATION ---------------------------------------------------

For those unable to make their contributions as straightforward gifts,
the OpenBSD Foundation (http://www.openbsdfoundation.org) is a Canadian
not-for-profit corporation that can accept larger contributions and
issue receipts. In some situations, their receipt may qualify as a
business expense write-off, so this is certainly a consideration for
some organizations or businesses. There may also be exposure benefits
since the Foundation may be interested in participating in press releases.
In turn, the Foundation then uses these contributions to assist OpenBSD's
infrastructure needs. Contact the foundation directors at
directors@openbsdfoundation.org for more information.

------------------------------------------------------------------------
- T-SHIRT SALES --------------------------------------------------------

The OpenBSD distribution companies also sell tshirts and polo shirts.
And our users like them, too. We have a variety of shirts available,
with the new and old designs, from our web ordering system at, as
described above.

-----------------------------------------------------------------------
- FTP INSTALLS ---------------------------------------------------------

If you choose not to buy an OpenBSD CD-ROM, OpenBSD can be easily
installed via FTP or HTTP downloads. Typically you need a single
small piece of boot media (e.g., a boot floppy) and then the rest
of the files can be installed from a number of locations, including
directly off the Internet. Follow this simple set of instructions
to ensure that you find all of the documentation you will need
while performing an install via FTP or HTTP. With the CD-ROMs,
the necessary documentation is easier to find.

1) Read either of the following two files for a list of ftp/http
mirrors which provide OpenBSD, then choose one near you:

http://www.OpenBSD.org/ftp.html
ftp://ftp.OpenBSD.org/pub/OpenBSD/5.0/ftplist

As of Nov 1, 2011, the following ftp mirror sites have the 5.0 release:

ftp://ftp.eu.openbsd.org/pub/OpenBSD/5.0/ Stockholm, Sweden
ftp://ftp.bytemine.net/pub/OpenBSD/5.0/ Oldenburg, Germany
ftp://ftp.ch.openbsd.org/pub/OpenBSD/5.0/ Zurich, Switzerland
ftp://ftp.fr.openbsd.org/pub/OpenBSD/5.0/ Paris, France
ftp://ftp5.eu.openbsd.org/pub/OpenBSD/5.0/ Vienna, Austria
ftp://mirror.aarnet.edu.au/pub/OpenBSD/5.0/ Brisbane, Australia
ftp://ftp.usa.openbsd.org/pub/OpenBSD/5.0/ CO, USA
ftp://ftp5.usa.openbsd.org/pub/OpenBSD/5.0/ CA, USA
ftp://obsd.cec.mtu.edu/pub/OpenBSD/5.0/ Michigan, USA

The release is also available at the master site:

ftp://ftp.openbsd.org/pub/OpenBSD/5.0/ Alberta, Canada

However it is strongly suggested you use a mirror.

Other mirror sites may take a day or two to update.

2) Connect to that ftp mirror site and go into the directory
pub/OpenBSD/5.0/ which contains these files and directories.
This is a list of what you will see:

ANNOUNCEMENT armish/ mvme68k/ sparc64/
Changelogs/ ftplist mvme88k/ src.tar.gz
HARDWARE hp300/ packages/ sys.tar.gz
PACKAGES hppa/ ports.tar.gz tools/
PORTS i386/ root.mail vax/
README landisk/ sgi/ xenocara.tar.gz
alpha/ mac68k/ socppc/ zaurus/
amd64/ macppc/ sparc/

It is quite likely that you will want at LEAST the following
files which apply to all the architectures OpenBSD supports.

README - generic README
HARDWARE - list of hardware we support
PORTS - description of our "ports" tree
PACKAGES - description of pre-compiled packages
root.mail - a copy of root's mail at initial login.
(This is really worthwhile reading).

3) Read the README file. It is short, and a quick read will make
sure you understand what else you need to fetch.

4) Next, go into the directory that applies to your architecture,
for example, i386. This is a list of what you will see:

INSTALL.i386 cd50.iso floppyB50.fs pxeboot*
INSTALL.linux cdboot* floppyC50.fs xbase50.tgz
MD5 cdbr* game50.tgz xetc50.tgz
base50.tgz cdemu50.iso index.txt xfont50.tgz
bsd* comp50.tgz install50.iso xserv50.tgz
bsd.mp* etc50.tgz man50.tgz xshare50.tgz
bsd.rd* floppy50.fs misc50.tgz

If you are new to OpenBSD, fetch _at least_ the file INSTALL.i386
and the appropriate floppy*.fs or install50.iso files. Consult the
INSTALL.i386 file if you don't know which of the floppy images
you need (or simply fetch all of them).

If you use the install50.iso file (roughly 250MB in size), then you
do not need the various *.tgz files since they are contained on that
one-step ISO-format install CD.

5) If you are an expert, follow the instructions in the file called
README; otherwise, use the more complete instructions in the
file called INSTALL.i386. INSTALL.i386 may tell you that you
need to fetch other files.

6) Just in case, take a peek at:

http://www.OpenBSD.org/errata.html

This is the page where we talk about the mistakes we made while
creating the 5.0 release, or the significant bugs we fixed
post-release which we think our users should have fixes for.
Patches and workarounds are clearly described there.

Note: If you end up needing to write a raw floppy using Windows,
you can use "fdimage.exe" located in the pub/OpenBSD/5.0/tools
directory to do so.

------------------------------------------------------------------------
- X.ORG FOR MOST ARCHITECTURES -----------------------------------------

X.Org has been integrated more closely into the system. This release
contains X.Org 7.6. Most of our architectures ship with X.Org, including
amd64, sparc, sparc64 and macppc. During installation, you can install
X.Org quite easily. Be sure to try out xdm(1) and see how we have
customized it for OpenBSD.

------------------------------------------------------------------------
- PORTS TREE -----------------------------------------------------------

The OpenBSD ports tree contains automated instructions for building
third party software. The software has been verified to build and
run on the various OpenBSD architectures. The 5.0 ports collection,
including many of the distribution files, is included on the 3-CD
set. Please see the PORTS file for more information.

Note: some of the most popular ports, e.g., the Apache web server
and several X applications, come standard with OpenBSD. Also, many
popular ports have been pre-compiled for those who do not desire
to build their own binaries (see BINARY PACKAGES, below).

------------------------------------------------------------------------
- BINARY PACKAGES WE PROVIDE -------------------------------------------

A large number of binary packages are provided. Please see the PACKAGES
file (ftp://ftp.OpenBSD.org/pub/OpenBSD/5.0/PACKAGES) for more details.

------------------------------------------------------------------------
- SYSTEM SOURCE CODE ---------------------------------------------------

The CD-ROMs contain source code for all the subsystems explained
above, and the README (ftp://ftp.OpenBSD.org/pub/OpenBSD/5.0/README)
file explains how to deal with these source files. For those who
are doing an FTP install, the source code for all four subsystems
can be found in the pub/OpenBSD/5.0/ directory:

xenocara.tar.gz ports.tar.gz src.tar.gz sys.tar.gz

------------------------------------------------------------------------
- THANKS ---------------------------------------------------------------

Ports tree and package building by Jasper Lievisse Adriaanse,
Landry Breuil, Michael Erdely, Stuart Henderson, Peter Hessler,
Paul Irofti, Antoine Jacoutot, Robert Nagy, and Christian Weisgerber.
System builds by Theo de Raadt, Mark Kettenis, and Miod Vallat.
X11 builds by Todd Fries and Miod Vallat. ISO-9660 filesystem
layout by Theo de Raadt.

We would like to thank all of the people who sent in bug reports, bug
fixes, donation cheques, and hardware that we use. We would also like
to thank those who pre-ordered the 5.0 CD-ROM or bought our previous
CD-ROMs. Those who did not support us financially have still helped
us with our goal of improving the quality of the software.

Our developers are:

Alexander Bluhm, Alexander Hall, Alexander Schrijver,
Alexander Yurchenko, Alexandr Shadchin, Alexandre Ratchov,
Anil Madhavapeddy, Anthony J. Bentley, Antoine Jacoutot,
Ariane van der Steldt, Austin Hook, Benoit Lecocq, Bernd Ahlers,
Bob Beck, Bret Lambert, Charles Longeau, Chris Kuethe,
Christian Weisgerber, Christiano F. Haesbaert, Claudio Jeker,
Dale Rahn, Damien Bergamini, Damien Miller, Darren Tucker,
David Coppa, David Gwynne, David Hill, David Krause, Edd Barrett,
Eric Faurot, Federico G. Schwindt, Felix Kronlage, Gilles Chehade,
Giovanni Bechis, Gleydson Soares, Henning Brauer, Ian Darwin,
Igor Sobrado, Ingo Schwarze, Jacek Masiulaniec, Jakob Schlyter,
Janne Johansson, Jason George, Jason McIntyre, Jason Meltzer,
Jasper Lievisse Adriaanse, Jeremy Evans, Jim Razmus II, Joel Sing,
Joerg Zinke, Jolan Luff, Jonathan Armani, Jonathan Gray,
Jonathan Matthew, Jordan Hargrave, Joshua Stein,
Kenneth R Westerback, Kevin Lo, Kevin Steves, Kurt Miller,
Landry Breuil, Laurent Fanis, Marc Espie, Marco Peereboom,
Marco Pfatschbacher, Marcus Glocker, Mark Kettenis, Mark Lumsden,
Mark Uemura, Markus Friedl, Martin Pieuchot, Martynas Venckus,
Mats O Jansson, Matthew Dempsky, Matthias Kilian, Matthieu Herrb,
Michael Erdely, Mike Belopuhov, Mike Larkin, Miod Vallat,
Nayden Markatchev, Nicholas Marriott, Nick Holland, Nigel Taylor,
Nikolay Sturm, Okan Demirmen, Otto Moerbeek, Owain Ainsworth,
Paul de Weerd, Paul Irofti, Peter Hessler, Peter Valchev,
Philip Guenther, Pierre-Emmanuel Andre, Pierre-Yves Ritschard,
Remi Pointel, Reyk Floeter, Robert Nagy, Ryan Freeman,
Ryan Thomas McBride, Sasano, Sebastian Reitenbach, Simon Bertrang,
Stefan Sperling, Stephan A. Rickauer, Steven Mestdagh,
Stuart Henderson, Takuya Asada, Ted Unangst, Theo de Raadt,
Thordur I Bjornsson, Tobias Weingartner, Todd C. Miller, Todd Fries,
Will Maier, William Yodlowsky, Yasuoka Masahiko, Yojiro Uo