logo_kerberos.gif

Difference between revisions of "Developer resources"

From K5Wiki
Jump to: navigation, search
(Source code: Add git-svn mirror info.)
 
(8 intermediate revisions by 2 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.7 [http://web.mit.edu/kerberos/krb5-1.7/#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!)
 
* [[Plugin development]] notes, pointers, tips, etc (needed!)
Line 13: 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 20: Line 20:
 
==Source code==
 
==Source code==
   
The MIT Kerberos sources are in a [[Subversion]] repository.
 
  +
* [[Getting source code]]
 
=== 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 ===
 
 
* [http://src.mit.edu/fisheye/browse/krb5 FishEye] provides 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-->
 
* 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==
 
==Bug tracking==
Line 48: Line 30:
 
== Instant messaging ==
 
== Instant messaging ==
   
[[IRC and Jabber]]
 
  +
[[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 16: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.