IFConfig


Contents


Introduction and Overview

The Internet stack has a number of interfaces - network connection points - which are provided by the hardware network interfaces. These interfaces must be configured before they will function as part of the network. The IFConfig allows these interfaces to be configured.


*Commands


*IFConfig

Configure network interface parameters
Syntax
*IFConfig [-e] <interface> [<ip>[<destination>]] [up | down] [arp | -arp] [metric <n>] [netmask <mask>] [broadcast <addr>] [alias <addr>] [delete <addr>] [mtu <n>]
*IFConfig -a
Parameters
up -Mark an interface 'up'. This may be used to enable an interface after going *IfConfig - down. It happens automatically when setting the first address on an interface. If the interface was reset when previously marked down, the hardware will be re-initialised.
down -Mark an interface 'down'. When an interface is marked 'down', the system will not attempt to transmit messages through that interface. If possible, the interface will be reset to disable reception as well. This action does not automatically disable routes using the interface.
arp -Enable the use of the Address Resolution Protocol in mapping between network level addresses and link level addresses (default), for mapping between Internet addresses and Ethernet addresses.
-arp -Disable the use of the Address Resolution Protocol.
metric <n>-Set the routing metric of the interface to n (default 0). The routing metric is used by the routing protocol. Higher metrics have the effect of making a route less favourable; metrics are counted as additional hops to the destination network or host.
netmask <mask>-Specify how much of the address to reserve for subdividing networks into sub-networks. The mask includes the network part of the local address and the subnet part, which is taken from the host field of the address. The mask can be specified as a single hexadecimal number with a leading 0x, as an Internet address using the standard dot notation, or as a pseudo-network name listed in the network table InetDBase:networks. The mask contains 1's for the bit positions in the 32-bit address which are to be used for the network and subnet parts, and 0's for the host part. The mask should contain at least the standard network portion, and the subnet field should be contiguous with the network portion.
broadcast <addr>-Specify the address to use to represent broadcasts to the network. The default broadcast address is the address with a host part of all 1's.
-a -Display all interfaces
-e -Assign errors to Inet$Error
Use

The IfConfig program is used to assign an Internet address to a network interface supported by the Internet module, and/or to configure network interface parameters. It must be used at Internet module startup time to define the network address of each interface present on a machine; it may also be used at a later time to redefine an interface's address or other operating parameters.

Example
*ifconfig eh0 192.168.0.1 netmask 255.255.255.0 up
Related * commands
*IFRConfig

Document information

Maintainer(s): RISCOS Ltd <developer@riscos.com>
History:
RevisionDateAuthorChanges
1ROLInitial version
225 Jan 2002ROLLink fix
  • Fixed the link to IFRConfig
Disclaimer:

Copyright © Pace Micro Technolgy plc, 2002.
Portions copyright © RISCOS Ltd, 2002.
Published by RISCOS Limited.
No part of this publication may be reproduced or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, or stored in any retrieval system of any nature, without the written permission of the copyright holder and the publisher, application for which shall be made to the publisher.