NetBSD Problem Report #11172

Received: (qmail 11015 invoked from network); 8 Oct 2000 22:29:33 -0000
Message-Id: <200010082229.e98MTWZ05464@sam.few.eur.nl>
Date: Mon, 9 Oct 2000 00:29:32 +0200 (MEST)
From: Paul Kranenburg <pk@sam.few.eur.nl>
Reply-To: pk@netbsd.org
To: gnats-bugs@gnats.netbsd.org
Subject: the `heimdal' krb5 library documentation is severely lacking
X-Send-Pr-Version: 3.95

>Number:         11172
>Category:       lib
>Synopsis:       the `heimdal' krb5 library documentation is severely lacking
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    lib-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sun Oct 08 22:30:00 +0000 2000
>Closed-Date:    
>Last-Modified:  Tue Apr 14 20:45:47 +0000 2009
>Originator:     Paul Kranenburg
>Release:        NetBSD-current & NetBSD 1.5ALPHA
>Organization:

>Environment:

System: NetBSD sam 1.5E NetBSD 1.5E (SAM) #74: Sun Sep 10 00:35:00 MEST 2000 pk@sam:/usr/src/sys/arch/sparc/compile/SAM sparc


>Description:
	There is virtually no documentation on the heimdal kerberos V
	implementation as currently distributed with NetBSD. In section
	3 of manual pages only a few (and, as it seems to me, randomly
	chosen) functions are described.

	Also notably missing is an overview of the API provided by the
	heimdal libraries, which makes it difficult to start writing
	applications that want to incorporate kerberos functionality.

	The absence of such docs also makes it difficult for developers
	to work on the libraries, as it is hard to find out whether
	bug fixes and/or other changes will affect programming interface.
>How-To-Repeat:
	Spot a bug in the library and wonder whether a possible fix which
	involves changing a function signature would be acceptable.
>Fix:
	Provide an Application Programming Interface overview document
	and supply a section 3 entry for each item in it.

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: lib-bug-people->assar 
Responsible-Changed-By: fair 
Responsible-Changed-When: Sun Jan 13 00:32:39 PST 2002 
Responsible-Changed-Why:  
Assar is our Heimdal expert. 
Responsible-Changed-From-To: assar->lha 
Responsible-Changed-By: fair 
Responsible-Changed-When: Tue May 25 00:53:10 UTC 2004 
Responsible-Changed-Why:  

Assar has gone inactive, so this goes to our current Kerberos expert. 

Responsible-Changed-From-To: lha->lib-bug-people
Responsible-Changed-By: spz@NetBSD.org
Responsible-Changed-When: Tue, 14 Apr 2009 20:45:47 +0000
Responsible-Changed-Why:
lha is status observer now and thus can't fix this


>Unformatted:

Home	PR Database Search