Bug 1143767

Summary: [docs] Kerberos manpages for { krb5kdc, kadmin, kadmin.local, kdb5_util, ... } lack description of environment variables
Product: [Fedora] Fedora Reporter: Roland Mainz <rmainz>
Component: krb5Assignee: Robbie Harwood <rharwood>
Status: CLOSED RAWHIDE QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: rawhideCC: dpal, kerberos-dev-list, nalin, nathaniel, pkis, ssorce
Target Milestone: ---Keywords: FutureFeature, Reopened
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
URL: https://github.com/krb5/krb5/pull/861
Whiteboard:
Fixed In Version: krb5-1.16.1-25.fc30 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 1643433 (view as bug list) Environment:
Last Closed: 2018-10-24 19:07:51 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1643433, 1704726    

Description Roland Mainz 2014-09-17 23:33:51 UTC
Description of problem:
While working on test infrastructure for Kerberos5 I came across a weired error:
-- snip --
kadmin.local:  Couldn't open log file /var/log/kadmind.log: Permission denied
-- snip --
At first this was confusing because I have a custom KRB5_KDC_PROFILE which explicitly use a script-defined location for such logs and not /var/log/ ...
... after some digging someone on IRC pointed out that kadmin/kadmind and other tools also source KRB5_CONFIG ... or if not present the default location /etc/krb5.conf ... which contained such a reference.
Problem is... this is not documented in the manpage.

Proposed fix:
Add a section "ENVIRONMENT" (like the POSIX manual pages have) to the manpages of the affected utilities (e.g. krb5kdc, kadmin, kadmin.local, kdb5_util, etc.) which lists the environment variables { KRB5_KDC_PROFILE, KRB5_CONFIG, ... }, the order in which they are sourced and the builtin default values if the variables are not set.

Comment 2 Roland Mainz 2014-10-10 16:50:17 UTC
Over to "Fedora" product per dpal's comments ...

Comment 3 Jaroslav Reznik 2015-03-03 16:18:29 UTC
This bug appears to have been reported against 'rawhide' during the Fedora 22 development cycle.
Changing version to '22'.

More information and reason for this action is here:
https://fedoraproject.org/wiki/Fedora_Program_Management/HouseKeeping/Fedora22

Comment 4 Fedora Admin XMLRPC Client 2015-09-01 21:35:54 UTC
This package has changed ownership in the Fedora Package Database.  Reassigning to the new owner of this component.

Comment 6 Fedora End Of Life 2016-07-19 12:08:50 UTC
Fedora 22 changed to end-of-life (EOL) status on 2016-07-19. Fedora 22 is
no longer maintained, which means that it will not receive any further
security or bug fix updates. As a result we are closing this bug.

If you can reproduce this bug against a currently maintained version of
Fedora please feel free to reopen this bug against that version. If you
are unable to reopen this bug, please file a new report against the
current release. If you experience problems, please add a comment to this
bug.

Thank you for reporting this bug and we are sorry it could not be fixed.

Comment 7 Robbie Harwood 2017-02-15 03:37:45 UTC
Y'know, we never actually fixed this...

Comment 8 Fedora End Of Life 2017-02-28 09:37:55 UTC
This bug appears to have been reported against 'rawhide' during the Fedora 26 development cycle.
Changing version to '26'.