Chapter 9 Solstice X.25 Utilities

linkadd

Dynamically adds a link while X.25 is running. 

linkdel

Dynamically removes a link while X.25 is running. 

linklist

Lists the X.25 links that are currently active. 

ixetune

Configure IXE driver. The ixetune utility reads registration and configuration information from the file ixetuneconf and sends this information to the IXE driver. It determines which called addresses a IXE driver is willing to receive connect indications on (listen information). It also specifies the configuration for each IP network, as well as the host's calling/responding address for this network.

The options are: 

-d specify a device for the information to be sent to. The default is /dev/ixe.

-l specify the IP interface to tune. If this option is not specified, all the interfaces will be tuned.

-D specify the pathname of the configuration file to use. The default is /etc/opt/SUNWconn/x25/. The filename used is the default, ixetuneconf.

linkreset

Resets the state machine for a LAPB link. This utility cycles the link into disconnected state, and then back to the running state (assuming that the remote end of the link responds correctly).  

All counters and timers associated with the protocol on that link are reset to their initial values. 

This command operates on an individual link, so the link identifier must be specified. 

linkstart

Puts a LAPB link into running state. This command causes the specified link to enter the ADM state, which resets the internal state machine, causing LAPB to attempt to bring up the link. All counters and timers associated with the protocol on that link are reset to their initial values.  

This command operates on an individual link, so you must specify the link identifier. 

The linkstart utility is intended to reverse the effect of the linkstop command, and is not the appropriate way to define or create a LAPB link.

linkstate

Displays state of a LAPB link. This command displays the internal state of the L:APB for a specified link. When the link is operating normally (i.e. the SABM/UA handshake has been successfully completed) the state displayed is NORMAL.  

Option is: 

-e causes the linkstate command to exit with a status value of 0 if the link is in NORMAL mode, 254 if the X.25 software has not been started, 255 if the link does not exist or 1 otherwise (the link exist but is not in NORMAL mode). This may be useful when using the command in shell scripts.

This command operates on an individual link, so you must specify the link identifier. 

linkstop

Puts a LAPB link into non-running state. This command forces the internal state machine of the LAPB to assume that it has received a disconnect request. This puts the specified link into the disconnected state. The utility also prevents LAPB from responding to any incoming frames on the specified link, until the link has been restarted with linkstart or linkreset. All counters and timers associated with the link protocol are reset to their initial values.

This command operates on an individual link, so you must specify the link identifier. 

When used on a MLP link, linkstop returns the highest status of the different SLP.

This command does not work with LLC2 links (because there is no status available on such links). 

vcstat

Checks the virtual circuit status. This command lets you monitor the link and virtual circuit statistic on a cumulative or periodic basis. Options are: 

-L display per-link statistics instead of virtual circuit statistics.

-n display cumulative (since the last reboot) statistics instead of periodically updating the display.

-l interface specify an interface.

-i interval specify the sampling interval to use for displaying cumulative statistics. If you omit both this and the -n option, vcstat will display cumulative statistics at 30 second intervals.

-s display X.25 addresses in symbolic form, if possible, using the information in the file /etc/opt/SUNWconn/x25/xhosts. If a partial match with an entry in that file is found, then the address will be displayed as the name followed by the unmatched digits. interface corresponds to the number specified for the interface parameter in your link configuration file.

-p period specify the period of time in minutes that vcstat will display the current statistics. By default, vcstat displays statistics for 1440 minutes (24 hours).

-v range specify a virtual circuit, or a range of virtual circuits to be monitored. When specifying a range of virtual circuits, separate the numbers with a hyphen.

Example: -v 11-34.

x25diags 

Converts a hexadecimal diagnostic into a short textual description as defined in the X.25 standard This utility can typically be used when a cause and diagnostic code are returned by the PAD program or when such a diagnostic is detected in x25trace output. The parameter value must be given in hexadecimal without including the error code.

x25file

Generates the configuration file of a running link and echoes it on stdout. Option is:

-l Generates the configuration file for the link number link_id. 

x25info

Generates a complete configuration report for an X.25 link. Options are: 

-h display help information (this is the default option)

-ln specify the link number at the command line level

x25stat

Displays per protocol statistics. Options are: 

-p show statistics for a specified protocol or list of protocols. Protocol may be one of ixe, lapb, llc, mlp, wan, x25 or all. all is used to get statistics for all protocols.

-g Display statistics global to the specified protocols. No global statistics are displayed for 'wan' level.

-l link display statistics on a per-link basis.

-L Display statistics relating to all links.

-v When x25 protocol is used, display statistics on a per-VC basis. The VC can be an actual VC number or a list of VCs separated by commas, or a range of VCs: VC1-VC2

-V When x25 protocol is used, display statistics relating to all VCs.

-s Display addresses symbolically whenever possible.

-a When used with -v or -V options, print abbreviated statistics for active VCs.

-F Display all statistics currently available.

-z Resets the statistics. The options g, p, l, L, v, V, apply as for displaying the statistics. Note: This option is only available to the super-user.

x25trace

Run a trace at X.25 packet level. If you are experiencing communication problems, use this command and redirect its output to a file. Options are: 

-a displays total bytes of user data instead of data itself.

-u buffers output line by line.

-x decodes packet and displays in hexadecimal.

-D decodes and displays DLPI messages exchanged between X.25 PLP and LAPB/LLC2.

--i specify interface to trace: /dev/llc2 the LLC interface for X.25 over LLC type 2.

/dev/lapb the LAPB interface for X.25 over synchronous point-to-point lines.

/dev/x25 the X.25 Packet Layer interface (the default).

-l specify single link to trace.

-t use absolute, not relative, time stamps.

filter_expression specifies one of the following filter expressions:

betweenmac trace packets between these.

dstmac trace only packets with this destination MAC address.

mac trace packets to or from this MAC address.

multicast trace only LLC2 packets with a multicast address.

pdu_in trace only incoming PDUs.

pdu_out trace only outgoing PDUs.

srcmac trace only packets or frames with this source address.

x25lcn + trace only packets on the next logical channel set up.

x25lcn n trace only packets on logical channel n.

You can use the logical operators (and, or, and not) with the expressions defined above.