Bug 140239

Summary: Request for manpage doc change in hostname
Product: [Fedora] Fedora Reporter: Kim Lux <lux>
Component: net-toolsAssignee: Radek Vokál <rvokal>
Status: CLOSED ERRATA QA Contact: Ben Levenson <benl>
Severity: medium Docs Contact:
Priority: medium    
Version: 3CC: rvokal
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: RHBA-2005-242 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2004-11-25 14:05:59 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Kim Lux 2004-11-21 17:13:25 UTC
Description of problem: 
 
Current hostname manpage doc is misleading. 
 
Version-Release number of selected component (if applicable): 
 
 
 
From manpage: net-tools  28 Jan 1996 HOSTNAME(1) 
 
rpm -q net-tools net-tools-1.60-37 
 
 
How reproducible: 
 
 
Always.  
 
 
Steps to Reproduce: 
1. hostname <mynewhostname> 
2. reboot 
3.  
   
Actual results: 
 
hostname will be localhost.  
 
Expected results: 
 
hostname should be <mynewhostname> 
 
OR we should change the hostname documentation so that people don't 
think it changed the hostname permanently.  
 
Additional info: 
 
I know that one must change /etc/sysconfig/network and /etc/hosts to 
get a new properly working hostname.  Either we should change how 
hostname works on RH installations OR we should change the manpage to 
tell people that it doesn't work on RH machines OR we should leave 
hostname (and other functions/options that don't work properly) out 
of RH machines.  
 
To have a manpage that is wrong is the worst sin as far as I am 
concerned.

Comment 1 Radek Vokál 2004-11-22 10:30:46 UTC
hostname just calls sethostname(const char *name, size_t len) for
setting the name and doesn't touch the conf files itself. I'm
reassigning this to glibc for futher comments. 

Comment 2 Radek Vokál 2004-11-22 10:39:51 UTC
One additional comment that also can suit here. If you change the
hostname in s-c-network it does not automatically change your
/etc/hosts! If the new hostname does not resolv to a IP address
through DNS or /etc/hosts, it is added to localhost.

Comment 5 Radek Vokál 2004-11-25 14:05:59 UTC
Fixed in net-tools-1.60-41. Note into man page added. 

Comment 6 Kim Lux 2004-11-25 14:51:28 UTC
Thanks for making this change.  I'm impressed that it was given
consideration and acted on.

Comment 7 John Flanagan 2005-04-28 15:36:44 UTC
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on the solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.

http://rhn.redhat.com/errata/RHBA-2005-052.html


Comment 8 Tim Powers 2005-05-19 18:48:35 UTC
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on the solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.

http://rhn.redhat.com/errata/RHBA-2005-445.html