Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 270374 - Add example section to the manual for ifconfig
Summary: Add example section to the manual for ifconfig
Status: RESOLVED UPSTREAM
Alias: None
Product: Documentation
Classification: Unclassified
Component: Other (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: Gentoo's Team for Core System packages
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-05-19 05:24 UTC by Dmitri
Modified: 2009-05-21 01:03 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Dmitri 2009-05-19 05:24:40 UTC
sys-apps/net-tools <=1.60
would be nice to have and example section in the manual for ifconfig.
to show static and dinamic configuration of the interface.

Reproducible: Always

Steps to Reproduce:
man ifconfig

Actual Results:  
EXAMPLE section not exist

Expected Results:  
additional section near the bottom of the man page:
EXAMPLE
To activate interface with a static IP use
ifconfig [device] [my.static.ip.addr] netmask [my.net.work.mask] up
route add default gw [gate.way.ip.number]
 ifconfig eth0 192.168.0.5 netmask 255.255.255.0 up
 route add default gw 192.168.0.1

To activate an interface with a dynamic IP use
 ifconfig eth0 up
 [dhcp client] eth0

Since the ifconfig is the first command to see the network interface status, it would be logical to read the man for it, in case of any problems, and an example would provide quick reference on the spot to get the interface up and running.
Comment 1 Mike Auty (RETIRED) gentoo-dev 2009-05-20 23:10:49 UTC
My guess is this request would best be dealt with upstream.  You might want to investigate http://www.linuxfoundation.org/en/Net:Net-tools to see who to contact...
Comment 2 Dmitri 2009-05-21 01:03:32 UTC
(In reply to comment #1)
> My guess is this request would best be dealt with upstream.  You might want to
> investigate http://www.linuxfoundation.org/en/Net:Net-tools to see who to
> contact...
> 

thank you for the suggestion
here is a link to follow up.
Feature Request #4612
https://developer.berlios.de/feature/index.php?func=detailfeature&feature_id=4612&group_id=4537