ALTQ integration in FreeBSD project

Project Goal

Integration of the ALTQ QoS framework into FreeBSD.

Project Plan

As the FreeBSD Core Team concluded that the integration into 4.x would be too disruptive, they decided that the ALTQ integration will take place into FreeBSD 5.0-current. We hope that after ALTQ will make its way into -current and prove its maturity, there may be a chance to merge it back into 4.x-stable (though this might break binary compatibility for the network device drivers distributed in binary form only).

Original work done by Kenjiro Cho <kjc (at) csl.sony.co.jp>, updates by Adrian Penisoara <ady (at) freebsd.ady.ro>.

Update: The ALTQ framework has been imported in the FreeBSD tree on June 12th 2004. See the FreeBSD May-June 2004 Status Report.

How to Contribute

If you would like to help us or just take a peek at the project's development, you should subscribe to the freebsd-altq mailing list. You can do that by sending an empty message to freebsd-altq+subscribe (at) rofug.ro. The messages posted on the list are archived online here.

Patches and tarballs

Here are a few bits available for download:

altq-freebsd-5.2-release-beta2.tar.gz [216Kb], MD5: 7bddb0ff3564cc03c180b5f10286db2e: Proposed ALTQ package against FreeBSD 5.2-RELEASE (RELENG_5_2 branch). Changelog
altq-freebsd-5.2-release-beta1.tar.gz [216Kb], MD5: e5fe2b0537db0ff51b0086153be207e9: Proposed ALTQ package against FreeBSD 5.2-RELEASE (RELENG_5_2 branch). Changelog
sys-altq-freebsd-4.9-RELEASE.patch.gz [50Kb]: src/sys ALTQ patches for FreeBSD 4.9-[PRE]RELEASE. Use this patchset instead of the stock sys-altq-freebsd-4.5.patch patchset contained in the official altq 3.1 package. It should work for the final FreeBSD 4.9-RELEASE as no critical changes should occur until release time. Don't forget the "-p0" argument for patch.
Warning: Not fully tested. Use with care!
altq-freebsd-5.0-release.tar.gz (rev. 2) [208Kb]: Proposed ALTQ package against FreeBSD 5.0-RELEASE.
Warning: This package has not been thouroughly tested. Use with care!
sys-altq-freebsd-4.8-RELEASE.patch.gz (rev. 2) [50Kb]: src/sys ALTQ patches for FreeBSD 4.8-[PRE]RELEASE. Use this patchset instead of the stock sys-altq-freebsd-4.5.patch patchset contained in the official altq 3.1 package. It should work for the final FreeBSD 4.8-RELEASE as no critical changes should occur until release time. Don't forget the "-p0" argument for patch.
Warning: This patchset contains some critical changes in the bridging and Ethernet output code that have not been thouroughly tested. Use with care!
sys-altq-freebsd-4.6-STABLE-24Aug2002.diff.gz [49Kb]: src/sys ALTQ patches against 4.6-STABLE sources as of 24th August 2002. Use this instead of the sys-altq-freebsd-4.5.patch patchset coming with the official altq 3.1 package to make it work on a FreeBSD 4.6-STABLE system. Don't forget the "-p0" argument for patch.
Warning: This patchset contains some critical changes in the bridging and Ethernet output code and it hasn't yet been thouroughly tested. Use with care!
altq-freebsd-5.0-current-Jul10.tar.gz [194Kb]: Proposed ALTQ package against FreeBSD 5.0-current as of 10th July 2002 (should work on more recent sources too).
sys-altq-freebsd-4.6-RELEASE.diff.gz [49Kb]: src/sys ALTQ patches against the latest 4.6-RC/RELEASE sources. Use this instead of the sys-altq-freebsd-4.5.patch patchset coming with the official altq 3.1 package to make it work on a FreeBSD 4.6-RELEASE system. Don't forget the "-p0" argument for patch.
altq-freebsd-5.0-current-May14.tar.gz [246Kb]: Proposed ALTQ package against 5.0-current as of 14th May 2002
altq-freebsd-5.0-dp1-0.1.tar.gz [248Kb]: Proposed ALTQ package against FreeBSD 5.0 Developer Preview 1 (DP1)
altq-3.1.tar.gz [520Kb]: ALTQ 3.1 package for FreeBSD 4.5-RELEASE (mirrored from the ALTQ webpage)
It should work on more recent FreeBSD 4.x sources with updated src/sys patches.

