/[gentoo]/xml/htdocs/doc/en/handbook/hb-net-start.xml
Gentoo

Contents of /xml/htdocs/doc/en/handbook/hb-net-start.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.4 - (show annotations) (download) (as text)
Thu Jul 14 10:22:46 2005 UTC (9 years, 5 months ago) by fox2mike
Branch: MAIN
Changes since 1.3: +6 -6 lines
File MIME type: application/xml
#98734 - Added a <c> for better visibility. Thanks to pclouds.

1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3
4 <!-- The content of this document is licensed under the CC-BY-SA license -->
5 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6
7 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-start.xml,v 1.3 2005/06/14 18:34:32 neysx Exp $ -->
8
9 <sections>
10
11 <version>1.2</version>
12 <date>2005-07-14</date>
13
14 <section>
15 <title>Getting started</title>
16 <body>
17
18 <note>
19 This document assumes that you have correctly configured your kernel, its
20 modules for your hardware and you know the interface name of your hardware.
21 We also assume that you are configuring eth0, but it could also be
22 eth1, wlan0, etc.
23 </note>
24
25 <note>
26 This document requires you are running baselayout-1.11.11 or better.
27 </note>
28
29 <p>
30 To get started configuring your network card, you need to tell the Gentoo RC
31 system about it. This is done by creating a symbolic link from <c>net.lo</c>
32 to <c>net.eth0</c> in <path>/etc/init.d</path>
33 </p>
34
35 <pre caption="Symlinking net.eth0 to net.lo">
36 # <i>cd /etc/init.d</i>
37 # <i>ln -s net.lo net.eth0</i>
38 </pre>
39
40 <p>
41 Gentoo's RC system now knows about that interface. It also needs to know how
42 to configure the new interface. All the network interfaces are configured in
43 <path>/etc/conf.d/net</path>. Below is a sample configuration for DHCP and
44 static addresses.
45 </p>
46
47 <pre caption="Examples for /etc/conf.d/net">
48 <comment># For DHCP</comment>
49 config_eth0=( "dhcp" )
50
51 <comment># For static IP using CIDR notation</comment>
52 config_eth0=( "192.168.0.7/24" )
53 routes_eth0=( "default via 192.168.0.1" )
54
55 <comment># For static IP using netmask notation</comment>
56 config_eth0=( "192.168.0.7 netmask 255.255.255.0" )
57 routes_eth0=( "default gw 192.168.0.1" )
58 </pre>
59
60 <note>
61 If you do not specify a configuration for your interface then DHCP is assumed.
62 </note>
63
64 <note>
65 CIDR stands for Classless InterDomain Routing.
66 Originally, IPv4 addresses were classified as A, B, or C.
67 The early classification system did not envision the massive popularity of the
68 Internet, and is in danger of running out of new unique addresses. CIDR is an
69 addressing scheme that allows one IP address to designate many IP addresses.
70 A CIDR IP address looks like a normal IP address except that it ends with a
71 slash followed by a number; for example, 192.168.0.0/16.
72 CIDR is described in <uri link="http://rfc.net/rfc1519.html">RFC 1519</uri>.
73 </note>
74
75 <p>
76 Now that we have configured our interface, we can start and stop it using the
77 below commands
78 </p>
79
80 <pre caption="Starting and stopping network scripts">
81 # <i>/etc/init.d/net.eth0 start</i>
82 # <i>/etc/init.d/net.eth0 stop</i>
83 </pre>
84
85 <impo>
86 When troubleshooting networking, it is recommended to set
87 <c>RC_VERBOSE="yes"</c> in <path>/etc/conf.d/rc</path> so that you get more
88 information about what's happening.
89 </impo>
90
91 <p>
92 Now that you have successfully started and stopped your network interface, you
93 may wish to get it to start when Gentoo boots. Here's how to do this. The last
94 "rc" command instructs Gentoo to start any scripts in the current runlevel
95 that have not yet been started.
96 </p>
97
98 <pre caption="Configuring a network interface to load at boot time">
99 # <i>rc-update add net.eth0 default</i>
100 # <i>rc</i>
101 </pre>
102
103 </body>
104 </section>
105
106 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20