Digital

NAME

x25ifconfig − X.25/IP configuration program

SYNOPSIS

x25ifconfig start outgoing-limit incoming-limit
x25ifconfig stop
x25ifconfig enable xwn template filter
x25ifconfig disable xwn
x25ifconfig set ip-address dte-address [outgoing-timeout]
            [incoming-timeout]
x25ifconfig clear ip-address
x25ifconfig show [ip-address]
x25ifconfig showxw xwn

DESCRIPTION

The x25ifconfig command controls the way Internet Protocol (IP) connections are made to remote hosts across an X.25 Packet Switched Data Network (PSDN).  The number of IP network connections is determined at system installation; the number of active X.25 connections is controlled at system startup by x25ifconfig. 

The appropriate x25ifconfig commands to configure IP over X.25 are placed in the system startup file by the x25setup utility.  For more information on configuring IP over X.25, refer to the X.25 for Digital UNIX − Configuration Guide. 

COMMANDS

startInitializes the X.25/IP interface software.  The outgoing-limit and incoming-limit are the maximum number of outgoing and incoming calls respectively that the X.25/IP interface is permitted to make to service all of the IP connection requests across all of the xw interfaces in the system. 

stopCloses all the xw interfaces.  Any active connections are terminated and all resources are freed. 

enableMarks an individual xw interface as active and defines the X25 Access Template entity to use when making an outgoing call and the X25 Access Filter entity to use when listening for incoming calls.  For further information, refer to the DECnet/OSI − Network Control Language Reference. 

disableMarks an interface as inactive and prevents further incoming or outgoing connections. 

setCreates an address translation entry.  This entry defines the mapping between an IP address and an X.25 DTE address.  This entry applies across all the xw interfaces.  The optional outgoing-timeout value defines the number of seconds that a connection to the specified host can be idle before the X.25 connection is terminated.  Once IP activity recommences, the X.25 connection will be re-established transparently to the user of the IP connection.  The optional incoming-timeout value defines the number of seconds that a connection from a remote node can be idle before the X.25 connection is terminated.  If this value is not specified, a default of 0 will be used which means that incoming connections wont be timed out by the receiving host. 

clearRemoves an address translation entry. 

showDisplays address translation entries.  If the optional argument ip-address is specified, then the address translation entry for the specified host is displayed.  If this argument is omitted, then all address translation entries are displayed. 

showxwShows the current xw interface state and the X25 Access Template and Filter associated with this interface. 

FILES

/usr/include/sysexits.h
Definitions of exit values

EXAMPLES

An example of the way the xw interface can be configured for operation is shown below:

/usr/sbin/x25ifconfig start 16 8
/usr/sbin/ifconfig xw0 host-name up
/usr/sbin/x25ifconfig enable xw0 x25ip-template x25ip-filter
/usr/sbin/x25ifconfig set host1 123456789
/usr/sbin/x25ifconfig set host2 987654321

The first command initializes the xw interface specifying that there is up to a maximum of 16 outgoing calls and 8 incoming calls permitted in total, across all of the xw interfaces in the system. 

The second command instructs the IP networking software to configure the xw interface as an active IP network connection.  The IP address host-name is the IP address by which this machine is known on the network connected to the xw interface. 

The third command enables the xw interface and specifies what X.25 template is used when an outgoing X.25 call request is made, and what X.25 filter should be used to listen for incoming calls.  The template and filter named here do not have to be created before this command is issued, but they must exist before any incoming or outgoing connections can be established. 

The fourth and fifth commands add address translation entries to the internal database kept by the xw interface.  These address translation entries specify that the host with IP address host1 can be reached by the X.25 DTE address 123456789, and that host2 can be reached on 987654321.  These entries are necessary because the xw interface is a non-broadcast network, thus the IP Address Resolution Protocol (ARP) cannot be used to resolve IP addresses to X.25 addresses. 

EXIT VALUES

[EX_NOPERM]
An X.25 license error has occurred.

[EX_OK]A successful operation. 

[EX_OSERR]
An operating system error has occurred.

[EX_USAGE]
The command was used incorrectly, such as the wrong number of arguments or incorrect syntax.

RELATED INFORMATION

Commands: ifconfig(8). 
Files: xw(7X25). 

DECnet/OSI − Network Control Language Reference,
X.25 for Digital UNIX − Configuration Guide,
X.25 for Digital UNIX − Management Guide.