logo_kerberos.gif

Difference between revisions of "Developer resources"

From K5Wiki
Jump to: navigation, search
 
(14 intermediate revisions by 3 users not shown)
Line 2: Line 2:
 
==Documentation==
 
==Documentation==
   
* The [http://web.mit.edu/kerberos/krb5-1.6/krb5-1.6.3/doc/krb5-install.html Installation Guide] describes how to build and install MIT Kerberos.
+
* [http://web.mit.edu/kerberos/krb5-current/doc/krb_build/index.html Building Kerberos V5] describes how to build and install MIT Kerberos.
* The 1.6 [http://web.mit.edu/kerberos/krb5-1.6/#documentation documentation site] contains administrator and user documentation; while not directly targeted at developers, this documentation helps understand the product.
+
* The [http://web.mit.edu/kerberos/krb5-current/doc/ documentation site] contains administrator and user documentation, and some information for developers; this documentation can help in understanding 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.
 
* 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==
 
==Mailing lists==
Line 12: Line 13:
 
* [http://mailman.mit.edu/mailman/listinfo/krbdev krbdev@mit.edu] is the primary list for developers of [[MIT Kerberos]].
 
* [http://mailman.mit.edu/mailman/listinfo/krbdev krbdev@mit.edu] is the primary list for developers of [[MIT Kerberos]].
 
* [http://mailman.mit.edu/mailman/listinfo/kfwdev kfwdev@mit.edu] serves a similar purpose for [[Kerberos for Windows]].
 
* [http://mailman.mit.edu/mailman/listinfo/kfwdev kfwdev@mit.edu] serves a similar purpose for [[Kerberos for Windows]].
* [http://mailman.mit.edu/mailman/listinfo/cvs-krb5 cvs-krb5@mit.edu] receives all [[Subversion]] commit messages and allows developers to track all changes made to MIT Kerberos.
+
* [http://mailman.mit.edu/mailman/listinfo/cvs-krb5 cvs-krb5@mit.edu] receives all krb5 commit messages and allows developers to track all changes made to MIT Kerberos.
  +
* [http://mailman.mit.edu/mailman/listinfo/krb5-appl-commits krb5-appl-commits@mit.edu] receives all krb5-appl commit messages and allows developers to track all changes made to the MIT Kerberos applications.
 
* [http://mailman.mit.edu/mailman/listinfo/krb5-bugs krb5-bugs@mit.edu] is notified when a [[ticket]] is created or updated. This list helps track bugs and feature requests.
 
* [http://mailman.mit.edu/mailman/listinfo/krb5-bugs 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@mit.edu is a private list for [[Krbcore]]; send mail to this list if you need to contact the core team.
Line 19: Line 20:
 
==Source code==
 
==Source code==
   
The MIT Kerberos sources are in a [[Subversion]] repository.
 
  +
* [[Getting source code]]
 
* svn://anonsvn.mit.edu/svn/krb5 provides read-only [[Subversion]] access to the repository.
 
* [http://src.mit.edu/fisheye/browse/krb5 FishEye] a feature-rich view of the repository
 
* [http://src.mit.edu/opengrok/ 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.
 
<!-- was /svn/krb5; pending ops installation of backwards compat link-->
 
* [[Committers]] have access to a URI that allows them to commit changes to the repository.
 
   
 
==Bug tracking==
 
==Bug tracking==
Line 34: Line 28:
 
* See {{trunkref|doc/procedures.txt}} for some information on bug states.
 
* See {{trunkref|doc/procedures.txt}} for some information on bug states.
   
==Jabber==
 
  +
== Instant messaging ==
   
The core team and some fairly active developers use a jabber room for instant message chat. The goal is to have kerberos developers around the world available to answers each others' questions and to engage in real-time design discussions. If you are a reasonably active developer and wish to join this chat, contact a core team member for details.
 
  +
[[Developer chat]]
   
 
== Lore ==
 
== Lore ==
   
 
You may find relevant accumulated lore in [[:Category:Lore]].
 
You may find relevant accumulated lore in [[:Category:Lore]].
  +
  +
== For committers ==
  +
  +
If you're a committer, you should also look at [[committer resources]] for additional information.

Latest revision as of 17:39, 6 December 2012

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

  • Building Kerberos V5 describes how to build and install MIT Kerberos.
  • The documentation site contains administrator and user documentation, and some information for developers; this documentation can help in understanding the product.
  • 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 krb5 commit messages and allows developers to track all changes made to MIT Kerberos.
  • krb5-appl-commits@mit.edu receives all krb5-appl commit messages and allows developers to track all changes made to the MIT Kerberos applications.
  • 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

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

Developer chat

Lore

You may find relevant accumulated lore in Category:Lore.

For committers

If you're a committer, you should also look at committer resources for additional information.