URL
https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk
Subversion Repositories openrisc_2011-10-31
[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [net-common-configuring-ip-addresses.html] - Rev 174
Compare with Previous | Blame | View Log
<!-- Copyright (C) 2003 Red Hat, Inc. --> <!-- This material may be distributed only subject to the terms --> <!-- and conditions set forth in the Open Publication License, v1.0 --> <!-- or later (the latest version is presently available at --> <!-- http://www.opencontent.org/openpub/). --> <!-- Distribution of the work or derivative of the work in any --> <!-- standard (paper) book form is prohibited unless prior --> <!-- permission is obtained from the copyright holder. --> <HTML ><HEAD ><TITLE >Configuring IP Addresses</TITLE ><meta name="MSSmartTagsPreventParsing" content="TRUE"> <META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ "><LINK REL="HOME" TITLE="eCos Reference Manual" HREF="ecos-ref.html"><LINK REL="UP" TITLE="TCP/IP Stack Support for eCos" HREF="net-common-tcpip.html"><LINK REL="PREVIOUS" TITLE="Sample Code" HREF="net-common-sample-code.html"><LINK REL="NEXT" TITLE="Tests and Demonstrations" HREF="net-common-tests-and-demonstrations.html"></HEAD ><BODY CLASS="CHAPTER" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >eCos Reference Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="net-common-sample-code.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="net-common-tests-and-demonstrations.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="CHAPTER" ><H1 ><A NAME="NET-COMMON-CONFIGURING-IP-ADDRESSES">Chapter 35. Configuring IP Addresses</H1 ><P >Each interface (“eth0” and “eth1”) has independent configuration of its setup. Each can be set up manually (in which case you must write code to do this), or by using <SPAN CLASS="ACRONYM" >BOOTP/DHCP</SPAN >, or explicitly, with configured values. If additional interfaces are added, these must be configured manually.</P ><P >The configurable values are: </P ><P ></P ><UL ><LI ><P >IP address</P ></LI ><LI ><P >netmask</P ></LI ><LI ><P >broadcast address</P ></LI ><LI ><P >gateway/router</P ></LI ><LI ><P >server address.</P ></LI ></UL ><P >Server address is the DHCP server if applicable, but in addition, many test cases use it as “the machine to talk to” in whatever manner the test exercises the protocol stack.</P ><P >The initialization is invoked by calling the C routine <TABLE BORDER="5" BGCOLOR="#E0E0F0" WIDTH="70%" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void <TT CLASS="FUNCTION" >init_all_network_interfaces</TT >(void);</PRE ></TD ></TR ></TABLE ></P ><P >Additionally, if the system is configured to support IPv6 then each interface may have an address assigned which is a composite of a 64 bit prefix and the 32 bit IPv4 address for that interface. The prefix is controlled by the CDL setting CYGHWR_NET_DRIVER_ETH0_IPV6_PREFIX for “eth0”, etc. This is a CDL booldata type, allowing this address to be suppressed if not desired.</P ><P >Refer to the test cases, <TT CLASS="FILENAME" >…/packages/net/common/<TT CLASS="REPLACEABLE" ><I >VERSION</I ></TT >/tests/ftp_test.c</TT > for example usage, and the source files in <TT CLASS="FILENAME" >…/packages/net/common/<TT CLASS="REPLACEABLE" ><I >VERSION</I ></TT >/src/bootp_support.c</TT > and <TT CLASS="FILENAME" >network_support.c</TT > to see what that call does.</P ><P >This assumes that the MAC address (also known as <SPAN CLASS="ACRONYM" >ESA</SPAN > or Ethernet Station Address) is already defined in the serial EEPROM or however the particular target implements this; support for setting the MAC address is hardware dependent.</P ><P >DHCP support is active by default, and there are configuration options to control it. Firstly, in the top level of the “Networking” configuration tree, “Use full DHCP instead of BOOTP” enables DHCP, and it contains an option to have the system provide a thread to renew DHCP leases and manage lease expiry. Secondly, the individual interfaces “eth0” and “eth1” each have new options within the “Use BOOTP/DHCP to initialize ‘<SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >ethX</I ></SPAN >’” to select whether to use DHCP rather than BOOTP.</P ><P >Note that you are completely at liberty to ignore this startup code and its configuration in building your application. <TT CLASS="FUNCTION" >init_all_network_interfaces()</TT > is provided for three main purposes: <P ></P ><UL ><LI ><P >For use by Red Hat's own test programs.</P ></LI ><LI ><P >As an easy “get you going” utility for newcomers to <SPAN CLASS="PRODUCTNAME" >eCos</SPAN >.</P ></LI ><LI ><P >As readable example code from which further development might start.</P ></LI ></UL ></P ><P >If your application has different requirements for bringing up available network interfaces, setting up routes, determining IP addresses and the like from the defaults that the example code provides, you can write your own initialization code to use whatever sequence of <TT CLASS="FUNCTION" >ioctl()</TT > function calls carries out the desired setup. Analogously, in larger systems, a sequence of “ifconfig” invocations is used; these mostly map to <TT CLASS="FUNCTION" >ioctl()</TT > calls to manipulate the state of the interface in question.</P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="net-common-sample-code.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ecos-ref.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="net-common-tests-and-demonstrations.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Sample Code</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="net-common-tcpip.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Tests and Demonstrations</TD ></TR ></TABLE ></DIV ></BODY ></HTML >