The world's most popular RADIUS Server.Instructions for Developers
As the name suggests, FreeRADIUS is developed under the GNU General Public License, Version 2 (GPLv2). We invite anyone to use and contribute code to the project. The following information should prove useful for potential contributors.
Using CVS
We use CVS to coordinate and manage our source code. Public anonymous access to the repository can be obtained with the username anoncvs and the password anoncvs by doing the following:
$ cvs -d :pserver:anoncvs@cvs.freeradius.org:/source login CVS password: anoncvs $ cvs -d :pserver:anoncvs@cvs.freeradius.org:/source checkout module
where module is one of the following module names:
- radiusd
- The FreeRADIUS server daemon.
- pam_radius
- A Pluggable
Authentication Module that should work on Linux, FreeBSD,
and Solaris.
- mod_auth_radius
- An authentication module for the Apache HTTP Server Project.
Patches and contributions
If you're considering submitting a patch, please read the
doc/DIFFS file in the server distribution for
instructions, and also the bug tracking system. While
patches can be mail to the lists, we prefer that they be submitted
also via the online bug system.
The FTP site contains some additional patches that are specialized and haven't been applied to the tree.
- A contributions section, with patches to the Cistron server for Ascend data filters, SQL, and additional PAM functionality.
- A utilities section which may help in porting FreeRADIUS to additional platforms.
Development mailing list
We encourage everyone who might contribute code to join the FreeRADIUS development list. This list is highly technical and isn't for most users of the server. For normal discussion of the server and how to use it, there's a FreeRADIUS user-list. You should only subscribe to the development list if you are interested in writing software for the new server.
A CVS snapshot of the current development (possibly unstable) version is placed weekly on the CVS-snapshots/ sub-directory of the FTP site, but developers should use CVS.
Miscellaneous links
RADIUS RFC's and drafts: The two most important are RFC2865 and RFC2866. These are the new RFCs, which replace the old ones, RFC2138 and RFC2139
Related items: Other RADIUS servers, and more RADIUS information.
There are mirrors of the FTP site. See the mirrors web page for details.