x25config(1)

Name

x25config - get or set X.25 link configuration

Syntax

x25config -s network_name [cfgfile]
x25config -g network_name
x25config network_name
x25config -d [cfgfile]

Description

x25config displays or alters the X.25 configuration parameters for the specified X.25 network, network_name. network_name must be a valid X.25 network entry in /etc/packetnets.

x25config uses CCITT 1984 X.25 Registration rules to implement changes. That means, if the logical channel configuration changes, links are taken down. Otherwise, the configuration is changed without affecting any operating virtual circuits.

When the -s flag is specified, x25config sets the configuration of network_name to the configuration described by cfgfile. See X.25 Link Configuration in the Administrator's Guide for more information on the format of cfgfile.

If cfgfile is not found in the current directory, x25config searches the directory /usr/lib/x25/config. If cfgfile is not specified, /usr/lib/x25/config/net.default is used.

When the -g flag is specified, x25config gets the current X.25 configuration information from network_name and displays it on standard output. This flag may be used to determine how network_name was last configured.

If network_name is specified with neither the -g nor -s flag, x25config displays only the X.25 network identification and the X.25 address corresponding to network_name.

When the -d flag is specified, x25config displays the value and description of each parameter in cfgfile. If cfgfile is not found in the current directory, x25config searches the directory /usr/lib/x25/config for cfgfile. If cfgfile is not specified, the contents of /usr/lib/x25/config/net.default is displayed.

Diagnostics

If x25config encounters a problem updating an X.25 configuration, the following message may appear on standard error:

   reconfiguration status: nnn

where nnn means:

2 The new configuration requested a default packet or window size in excess of the maximum. The excessive value is changed to be the maximum. The maximum compared to is the value from the new configuration itself, eliminating the necessity of sending two reconfigurations to increase the maximum and use it.

3 The new configuration attempted to configure too many logical channels. The configuration proceeds by reducing the number of logical channels requested, first the One-Way Incoming group is deleted, then (if not enough), the One-Way Outgoing group is deleted. If this is not sufficient, the number of channels in the Both-Way group is reduced, possibly to zero.

Files

/usr/lib/x25/config/<cfgfile>