Solstice X.25 9.2 Developer's Guide

7.15 `N_nuiput`--Store a set of NUIs

This ioctl is used to store a set of Network User Identifiers (NUIs) and associated facilities mappings within the X.25 multiplexor. It is used in conjunction with the NUI override facility option.

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 following structures are associated with this ioctl:

struct nui_put {
         char    prim_class;     /* Always NUI_MSG                       */
         char    op;             /* Always NUI_ENT                       */
         struct nuiformat       nuid;           /* NUI                  */
        struct facformat      nuifacility;    /* NUI facilities    */
 };

The members of the nui_put structure are:

Table 7-30 nui_put fields


Member	Description
`prim_class`	This is always set to `NUI_MSG`.
`op`	This is always set to `NUI_ENT`.
`nuid`	The Network User Identifier of the entry you want to store. This is stored in the `nuiformat` structure.
`nuifacility`	Any relevant NUI facilities. These are stored in the `facformat` structure.

The nuiformat structure looks like this:

#define NUIMAXSIZE	64
 #define NUIFACMAXSIZE	32
 struct nuiformat {
   unsigned char nui_len;
   unsigned char nui_string[NUIMAXSIZE]; /* Network User Identifier */
 };

The members of the nuiformat structure are

Table 7-31 nuiformat fields


Member	Description
`nui_len`	The length of the NUI.
`nui_string`	The NUI itself.

The facformat structure looks like this:

struct facformat {
   unsigned short SUB_MODES;	/* Mode tuning bits for net */
   unsigned char  LOCDEFPKTSIZE;	/* Local default pkt size */
   unsigned char  REMDEFPKTSIZE;	/* Local default pkt size */
   unsigned char  LOCDEFWSIZE;	/* Local default window size */
   unsigned char  REMDEFWSIZE;	/* Local default window size */
   unsigned char  locdefthclass;	/* Local default value         */
   unsigned char  remdefthclass;	/* Remote default value        */
   unsigned char  CUG_CONTROL;	/* CUG facilities */
 };

The members of the facformat structure are:

Table 7-32 facformat fields


Member	Description
`SUB_MODES`	The subscription options for a PSDN link. Possible values and meanings are: `SUB_EXTENDED` Subscribe to extended call packets.This allows for packet and window size negotiation. `BAR_EXTENDED` Treat incoming extended call packets as a procedure error. `SUB_FSELECT` Subscribe to fast select with no restriction on response. This applies to INCOMING CALL packets. `SUB_FSRRESP` Subscribe to fast select with restriction on response. This applies to `INCOMING CALL` packets. `SUB_REVCHARGE` Subscribe to reverse charging. This applies to `INCOMING CALL` packets. `SUB_LOC_CHG_PREV` Subscribe to local charging prevention. This overrides the setting of `SUB_REVCHARGE`. `SUB_TOA_NPI_FMT` Subscribe to using TOA/NPI address format. `BAR_TOA_NPI_FMT` Treat incoming TOA/NPI address formats as a procedure error. `SUB_NUI_OVERRIDE` Subscribe to NUI override. This specifies that when an NUI is provided in a `CALL REQUEST`, any associated subscription time options override the facilities which apply to the interface, for the duration of that particular call. `BAR_INCALL` Bar incoming calls. `BAR_OUTCALL` Bar outgoing calls.
`LOCDEFPKTSIZE`	Local default packets size
`REMDEFPKTSIZE`	Remote default packet size
`LOCDEFWSIZE`	Local default window size
`REMDEFWSIZE`	Remote default window size
`locdefthclass`	Local default value
`remdefthclass`	Remote default value
`CUG_CONTROL`	CUG facilities

7.15 N_nuiput--Store a set of NUIs

Associated Structure

7.15 `N_nuiput`--Store a set of NUIs