doc/html/ref/ip-address-command.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >ip_address</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos Reference Manual"
  20 HREF="ecos-ref.html"><LINK
  21 REL="UP"
  22 TITLE="Common Commands"
  23 HREF="common-commands.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="help"
  26 HREF="help-command.html"><LINK
  27 REL="NEXT"
  28 TITLE="load"
  29 HREF="download-command.html"></HEAD
  30 ><BODY
  31 CLASS="REFENTRY"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos Reference Manual</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="help-command.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 ></TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="download-command.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><H1
  81 ><A
  82 NAME="IP-ADDRESS-COMMAND">ip_address</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN3361"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >ip_address&nbsp;--&nbsp;Set IP addresses</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN3364"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >ip_address</B
 100 >  [-l <TT
 101 CLASS="REPLACEABLE"
 102 ><I
 103 > local_IP_address</I
 104 ></TT
 105 >] [-h <TT
 106 CLASS="REPLACEABLE"
 107 ><I
 108 > server_IP_address</I
 109 ></TT
 110 >] [-d <TT
 111 CLASS="REPLACEABLE"
 112 ><I
 113 >DNS_server_IP_address</I
 114 ></TT
 115 >]</P
 116 ></DIV
 117 ><DIV
 118 CLASS="REFSECT1"
 119 ><A
 120 NAME="AEN3373"
 121 ></A
 122 ><H2
 123 >Arguments</H2
 124 ><DIV
 125 CLASS="INFORMALTABLE"
 126 ><A
 127 NAME="AEN3375"><P
 128 ></P
 129 ><TABLE
 130 BORDER="1"
 131 CLASS="CALSTABLE"
 132 ><THEAD
 133 ><TR
 134 ><TH
 135 WIDTH="25%"
 136 ALIGN="LEFT"
 137 VALIGN="TOP"
 138 >Name</TH
 139 ><TH
 140 WIDTH="25%"
 141 ALIGN="LEFT"
 142 VALIGN="TOP"
 143 >Type</TH
 144 ><TH
 145 WIDTH="25%"
 146 ALIGN="LEFT"
 147 VALIGN="TOP"
 148 >Description</TH
 149 ><TH
 150 WIDTH="25%"
 151 ALIGN="LEFT"
 152 VALIGN="TOP"
 153 >Default</TH
 154 ></TR
 155 ></THEAD
 156 ><TBODY
 157 ><TR
 158 ><TD
 159 WIDTH="25%"
 160 ALIGN="LEFT"
 161 VALIGN="TOP"
 162 >-l <TT
 163 CLASS="REPLACEABLE"
 164 ><I
 165 >local_IP_address</I
 166 ></TT
 167 ></TD
 168 ><TD
 169 WIDTH="25%"
 170 ALIGN="LEFT"
 171 VALIGN="TOP"
 172 >Numeric IP or DNS name</TD
 173 ><TD
 174 WIDTH="25%"
 175 ALIGN="LEFT"
 176 VALIGN="TOP"
 177 >The IP address RedBoot should use.</TD
 178 ><TD
 179 WIDTH="25%"
 180 ALIGN="LEFT"
 181 VALIGN="TOP"
 182 ><SPAN
 183 CLASS="emphasis"
 184 ><I
 185 CLASS="EMPHASIS"
 186 >none</I
 187 ></SPAN
 188 ></TD
 189 ></TR
 190 ><TR
 191 ><TD
 192 WIDTH="25%"
 193 ALIGN="LEFT"
 194 VALIGN="TOP"
 195 >-h <TT
 196 CLASS="REPLACEABLE"
 197 ><I
 198 >server_IP_address</I
 199 ></TT
 200 ></TD
 201 ><TD
 202 WIDTH="25%"
 203 ALIGN="LEFT"
 204 VALIGN="TOP"
 205 >Numeric IP or DNS name</TD
 206 ><TD
 207 WIDTH="25%"
 208 ALIGN="LEFT"
 209 VALIGN="TOP"
 210 >The IP address of the default server. Use of this
 211 address is implied by other commands, such as
 212 <B
 213 CLASS="COMMAND"
 214 >load</B
 215 >.</TD
 216 ><TD
 217 WIDTH="25%"
 218 ALIGN="LEFT"
 219 VALIGN="TOP"
 220 ><SPAN
 221 CLASS="emphasis"
 222 ><I
 223 CLASS="EMPHASIS"
 224 >none</I
 225 ></SPAN
 226 ></TD
 227 ></TR
 228 ><TR
 229 ><TD
 230 WIDTH="25%"
 231 ALIGN="LEFT"
 232 VALIGN="TOP"
 233 >-d <TT
 234 CLASS="REPLACEABLE"
 235 ><I
 236 >DNS_server_IP_address</I
 237 ></TT
 238 ></TD
 239 ><TD
 240 WIDTH="25%"
 241 ALIGN="LEFT"
 242 VALIGN="TOP"
 243 >Numeric IP or DNS name</TD
 244 ><TD
 245 WIDTH="25%"
 246 ALIGN="LEFT"
 247 VALIGN="TOP"
 248 >The IP address of the DNS server.</TD
 249 ><TD
 250 WIDTH="25%"
 251 ALIGN="LEFT"
 252 VALIGN="TOP"
 253 ><SPAN
 254 CLASS="emphasis"
 255 ><I
 256 CLASS="EMPHASIS"
 257 >none</I
 258 ></SPAN
 259 ></TD
 260 ></TR
 261 ></TBODY
 262 ></TABLE
 263 ><P
 264 ></P
 265 ></DIV
 266 ></DIV
 267 ><DIV
 268 CLASS="REFSECT1"
 269 ><A
 270 NAME="AEN3410"
 271 ></A
 272 ><H2
 273 >Description</H2
 274 ><P
 275 >The <B
 276 CLASS="COMMAND"
 277 >ip_address</B
 278 > command is used to show and/or change the basic IP
 279 addresses used by RedBoot. IP addresses may be given as numeric
 280 values, e.g. 192.168.1.67, or as symbolic names such as www.redhat.com
 281 if DNS support is enabled.
 282       </P
 283 ><P
 284 >The <TT
 285 CLASS="OPTION"
 286 >-l</TT
 287 > option is used to set the IP address used by
 288 the target device.
 289       </P
 290 ><P
 291 >The <TT
 292 CLASS="OPTION"
 293 >-h</TT
 294 > option is used to set the default server
 295 address, such as is used by the <B
 296 CLASS="COMMAND"
 297 >load</B
 298 > command.
 299       </P
 300 ><P
 301 >The <TT
 302 CLASS="OPTION"
 303 >-d</TT
 304 > option is used to set the default DNS server
 305 address which is used for resolving symbolic network addresses. Note
 306 that an address of 0.0.0.0 will disable DNS lookups.
 307       </P
 308 ></DIV
 309 ><DIV
 310 CLASS="REFSECT1"
 311 ><A
 312 NAME="AEN3421"
 313 ></A
 314 ><H2
 315 >Examples</H2
 316 ><P
 317 >Display the current network settings.
 318 <TABLE
 319 BORDER="5"
 320 BGCOLOR="#E0E0F0"
 321 WIDTH="70%"
 322 ><TR
 323 ><TD
 324 ><PRE
 325 CLASS="SCREEN"
 326 >
 327 RedBoot&#62; <TT
 328 CLASS="USERINPUT"
 329 ><B
 330 >ip_address</B
 331 ></TT
 332 >
 333 IP: 192.168.1.31, Default server: 192.168.1.101, DNS server IP: 0.0.0.0 </PRE
 334 ></TD
 335 ></TR
 336 ></TABLE
 337 > </P
 338 ><P
 339 >Change the DNS server address.
 340 <TABLE
 341 BORDER="5"
 342 BGCOLOR="#E0E0F0"
 343 WIDTH="70%"
 344 ><TR
 345 ><TD
 346 ><PRE
 347 CLASS="SCREEN"
 348 >
 349 RedBoot&#62; <TT
 350 CLASS="USERINPUT"
 351 ><B
 352 >ip_address -d 192.168.1.101</B
 353 ></TT
 354 >
 355 IP: 192.168.1.31, Default server: 192.168.1.101, DNS server IP: 192.168.1.101 </PRE
 356 ></TD
 357 ></TR
 358 ></TABLE
 359 > </P
 360 ><P
 361 >Change the default server address.
 362 <TABLE
 363 BORDER="5"
 364 BGCOLOR="#E0E0F0"
 365 WIDTH="70%"
 366 ><TR
 367 ><TD
 368 ><PRE
 369 CLASS="SCREEN"
 370 >
 371 RedBoot&#62; <TT
 372 CLASS="USERINPUT"
 373 ><B
 374 >ip_address -h 192.168.1.104</B
 375 ></TT
 376 >
 377 IP: 192.168.1.31, Default server: 192.168.1.104, DNS server IP: 192.168.1.101</PRE
 378 ></TD
 379 ></TR
 380 ></TABLE
 381 >
 382       </P
 383 ></DIV
 384 ><DIV
 385 CLASS="NAVFOOTER"
 386 ><HR
 387 ALIGN="LEFT"
 388 WIDTH="100%"><TABLE
 389 SUMMARY="Footer navigation table"
 390 WIDTH="100%"
 391 BORDER="0"
 392 CELLPADDING="0"
 393 CELLSPACING="0"
 394 ><TR
 395 ><TD
 396 WIDTH="33%"
 397 ALIGN="left"
 398 VALIGN="top"
 399 ><A
 400 HREF="help-command.html"
 401 ACCESSKEY="P"
 402 >Prev</A
 403 ></TD
 404 ><TD
 405 WIDTH="34%"
 406 ALIGN="center"
 407 VALIGN="top"
 408 ><A
 409 HREF="ecos-ref.html"
 410 ACCESSKEY="H"
 411 >Home</A
 412 ></TD
 413 ><TD
 414 WIDTH="33%"
 415 ALIGN="right"
 416 VALIGN="top"
 417 ><A
 418 HREF="download-command.html"
 419 ACCESSKEY="N"
 420 >Next</A
 421 ></TD
 422 ></TR
 423 ><TR
 424 ><TD
 425 WIDTH="33%"
 426 ALIGN="left"
 427 VALIGN="top"
 428 >help</TD
 429 ><TD
 430 WIDTH="34%"
 431 ALIGN="center"
 432 VALIGN="top"
 433 ><A
 434 HREF="common-commands.html"
 435 ACCESSKEY="U"
 436 >Up</A
 437 ></TD
 438 ><TD
 439 WIDTH="33%"
 440 ALIGN="right"
 441 VALIGN="top"
 442 >load</TD
 443 ></TR
 444 ></TABLE
 445 ></DIV
 446 ></BODY
 447 ></HTML
 448 >