neysx 05/06/28 12:28:00
Modified: xml/htdocs/doc/en/handbook hb-install-config.xml
hb-install-system.xml
Log:
#96715 stage3 users should upgrade baselayout to be consistent with stage1/2
and other parts of book
Revision Changes Path
1.69 +41 -17 xml/htdocs/doc/en/handbook/hb-install-config.xml
file :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-config.xml?rev=1.69&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain:
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-config.xml?rev=1.69&content-type=text/plain&cvsroot=gentoo
diff :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-config.xml.diff?r1=1.68&r2=1.69&cvsroot=gentoo
Index: hb-install-config.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v
retrieving revision 1.68
retrieving revision 1.69
diff -u -r1.68 -r1.69
--- hb-install-config.xml 24 Jun 2005 19:38:00 -0000 1.68
+++ hb-install-config.xml 28 Jun 2005 12:28:00 -0000 1.69
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.68
2005/06/24 19:38:00 fox2mike Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.69
2005/06/28 12:28:00 neysx Exp $ -->
<sections>
-<version>2.9</version>
-<date>2005-06-24</date>
+<version>2.10</version>
+<date>2005-06-28</date>
<section>
<title>Filesystem Information</title>
@@ -240,12 +240,20 @@
<p>
All networking information is gathered in <path>/etc/conf.d/net</path>. It uses
a straightforward yet not intuitive syntax if you don't know how to set up
-networking manually. But don't fear, we'll explain everything :)
+networking manually. But don't fear, we'll explain everything. A fully
+commented example that covers many different configurations is available in
+<path>/etc/conf.d/net.example</path>.
</p>
<p>
-First open <path>/etc/conf.d/net</path> with your favorite editor (<c>nano</c>
-is used in this example):
+DHCP is used by default and does not require any further configuration.
+</p>
+
+<p>
+If you need to configure your network connection either because you need
+specific DHCP options or because you do not use DHCP at all, open
+<path>/etc/conf.d/net</path> with your favorite editor (<c>nano</c> is used in
+this example):
</p>
<pre caption="Opening /etc/conf.d/net for editing">
@@ -253,18 +261,18 @@
</pre>
<p>
-The first variable you'll find is called <c>config_eth0</c>. As you can
probably
-imagine, this variable configured the eth0 network interface. If the interface
-needs to automatically obtain an IP address through DHCP, you should set it
-like so:
+You will see the following file:
</p>
-<pre caption="Automatically obtaining an IP address for eth0">
-config_eth0=( "dhcp" )
+<pre caption="Default /etc/conf.d/net">
+# This blank configuration will automatically use DHCP for any net.*
+# scripts in /etc/init.d. To create a more complete configuration,
+# please review /etc/conf.d/net.example and save your configuration
+# in /etc/conf.d/net (this file :]!).
</pre>
<p>
-However, if you have to enter your own IP address, netmask and gateway, you
need
+To enter your own IP address, netmask and gateway, you need
to set both <c>config_eth0</c> and <c>routes_eth0</c>:
</p>
@@ -274,6 +282,21 @@
</pre>
<p>
+To use DHCP and add specific DHCP options, define <c>config_eth0</c> and
+<c>dhcp_eth0</c>:
+</p>
+
+<pre caption="Automatically obtaining an IP address for eth0">
+config_eth0=( "dhcp" )
+dhcp_eth0="nodns nontp nonis"
+</pre>
+
+<p>
+Please read <path>/etc/conf.d/net.example</path> for a list of all available
+options.
+</p>
+
+<p>
If you have several network interfaces repeat the above steps for
<c>config_eth1</c>, <c>config_eth2</c>, etc.
</p>
@@ -433,8 +456,8 @@
<p>
As you can see, this file is well commented to help you set up the necessary
-configuration variables. Among other settings, you can configure your console
-fonts, your default editor and your display manager (like gdm or kdm).
+configuration variables. You can configure your system to use unicode and
+define your default editor and your display manager (like gdm or kdm).
</p>
<p>
@@ -502,8 +525,9 @@
</note>
<p>
-If you are running Gentoo in an LPAR or on a JS20 blade, you must uncomment
-the hvc line in /etc/inittab for the virtual console to spawn a login prompt.
+If you are running Gentoo in an LPAR or on a JS20 blade, you must uncomment the
+hvc line in <path>/etc/inittab</path> for the virtual console to spawn a login
+prompt.
</p>
<pre caption="Enabling hvc support in /etc/inittab">
1.81 +34 -3 xml/htdocs/doc/en/handbook/hb-install-system.xml
file :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.81&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain:
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.81&content-type=text/plain&cvsroot=gentoo
diff :
http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/hb-install-system.xml.diff?r1=1.80&r2=1.81&cvsroot=gentoo
Index: hb-install-system.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v
retrieving revision 1.80
retrieving revision 1.81
diff -u -r1.80 -r1.81
--- hb-install-system.xml 8 Jun 2005 23:37:48 -0000 1.80
+++ hb-install-system.xml 28 Jun 2005 12:28:00 -0000 1.81
@@ -4,12 +4,12 @@
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
-<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.80
2005/06/08 23:37:48 neysx Exp $ -->
+<!-- $Header:
/var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.81
2005/06/28 12:28:00 neysx Exp $ -->
<sections>
-<version>2.7</version>
-<date>2005-06-09</date>
+<version>2.8</version>
+<date>2005-06-28</date>
<section>
<title>Chrooting</title>
@@ -354,11 +354,17 @@
and immediately start with the second one (<uri link="#doc_chap4">Progressing
from Stage2 to Stage3</uri>)
</li>
+<!-- Keep this for 2005.1
<li>
If you chose <e>stage3</e> then you can skip both
steps and continue with <uri link="?part=1&chap=7">Configuring the
Kernel</uri>
</li>
+-->
+<li>
+ If you chose <e>stage3</e> then you should <uri
+ link="#upgrade-baselayout">upgrade the baselayout package</uri>.
+</li>
</ul>
</body>
@@ -532,5 +538,30 @@
</body>
</subsection>
</section>
+<section id="upgrade-baselayout">
+<title>Upgrading baselayout</title>
+<subsection>
+<body>
+
+<p>
+The <c>baselayout</c> package has been significantly updated after the release
+of Gentoo 2005.0. Some configuration files have been moved and others use a new
+syntax. This handbook now uses the new configuration files. It is therefore
+highly recommended that you upgrade it before moving on to the next section.
+</p>
+
+<pre caption="Upgrading baselayout">
+# <i>rm /etc/conf.d/net</i>
+# <i>CONFIG_PROTECT="-*" emerge baselayout</i>
+</pre>
+
+<p>
+Please continue with <uri link="?part=1&chap=7">Configuring the
+Kernel</uri>.
+</p>
+
+</body>
+</subsection>
+</section>
</sections>
--
[email protected] mailing list
