Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 398201

Summary: The files /usr/share/doc/openrc-*net.example.bz2 and /usr/share/doc/wpa_supplicant-*/wpa_supplicant.conf.bz2 should be included in the installCDs
Product: Gentoo Release Media Reporter: Francisco Blas Izquierdo Riera (RETIRED) <klondike>
Component: InstallCDAssignee: Gentoo Release Team <releng>
Status: RESOLVED WONTFIX    
Severity: enhancement CC: bkohler, pacho, zerochaos
Priority: Normal    
Version: unspecified   
Hardware: All   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---

Description Francisco Blas Izquierdo Riera (RETIRED) gentoo-dev 2012-01-09 00:39:44 UTC
This is a feature request to ask for the files /usr/share/doc/openrc-*net.example.bz2 and /usr/share/doc/wpa_supplicant-*/wpa_supplicant.conf.bz2 to be included into minimal install CDs (and maybe other media).

Said files currently weight 25K and could provide a really useful help to the user who is using special network settings to connect to the internet (these including wireless) and who can't check the handbook online (i.e. with lynx) because of this.

Reproducible: Always
Comment 1 Pacho Ramos gentoo-dev 2012-03-05 08:31:23 UTC
I fully agree since I now have this problem when trying to install a new system and will probably need to copy it from other computer with a pendrive :S
Comment 2 Pacho Ramos gentoo-dev 2012-03-05 08:44:24 UTC
Well, I have just seen it's much easier to manually write:
# The below line not be changed otherwise we refuse to work
ctrl_interface=/var/run/wpa_supplicant

# Ensure that only root can read the WPA configuration
ctrl_interface_group=0

# Let wpa_supplicant take care of scanning and AP selection
ap_scan=1

# Simple case: WPA-PSK, PSK as an ASCII passphrase, allow all valid ciphers
network={
  ssid="simple"
  psk="very secret passphrase"
  # The higher the priority the sooner we are matched
  priority=5
}

part than trying to tweak example file
Comment 3 Jeremy Olexa (darkside) (RETIRED) archtester gentoo-dev Security 2012-03-05 13:58:14 UTC
Question: Aren't the files included with a stage3? That should be enough, no?
Comment 4 Pacho Ramos gentoo-dev 2012-03-05 18:28:30 UTC
I couldn't find them, looks like /usr/share/doc is not included there
Comment 5 Ben Kohler gentoo-dev 2013-11-16 16:38:10 UTC
This is a good idea.  It's not enough that they are in stage3, these files are helpful to get networking up to be able to fetch stage3.
Comment 6 Rick Farina (Zero_Chaos) gentoo-dev 2013-11-17 15:17:15 UTC
iirc, the installcd target cleans out a lot of "extra" files by removing, say, the docs dir.  I'm open to changing that, but if we do the size will increase by a fair margin.  For instance, my /usr/share/doc/ is 253MB (I have a lot more installed I'm sure, but you get my point.
Comment 7 Francisco Blas Izquierdo Riera (RETIRED) gentoo-dev 2014-04-08 20:57:17 UTC
(In reply to Rick Farina (Zero_Chaos) from comment #6)
> iirc, the installcd target cleans out a lot of "extra" files by removing,
> say, the docs dir.  I'm open to changing that, but if we do the size will
> increase by a fair margin.  For instance, my /usr/share/doc/ is 253MB (I
> have a lot more installed I'm sure, but you get my point.

Which is why back then I requested to have those (and only those) files included as possible. They provide a good reference for the users which is hard to obtain otherwise as it is network related.

I also think a small (1 or 2kb) wpa_supplicant.conf file could also be provided to cover for most WPA/PSK setups.
Comment 8 Jorge Manuel B. S. Vicetto (RETIRED) gentoo-dev 2017-02-06 20:45:22 UTC
Although I can recognize those files are useful on new installs, I've never agree with this bug for all the work it would create for releng.
Please check lines 130 to 206 of https://gitweb.gentoo.org/proj/releng.git/tree/releases/weekly/specs/amd64/installcd-stage2-minimal.spec (in particular line 178). We now have a clean way to remove everything on /usr/share/doc. For this proposal, we would need to maintain a list of dirs and files under /usr/share/doc and list them individually to keep the 2 requested files in the CD.
Instead, since we've always argued that a Gentoo install requires an Internet Connection, I'd rather have us point from the handbook to the man pages or those 2 files.
Comment 9 Andreas K. Hüttel archtester gentoo-dev 2022-04-09 17:00:50 UTC
(In reply to Jorge Manuel B. S. Vicetto from comment #8)
> Although I can recognize those files are useful on new installs, I've never
> agree with this bug for all the work it would create for releng.
> Please check lines 130 to 206 of
> https://gitweb.gentoo.org/proj/releng.git/tree/releases/weekly/specs/amd64/
> installcd-stage2-minimal.spec (in particular line 178). We now have a clean
> way to remove everything on /usr/share/doc. For this proposal, we would need
> to maintain a list of dirs and files under /usr/share/doc and list them
> individually to keep the 2 requested files in the CD.
> Instead, since we've always argued that a Gentoo install requires an
> Internet Connection, I'd rather have us point from the handbook to the man
> pages or those 2 files.

This.