Documentation Home
> Solstice X.25 9.2 Developer's Guide
Solstice X.25 9.2 Developer's Guide
Book Information
Preface
Part I Network Layer Interface (NLI)
Chapter 1 STREAMS Overview
1.1 Overview
Chapter 2 About NLI
2.1 NLI Overview
2.2 NLI Commands
2.3 NLI ioctls
2.4 Support Functions
2.5 Support for OSI Connection-Mode Network Service (OSI CONS)
2.6 Addressing
2.7 Facilities and QOS Parameters
2.8 Operating System Support
Chapter 3 Making and Receiving Calls
3.1 Making a Single Call
3.2 Receiving Data
3.3 Additional Call Information
3.3.1 Opening connections for OSI CONS Calls
3.3.2 Receiving Expedited Data
3.3.3 Dealing with Resets and Interrupts
3.3.3.1 Receiving a Remote Disconnect
Chapter 4 Listening for Calls
4.1 Listening for a Single Call
4.2 Listening for Multiple Incoming Calls
Chapter 5 Getting Statistics
5.1 Sample Program
Chapter 6 NLI Commands and Structures
6.1 Commands and Structures Tables
6.2 x25_primitives C Union
6.3 Generic Structures
6.3.1 xaddrf--Define Addressing
6.3.2 lsapformat--Define an LSAP
6.3.3 extraformat--Define Standard X.25 Facilities
6.3.4 qosformat--Define OSI CONS QOS Parameters
6.4 NLI Commands
6.4.1 N_Abort--Abort Indication
6.4.2 N_CC--Call Response/Confirmation
6.4.3 N_CI--Call Request/Indication
6.4.4 N_DAck--Data Ack Request/Indication
6.4.5 N_Data--Data
6.4.6 N_DC--Clear Confirm
6.4.7 N_DI--Clear Request/Indication
6.4.8 N_EAck--Expedited Data Acknowledgement
6.4.9 N_EData--Expedited Data
6.4.10 N_PVC_ATTACH--PVC Attach
6.4.11 N_PVC_DETACH--PVC Detach
6.4.12 N_RC--Reset Response/Confirm
6.4.13 N_RI--Reset Request/Indication
6.4.14 N_Xcanlis--Listen Cancel Command/Response
6.4.15 N_Xlisten--Listen Command/Response
Chapter 7 Network Layer ioctls
7.1 ioctls Functional Grouping
7.2 N_getlinkstats--Retrieve Per-Link Statistics
7.3 N_getoneVCstats --Retrieve Per-Virtual-Circuit Statistics
7.4 N_getpvcmap--Get PVC Default Packet/Window Sizes
7.5 N_getstats--Get X.25 Multiplexor Statistics
7.6 N_getVCstats--Get Per-Virtual-Circuit Statistics
7.7 N_getVCstatus--Get Per-Virtual-Circuit Statistics
7.8 N_linkconfig--Configure the wlcfg Database
7.9 N_linkent--Configure a Newly Linked Driver
7.10 N_linkmode--Alter the Characteristics of a Link
7.11 N_linkread --Read the wlcfg Database
7.12 N_nuidel--Delete Specified NUI Mapping
7.13 N_nuiget--Read the Mapping for a Specified NUI
7.14 N_nuimget--Read all Existing NUI Mappings
7.15 N_nuiput--Store a set of NUIs
7.16 N_nuireset --Delete all Existing NUI Mappings
7.17 N_putpvcmap--Change PVC Packet and Window Sizes
7.18 N_traceoff ioctl--Cancel N_traceon
7.19 N_traceon --Turn on Packet Level Tracing
7.20 N_X25_ADD_ROUTE--Set Fields of X25_ROUTE Structure
7.21 N_X25_FLUSH_ROUTES--Flush all Routes
7.22 N_X25_GET_ROUTE--Obtain Routing Information
7.23 N_X25_GET_NEXT_ROUTE--Get Next Routing Entry
7.24 N_X25_RM_ROUTE--Remove Route From X25_ROUTE
7.25 N_zerostats--Reset X.25 Multiplexor Statistics Count
Chapter 8 Support Functions
8.1 Linking to the Support Library
8.2 Function Summary
8.3 The padent Structure
8.4 The xhostent Structure
8.5 endpadent--Closes the PAD Hosts Database
8.6 endxhostent--Closes the xhosts File
8.7 equalx25--Compares two X.25 addresses
8.8 getnettype--Get Type of Network for a Link
8.9 getpadbyaddr--Get PAD Database Entry for Address
8.10 getpadent--Get Next Line in PAD Hosts Database
8.11 getxhostbyaddr--Get X.25 Host Name by Address
8.12 getxhostbyname--Get X.25 Address by Name
8.13 getxhostent--Reads Next Line of xhosts File
8.14 linkidtox25--Convert Link Identifier to Numeric Form
8.15 padtos--Convert PAD Database Structure Into String
8.16 setpadent--Open and Rewind the PAD Hosts Database
8.17 setxhostent--Open and Rewind the xhosts File
8.18 stox25--Convert X.25 Address to xaddrf Structure
8.19 x25_find_link_parameters--Finds Link Configuration Files and Builds a Linked List of Links
8.20 x25_read_config_parameters--Reads a Configuration File Into a Data Structure
8.21 x25_read_config_parameters_file--Reads a Configuration File Into a Data Structure
8.22 x25_save_link_parameters--Update Configuration Files
8.23 x25_set_parse_error_function--Install a Function as Default Error Handler
8.24 x25_write_config_parameters--Writes a Data Structure Into a Configuration File Identified by a Link Number
8.25 x25_write_config_parameters_file--Writes a Data Structure Into a Configuration File Identified by a Filename
8.26 x25tolinkid--Convert Numeric Link Identifier to String
8.27 x25tos--Convert xaddrf Structure to X.25 Address
Chapter 9 Error Codes
9.1 Originator and Reason Tables
9.2 Decoding Error Codes
Part II Data Link Protocol Interface (DLPI)
Chapter 10 About DLPI
10.1 How DLPI Works
10.2 Addressing
10.3 Running DLPI Over LAPB
10.4 Running DLPI Over LLC2
Chapter 11 DLPI Reference
11.1 DLPI Specific Message Primitives
11.1.1 Address Structures
11.1.1.1 LLC2 Address Structure
11.1.1.2 LAPB Address Structure
11.1.2 Message Primitive Sequence Summary
11.1.3 DL_ATTACH_REQ--Identifies Physical Link to use
11.1.4 DL_BIND_ACK--Acknowledges Bind Request
11.1.5 DL_BIND_REQ--Specifies CLNS or CONS Service
11.1.6 DL_CONNECT_CON--Acknowledge DL_CONNECT_REQ
11.1.7 DL_CONNECT_IND--Indicate Incoming Connection
11.1.8 DL_CONNECT_REQ--Establish a Connection
11.1.9 DL_CONNECT_RES--Accept a Connect Request
11.1.10 DL_DETACH_REQ--Undoes a Previous DL_ATTACH_REQ
11.1.11 DL_DISCONNECT_IND--Indicates Connection Disconnect
11.1.12 DL_DISCONNECT_REQ--Disconnects a Connection
11.1.13 DL_ERROR_ACK--Negative Acknowledgment
11.1.14 DL_INFO_ACK--Convey Info Summary
11.1.15 DL_INFO_REQ--Request Info Summary
11.1.16 DL_OK_ACK--Acknowledge Previous Primitive
11.1.17 DL_RESET_CON--Acknowledges DL_RESET_REQ
11.1.18 DL_RESET_IND--Indicates Remote Reset
11.1.19 DL_RESET_REQ--Request Connection Reset
11.1.20 DL_RESET_RES--Respond to Reset Request
11.1.21 DL_TOKEN_ACK--Acknowledges DL_TOKEN_REQ
11.1.22 DL_TOKEN_REQ--Assigns Token to Stream
11.1.23 DL_UNBIND_REQ--Summary
11.2 Sun-Specific ioctls
11.2.1 Common ioctls
11.2.1.1 L_GETTUNE--Retrieves Tunable Parameters for a PPA
11.2.1.2 L_SETTUNE--Sets Tunable Parameters for a PPA
11.2.2 LAPB ioctls
11.2.2.1 L_GETGSTATS--Reads Global Layer 2 Statistics
11.2.2.2 L_GETPPA--Returns the PPA Associated With a Stream
11.2.2.3 L_GETSTATS--Retrieves Per-Link Statistics
11.2.2.4 L_SETPPA--Associates a PPA With a Physical Device
11.2.2.5 L_ZEROSTATS--Clears the Per-Link Statistics Count
11.2.2.6 W_SETTUNE--Sets wanmod Tunable Parameters
Part III Socket Interface
Chapter 12 Compatibility with SunNet X.25 7.0 Sockets-Based Packet Level Interface
12.1 Introduction -- The AF_X25 Domain
12.2 AF_X25 Domain Addresses
12.3 Creating Switched Virtual Circuits
12.3.1 Calling Side -- Outgoing Call Setup
12.3.2 Calling Side -- Setting the Local Address
12.3.3 Called Side -- Incoming Call Acceptance
12.3.4 Address Binding
12.3.5 Binding by PID/CUDF
12.3.6 Masking Incoming Protocol Ids at Bit Level
12.3.7 AEF Matching Considerations
12.3.8 Explicit Link Selection--Calling Side
12.3.9 Explicit Link Selection--Called Side
12.3.10 Accessing the Local and Remote Addresses
12.3.11 Finding the Link Used for a Virtual Circuit
12.3.12 Determining the LCN for a Connection
12.4 Sending Data
12.4.1 Control of the M-, D-, and Q-bits
12.4.2 Sending Interrupt and Reset Packets
12.5 Receiving Data
12.5.1 In-Band Data
12.5.2 Reading the M-, D-, and Q-bits
12.5.3 Receiving X.25 Messages in Records
12.5.4 Out-of-Band Data
12.6 Clearing a Virtual Circuit
12.7 Advanced Topics
12.7.1 Facility Specification and Negotiation
12.7.2 X25_SET_FACILITY/X25_GET_FACILITY ioctls
12.7.2.1 Reverse Charge
12.7.2.2 Fast Select
12.7.2.3 Packet Size
12.7.2.4 Window Size
12.7.2.5 Throughput
12.7.2.6 Minimum Throughput Class
12.7.2.7 Closed User Group
12.7.2.8 RPOA Selection
12.7.2.9 Network Transit Delay
12.7.2.10 End-to-End Transit Delay
12.7.2.11 Network User Identification
12.7.2.12 Charging Information Request
12.7.2.13 Charging Information
12.7.2.14 Called Line Address Modified Notification
12.7.2.15 Call Redirection Notification
12.7.2.16 Expedited Data Negotiation
12.7.2.17 Called/Calling AEF
12.7.2.18 Non-X.25 Facilities
12.7.2.19 Determining Which Facilities are Present
12.7.3 Fast Select User Data
12.7.3.1 Calling Side
12.7.3.2 Called Side
12.7.4 Permanent Virtual Circuits
12.7.5 Call Acceptance by User
12.7.6 Accessing the Link (X.25) Address
12.7.7 Accessing High Water Marks of Socket
12.7.8 Accessing the Diagnostic Code
12.8 Routing ioctls
12.9 Miscellaneous ioctls
12.9.1 Obtaining Statistics
12.9.1.1 Obtaining Version Number
Chapter 13 Sockets Programming Example
13.1 Include Files for User Programs
13.2 Compilation Instructions and Sample Programs
13.3 Structures Used by the X25_SET_FACILITY and X25_GET_FACILITY ioctl Commands
Index
Numbers and Symbols
A
B
C
D
E
F
G
H
I
L
M
N
O
P
Q
R
S
T
U
V
W
X
© 2010, Oracle Corporation and/or its affiliates