Chapter 19. Contributing to FreeBSD

Table of Contents
19.1. What is Needed
19.2. How to Contribute
19.3. Donors Gallery
19.4. Core Team Alumni
19.5. Derived Software Contributors
19.6. Additional FreeBSD Contributors
19.7. 386BSD Patch Kit Patch Contributors

Contributed by Jordan K. Hubbard .

So you want to contribute something to FreeBSD? That is great! We can always use the help, and FreeBSD is one of those systems that relies on the contributions of its user base in order to survive. Your contributions are not only appreciated, they are vital to FreeBSD's continued growth!

Contrary to what some people might also have you believe, you do not need to be a hot-shot programmer or a close personal friend of the FreeBSD core team in order to have your contributions accepted. The FreeBSD Project's development is done by a large and growing number of international contributors whose ages and areas of technical expertise vary greatly, and there is always more work to be done than there are people available to do it.

Since the FreeBSD project is responsible for an entire operating system environment (and its installation) rather than just a kernel or a few scattered utilities, our TODO list also spans a very wide range of tasks, from documentation, beta testing and presentation to highly specialized types of kernel development. No matter what your skill level, there is almost certainly something you can do to help the project!

Commercial entities engaged in FreeBSD-related enterprises are also encouraged to contact us. Need a special extension to make your product work? You will find us receptive to your requests, given that they are not too outlandish. Working on a value-added product? Please let us know! We may be able to work cooperatively on some aspect of it. The free software world is challenging a lot of existing assumptions about how software is developed, sold, and maintained throughout its life cycle, and we urge you to at least give it a second look.

19.1. What is Needed

The following list of tasks and sub-projects represents something of an amalgam of the various core team TODO lists and user requests we have collected over the last couple of months. Where possible, tasks have been ranked by degree of urgency. If you are interested in working on one of the tasks you see here, send mail to the coordinator listed by clicking on their names. If no coordinator has been appointed, maybe you would like to volunteer?

19.1.1. High priority tasks

The following tasks are considered to be urgent, usually because they represent something that is badly broken or sorely needed:

  1. 3-stage boot issues. Overall coordination: FreeBSD technical discussions mailing list

    • Do WinNT compatible drive tagging so that the 3rd stage can provide an accurate mapping of BIOS geometries for disks.

  2. Filesystem problems. Overall coordination: FreeBSD filesystem project mailing list

    • Clean up and document the nullfs filesystem code. Coordinator: Eivind Eklund

    • Fix the union file system. Coordinator: David Greenman

  3. Implement Int13 vm86 disk driver. Coordinator: FreeBSD technical discussions mailing list

  4. New bus architecture. Coordinator: New Bus Architecture mailing list

    • Port existing ISA drivers to new architecture.

    • Move all interrupt-management code to appropriate parts of the bus drivers.

    • Port PCI subsystem to new architecture. Coordinator: Doug Rabson

    • Figure out the right way to handle removable devices and then use that as a substrate on which PC-Card and CardBus support can be implemented.

    • Resolve the probe/attach priority issue once and for all.

    • Move any remaining buses over to the new architecture.

  5. Kernel issues. Overall coordination: FreeBSD technical discussions mailing list

  6. Add more pro-active security infrastructure. Overall coordination: FreeBSD security mailing list

    • Build something like Tripwire(TM) into the kernel, with a remote and local part. There are a number of cryptographic issues to getting this right; contact the coordinator for details. Coordinator: Eivind Eklund

    • Make the entire kernel use suser() instead of comparing to 0. It is presently using about half of each. Coordinator: Eivind Eklund

    • Split securelevels into different parts, to allow an administrator to throw away those privileges he can throw away. Setting the overall securelevel needs to have the same effect as now, obviously. Coordinator: Eivind Eklund

    • Make it possible to upload a list of ``allowed program'' to BPF, and then block BPF from accepting other programs. This would allow BPF to be used e.g. for DHCP, without allowing an attacker to start snooping the local network.

    • Update the security checker script. We should at least grab all the checks from the other BSD derivatives, and add checks that a system with securelevel increased also have reasonable flags on the relevant parts. Coordinator: Eivind Eklund

    • Add authorization infrastructure to the kernel, to allow different authorization policies. Part of this could be done by modifying suser(). Coordinator: Eivind Eklund

    • Add code to the NFS layer so that you cannot chdir("..") out of an NFS partition. E.g., /usr is a UFS partition with /usr/src NFS exported. Now it is possible to use the NFS filehandle for /usr/src to get access to /usr.

