Solstice X.25 9.2 Developer's Guide

7.10 N_linkmode--Alter the Characteristics of a Link

This ioctl is used to read or change the SUB_MODES Member of a particular wlcfg database appropriate to a link. This configuration ioctl is used to alter characteristics of a link's operation, for example, to temporarily bar incoming calls.


Note -

This ioctl affects currently open connections and could therefore disrupt users significantly. For this reason it can only be used by root.


Associated Structure

The parameters are carried as the M_DATA part of the N_linkmode ioctl as follows:

struct linkoptformat {
        uint32_t   U_LINK_ID;
        unsigned short  newSUB_MODES;
        unsigned char   rd_wr;
};

The members of the linkoptformat structure are:

Table 7-26 linkoptformat fields

Member 

Description 

newSUB_MODE

This is the new SUB_MODES value in a write ioctl or the current value in a read ioctl.

U_LINK_ID

This identifies the particular link and must match one of the wlcfg database entries.

rd_wr

This determines read or write mode. A value of zero indicates read while non-zero indicates write. 

In the case of read, the same structure is returned with the current value of SUB_MODES for the link.