Resources and Links

ALTQ homepage
FreeBSD website
FreeBSD-ALTQ mailing list archive
OpenBSD pf ported to FreeBSD — "a first shot at altq-support with pf-classification"
KernelTrap: Porting the PF Stateful Packet Filter — contains some notes on merging the ALTQ package with PF in OpenBSD 3.3

Status board

Task	Scheduled	Last Update	Status
FreeBSD 5.0-current integration
Prepare `src/sys/altq` and `src/sys/modules/altq` patchset for -current tree			NOT Scheduled
Build & send for reviewing and approval a minimal patchset for `src/sys`			NOT Scheduled
Import the `src/sys/altq` and `src/sys/modules/altq` stuff in the -current tree			NOT Scheduled
Commit the minimal `src/sys` patchset			NOT Scheduled
Commit a few important network driver modifications (loopback, tun, (s)ppp, ATM, etc)			NOT Scheduled
Commit the userland (libaltq & binaries)			NOT Scheduled
Start changing all network drivers (or at least the majority)			NOT Scheduled
Integrate ALTQ configuration and startup stuff in `/etc`			NOT Scheduled
Reinforce the default ALTQ queueing policy for the network drivers			NOT Scheduled
FreeBSD 4.x-stable MFC
Evaluate the possibility of integrating ALTQ in 4.x-stable			NOT Scheduled

Future development

Add a class attribute field to struct mbuf to support class attribute tagging for packets and place the classifier within ip_output. The attribute tagging mechanism should be generic enough for other parts in the kernel to take advantage of it too.
Make ipfw(8) support packet tagging and classify packets for ALTQ queueing disciplines.

News

December 1st 2005

Updated/added some informational bits to reflect reality (Ady).

January 16th 2004

Released second beta package for FreeBSD 5.2-RELEASE (Ady).

January 12th 2004

Released a package for FreeBSD 5.2-RELEASE (RELENG_5_2) (Ady).

October 16th 2003

Released a patchset for FreeBSD 4.9-[PRE]RELEASE (Ady).
Cleaned up the schedule table, it was stalling anyway.

01 April 2003

Updated the 5.0-RELEASE ALTQ package -- small fix for bridging code compilation(Ady)

31 March 2003

Released ALTQ package for FreeBSD 5.0-RELEASE (Ady).

26 February 2003

Updated the 4.8-[PRE]RELEASE patchset -- small fix for bridging code compilation (Ady).

23 February 2003

Released a patchset for FreeBSD 4.8-[PRE]RELEASE (Ady).

25 August 2002

Built a patchset for FreeBSD 4.6-STABLE as of 24th August and made it available for download (Ady).

11 July 2002

ALTQ package for FreeBSD 5.0-current as of 10th July made available.

21 June 2002

Scheduled actions in the Status board; added a new entry.
Re-scheduled as per Kenjiro's suggestions.

07 June 2002

Rebuilt the sys-altq patches for FreeBSD 4.6-RC/RELEASE (path adjustment).

06 June 2002

sys-altq patches for FreeBSD 4.6-RC/RELEASE made available.

06 June 2002

This web page was created.

The original layout for this web page was borrowed from the FreeBSD C99 & POSIX Conformance Project (which in turn borrowed their layout from the FreeBSD SMPng Project).

Last modified: $Date: 2005/12/01 17:52:41 $