19.1.2. Medium priority tasks

The following tasks need to be done, but not with any particular urgency:

  1. Full KLD based driver support/Configuration Manager.

    • Write a configuration manager (in the 3rd stage boot?) that probes your hardware in a sane manner, keeps only the KLDs required for your hardware, etc.

  2. PCMCIA/PCCARD. Coordinators: Michael Smith and Warner Losh

    • Documentation!

    • Reliable operation of the pcic driver (needs testing).

    • Recognizer and handler for sio.c (mostly done).

    • Recognizer and handler for ed.c (mostly done).

    • Recognizer and handler for ep.c (mostly done).

    • User-mode recognizer and handler (partially done).

  3. Advanced Power Management. Coordinators: Michael Smith and Poul-Henning Kamp

    • APM sub-driver (mostly done).

    • IDE/ATA disk sub-driver (partially done).

    • syscons/pcvt sub-driver.

    • Integration with the PCMCIA/PCCARD drivers (suspend/resume).

19.1.3. Low priority tasks

The following tasks are purely cosmetic or represent such an investment of work that it is not likely that anyone will get them done anytime soon:

The first N items are from Terry Lambert

  1. NetWare Server (protected mode ODI driver) loader and sub-services to allow the use of ODI card drivers supplied with network cards. The same thing for NDIS drivers and NetWare SCSI drivers.

  2. An "upgrade system" option that works on Linux boxes instead of just previous rev FreeBSD boxes.

  3. Symmetric Multiprocessing with kernel preemption (requires kernel preemption).

  4. A concerted effort at support for portable computers. This is somewhat handled by changing PCMCIA bridging rules and power management event handling. But there are things like detecting internal v.s.. external display and picking a different screen resolution based on that fact, not spinning down the disk if the machine is in dock, and allowing dock-based cards to disappear without affecting the machines ability to boot (same issue for PCMCIA).

19.1.4. Smaller tasks

Most of the tasks listed in the previous sections require either a considerable investment of time or an in-depth knowledge of the FreeBSD kernel (or both). However, there are also many useful tasks which are suitable for "weekend hackers", or people without programming skills.

  1. If you run FreeBSD-current and have a good Internet connection, there is a machine which builds a full release once a day -- every now and again, try and install the latest release from it and report any failures in the process.

  2. Read the freebsd-bugs mailing list. There might be a problem you can comment constructively on or with patches you can test. Or you could even try to fix one of the problems yourself.

  3. Read through the FAQ and Handbook periodically. If anything is badly explained, out of date or even just completely wrong, let us know. Even better, send us a fix (SGML is not difficult to learn, but there is no objection to ASCII submissions).

  4. Help translate FreeBSD documentation into your native language (if not already available) -- just send an email to FreeBSD documentation project mailing list asking if anyone is working on it. Note that you are not committing yourself to translating every single FreeBSD document by doing this -- in fact, the documentation most in need of translation is the installation instructions.

  5. Read the freebsd-questions mailing list and the comp.unix.bsd.freebsd.misc newsgroup occasionally (or even regularly). It can be very satisfying to share your expertise and help people solve their problems; sometimes you may even learn something new yourself! These forums can also be a source of ideas for things to work on.

  6. If you know of any bug fixes which have been successfully applied to -current but have not been merged into -stable after a decent interval (normally a couple of weeks), send the committer a polite reminder.

  7. Move contributed software to src/contrib in the source tree.

  8. Make sure code in src/contrib is up to date.

  9. Look for year 2000 bugs (and fix any you find!)

  10. Build the source tree (or just part of it) with extra warnings enabled and clean up the warnings.

  11. Fix warnings for ports which do deprecated things like using gets() or including malloc.h.

  12. If you have contributed any ports, send your patches back to the original author (this will make your life easier when they bring out the next version)

  13. Suggest further tasks for this list!

19.1.5. Work through the PR database

The FreeBSD PR list shows all the current active problem reports and requests for enhancement that have been submitted by FreeBSD users. Look through the open PRs, and see if anything there takes your interest. Some of these might be very simple tasks, that just need an extra pair of eyes to look over them and confirm that the fix in the PR is a good one. Others might be much more complex.

Start with the PRs that have not been assigned to anyone else, but if one them is assigned to someone else, but it looks like something you can handle, e-mail the person it is assigned to and ask if you can work on it--they might already have a patch ready to be tested, or further ideas that you can discuss with them.

For questions about FreeBSD, e-mail <>.
For questions about this documentation, e-mail <>.