Home Page The Club Computers News Links Glossary EYAWTK
Before Amiga Background ICS OCS ECS AGA ??? PPC
U-Boot SLB Linux Amiga OS Dual Boot Motherboards Peripherals Other
Initialisation Installation OS4 Updates About OS4 File Systems Networking Printing Other
Introduction File System Workbench Preferences Commands Error Msgs Miscellaneous

AmigaOS 4.0 - About OS4 - Commands

Purpose: To add network message routing paths.
Format: ADDNETROUTE [QUIET] [DST | DESTINATION <destination>] [HOSTDST | HOSTDESTINATION <host destination>] [NETDST | NETDESTINATION <net destination>] [VIA | GATEWAY <gateway>] [DEFAULT | DEFAULTGATEWAY <default gateway>]
ADDNETROUTE is used to add message routing paths for the network.

The QUIET option, if specified, will suppress error or progress reports. Also, if the program encounters an error it will flag this as failure code 5 which can be looked at using the 'if warn' shell script command. If this option is not in effect, failure codes will be more severe and all sorts of progress information will be displayed.

The DST or DESTINATION <destination> option, if specified, supplies the destination address of a route (or in other words, where the route to be added leads to). This must be an IP address or a symbolic name. Some routes may require you to specify a gateway address through which the route has to pass. Depending upon the address you specify, the protocol stack will attempt to figure out whether the destination is supposed to be a host or a network.

The HOSTDST or HOSTDESTINATION <host destination> option, if specified, is the same as the 'DST or DESTINATION' parameter, except that the destination is assumed to be a host (rather than a network).

The NETDST or NETDESTINATION <net destination> option, if specified, is the same as the 'DST or DESTINATION' parameter, except that the destination is assumed to be a network (rather than a host).

The VIA or GATEWAY <gateway> option, if specified, complements the route destination address; it indicates the address to which a message should be sent for it to be passed to the destination. This must be an IP address or a symbolic name

The DEFAULT or DEFAULTGATEWAY <default gateway> option, if specified, selects the default gateway address (which must be specified as an IP address or a symbolic host name) all messages are sent to which don't have any particular other routes associated with them. Another, perhaps less misleading name for 'default gateway address' is 'default route'.

If you use the DEFAULT or DEFAULTGATEWAY option, all other destination addresses you may have specified will be ignored. Before you add a new default gateway address you should delete the old one using DELETENETROUTE or you'll get an error message instead.

Only one of the ' DST or DESTINATION ', ' HOSTDST or HOSTDESTINATION ' or 'NETDST or NETDESTINATION ' parameters will be used; choose only one.

Example 1:

3.OS4:> ADDNETROUTE NETDST= sets the routing for the network to the specified IP address.

Example 2:

3.OS4:> ADDNETROUTE DEFAULTGATEWAY= QUIET sets the default gateway to the specified IP address.

Return to Commands Selection

Disclaimer: Amiga Auckland have prepared the above information for the use of its members based on our experiences and as such is subject to revision at any time. Amiga Auckland cannot guarantee any of the information and cannot be held accountable for any issues that may result from using it.

Copyright 2006 Amiga Auckland Inc. All rights reserved.
Revised: February 9, 2006.