Difference between revisions of "Developer resources"

Revision as of 14:11, 18 March 2011

This page lists resources that developers use on a regular basis. One goal of the page is to help those beginning to track the project know what they may be interested in looking at.

Documentation

• The Installation Guide describes how to build and install MIT Kerberos.
• The 1.7 documentation site contains administrator and user documentation; while not directly targeted at developers, this documentation helps understand the product.
• Unfortunately there is no stable web pointer to the current version of MIT Kerberos documentation; as such the above links will eventually point to outdated documentation.
• The Glossary is a quick index of acronyms and terms related to Kerberos, which you may come across while reading the code.
• Plugin development notes, pointers, tips, etc (needed!)

Mailing lists

Much of the discussion of new proposals, discussion of what direction to take the product and answering of questions takes place on mailing lists.

• krbdev@mit.edu is the primary list for developers of MIT Kerberos.
• kfwdev@mit.edu serves a similar purpose for Kerberos for Windows.
• cvs-krb5@mit.edu receives all Subversion commit messages and allows developers to track all changes made to MIT Kerberos.
• krb5-bugs@mit.edu is notified when a ticket is created or updated. This list helps track bugs and feature requests.
• krbcore@mit.edu is a private list for Krbcore; send mail to this list if you need to contact the core team.
• krbcore-security@mit.edu is the point of contact for security problems with MIT Kerberos.

Source code

The MIT Kerberos sources are in a Subversion repository.

Subversion repository access

• svn://anonsvn.mit.edu/krb5 provides read-only Subversion access to the repository.
• Committers have access to a URI that allows them to commit changes to the repository.

Repository browsing

• FishEye provides a feature-rich view of the repository
• OpenGrok provides an interface that allows you to search for the definition or usage of a specific function; it is somewhat better for cross references than FishEye.
• http://anonsvn.mit.edu/viewvc/krb5 provides a more basic form of web access to the entire repository.
• See the Github mirror information below for another browsing alternative.

Git-svn mirror

• git://krbdev.mit.edu/git/krb5-anonsvn is a git-svn mirror of the anonsvn repository.
• https://github.com/tlyu/krb5-anonsvn is a temporary Github repository that mirrors the krb5-anonsvn repository. It will move to a more permanent location later. Please do not fork it within Github. The web interface allows for repository browsing, and also displays URLs for git access using both native git protocol and HTTPS (for firewall traversal, etc.).

Bug tracking

• http://krbdev.mit.edu/rt/ is the interface to the bug tracking server.
• Log in with user name guest and password guest. (or use the guest login button)
• See doc/procedures.txt (raw | annotated | history) for some information on bug states.

Instant messaging

IRC and Jabber

Lore

You may find relevant accumulated lore in Category:Lore.