OpenSS7 XNS/XTI Library Reference Manual

OpenSS7 XNS/XTI Library

Reference ManualVersion 1.1 Edition 7.20141001

Updated October 25, 2014Distributed with Package openss7-1.1.7.20141001

Copyright c© 2008-2014 Monavacon LimitedAll Rights Reserved.

Brian Bidulock <bidulock@openss7.org> for

The OpenSS7 Project <http://www.openss7.org/>

Published by:

OpenSS7 Corporation1469 Jefferys CrescentEdmonton, Alberta T6L 6T1Canada

Copyright c© 2008-2014 Monavacon LimitedCopyright c© 2001-2008 OpenSS7 CorporationCopyright c© 1997-2000 Brian F. G. Bidulock

All Rights Reserved.

Unauthorized distribution or duplication is prohibited.

Permission is granted to copy, distribute and/or modify this document under the terms of theGNU Free Documentation License, Version 1.3 or any later version published by the Free SoftwareFoundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copyof the license is included in the section entitled Section A.2 [GNU Free Documentation License],page 75.

Permission to use, copy and distribute this documentation without modification, for any purposeand without fee or royalty is hereby granted, provided that both the above copyright notice andthis permission notice appears in all copies and that the name of OpenSS7 Corporation not beused in advertising or publicity pertaining to distribution of this documentation or its contentswithout specific, written prior permission. OpenSS7 Corporation makes no representation aboutthe suitability of this documentation for any purpose. It is provided “as is” without express orimplied warranty.

Notice:

OpenSS7 Corporation disclaims all warranties with regard to this documentation including all im-plied warranties of merchantability, fitness for a particular purpose, non-infringement, or title; thatthe contents of the document are suitable for any purpose, or that the implementation of suchcontents will not infringe on any third party patents, copyrights, trademarks or other rights. In noevent shall OpenSS7 Corporation be liable for any direct, indirect, special or consequential dam-ages or any damages whatsoever resulting from loss of use, data or profits, whether in an action ofcontract, negligence or other tortious action, arising out of or in connection with any use of thisdocument or the performance or implementation of the contents thereof.

i

Short Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1 Introduction to the XTI Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3 Conformance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

4 Multi-Threading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

5 Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

6 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

7 Bugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

A Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

B Indices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

iii

Table of Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Sponsors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Contributors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Supporters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Telecommunications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Aerospace and Military . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Financial, Business and Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Education, Health Care and Nuclear Power . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Agencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1 Introduction to the XTI Library . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72.2 XTI Function Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

t accept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.2.2 t addleaf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.2.3 t alloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142.2.4 t bind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.2.5 t close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.2.6 t connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.2.7 t errno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.2.8 t error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192.2.9 t free . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202.2.10 t getinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212.2.11 t geprotaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222.2.12 t getstate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.2.13 t listen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242.2.14 t look . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252.2.15 t open . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262.2.16 t optmgmt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272.2.17 t rcv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282.2.18 t rcvconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292.2.19 t rcvdis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302.2.20 t rcvleafchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312.2.21 t rcvrel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322.2.22 t rcvreldata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332.2.23 t rcvudata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342.2.24 t rcvuderr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352.2.25 t rcvv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362.2.26 t rcvvudata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372.2.27 t removeleaf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382.2.28 t snd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392.2.29 t snddis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402.2.30 t sndrel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412.2.31 t sndreldata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

iv OpenSS7 XNS/XTI Library

2.2.32 t sndudata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432.2.33 t sndv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442.2.34 t sndvudata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452.2.35 t strerror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462.2.36 t sync . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472.2.37 t sysconf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482.2.38 t unbind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

2.3 XTI Header File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502.3.1 xti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512.3.2 xti ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522.3.3 xti mtp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532.3.4 xti sccp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542.3.5 xti sctp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552.3.6 xti ss7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562.3.7 xti sccop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572.3.8 xti tcap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582.3.9 xti tcp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592.3.10 xti udp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

3 Conformance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

4 Multi-Threading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

5 Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

6 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

7 Bugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Appendix A Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71A.1 GNU Lesser General Public License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

A.1.1 Terms and Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72A.2 GNU Free Documentation License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Appendix B Indices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83B.1 Concept Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84B.2 Type Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85B.3 Function and Macro Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86B.4 Variable and Constant Macro Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87B.5 Program and File Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

OpenSS7 XNS/XTI Library Preface

Preface

Acknowledgements

As with most open source projects, this project would not have been possible without the valiantefforts and productive software of the Free Software Foundation, the Linux Kernel Community, andthe open source software movement at large.

Sponsors

Funding for completion of the OpenSS7 OpenSS7 package was provided in part by:

• Monavacon Limited• OpenSS7 Corporation

Additional funding for The OpenSS7 Project was provided by:

• Monavacon Limited • OpenSS7 Corporation• AirNet Communications • Comverse Ltd.• eServGlobal (NZ) Pty Ltd. • Excel Telecommunications• France Telecom • GeoLink SA• HOB International • Lockheed Martin Co.• Motorola • NetCentrex S. A.• Newnet Communications • Nortel Networks• Peformance Technologies • Sonus Networks Inc.• SS8 Networks Inc. • SysMaster Corporation• TECORE • Tumsan Oy• Verisign • Vodare Ltd.

Contributors

The primary contributor to the OpenSS7 OpenSS7 package is Brian F. G. Bidulock. The followingis a list of notable contributors to The OpenSS7 Project:

− Per Berquist − Kutluk Testicioglu− John Boyd − John Wenker− Chuck Winters − Angel Diaz− Peter Courtney − Jeremy Compostella− Tom Chandler − Sylvain Chouleur− Gurol Ackman − Christophe Nolibos− Pierre Crepieux − Bryan Shupe− Christopher Lydick − D. Milanovic− Omer Tunali − Tony Abo− John Hodgkinson − Others

Supporters

Over the years a number of organizations have provided continued support in the form of assessment,inspection, testing, validation and certification.

Telecommunications

• Integrated Telecom Solutions • AASTRA• Accuris Networks • Aculab• Adax • AEPONA

2014-10-25 1

Preface texi/funding.texi

• AirNet Communications • Airwide Solutions• Alacre • Alcatel• Alcatel-Lucent • Altobridge• Anam • Apertio (now Nokia)• Alaska Power & Telephone • Aricent• Artesyn (now Emerson) • Arthus Technologies• Bharti Telesoft • BubbleMotion• Continuous Computing (Trillium) • Cellnext Solutions Limited• Cisco • Codent Networks• Cogeco Cable Inc. • Comverse Ltd.• Condor Networks • Coral Telecom• Corecess • Corelatus• Cosini • Data Connection• Datacraft • Datatek Applications Inc.• Datatronics • Dialogic• Digium • Druid Software• DTAG (Deutsche Telecom AG) • Empirix• Engage Communication Inc. • Ericsson• eServGlobal (NZ) Pty Ltd. • ETSI• Excel Telecommunications • Flextronics (now Aricent)• France Telecom • Gemini Mobile Technologies• Geolink (now SeaMobile) • Global Edge• Huawei • IBSYS Canada• Integral Access (now Telco Systems) • Integrat Mobile Aggregation Services• Kineto Wireless • Lucent• Maestro Communications • MCI• Mindspeed • Mobis• Mobixell • Motivity Telecom• Motorola • Mpathix Inc.• m-Wise Inc. • Myriad Group• Net2Phone • NetCentrex S. A.• NetTest A/S (now Anritsu) • NeuvaTel PCS• Newnet Communications • NMS (now Dialogic)• Noble Systems Corporation • Nokia• Nortel Networks • j2 Global Communications• OnMobile • Orange• Ouroboros • P3 Solutions GmbH• Primal Technologies Inc. • Propolys Pte Ltd.• Peformance Technologies • Pulse Voice Inc.• Reliance Communications • Roamware Inc.• SONORYS Technology GmbH • Sonus Networks Inc.• Spider Ltd. (now Emerson) • SS8 Networks Inc.• Oasis Systems • Stratus• Stratus Technologies Bermuda Ltd. • Sicap AG• Switchlab Ltd. • Synapse Mobile Networks SA• SysMaster Corporation • Tata Communications• Tecore • Tekno Telecom LLC• Telcordia • Telecom Italia• Teledesign • Telemetrics Inc.

2 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Preface

• Telnor • TE-Systems• Texas Instruments Inc. • Tumsan Oy• Ulticom • Vanu Inc.• Vecto Communications SRL • Veraz Networks• VeriSign • Vodare Ltd.• VSE NET GmbH • The Software Group Limited• WINGcon GmbH • Wipro Technologies• Xentel Inc. • YCOM SA• ZTE Corporation

Aerospace and Military

• Advanced Technologies • Altobridge• Altobridge • BBN (Bolt, Beranek, and Neuman)• ARINC • Boldon James• ATOS Origin • Lockheed Martin Co.• Boeing • Northrop Grumman Corporation• Boldon James • QinetiQ• CRNA • SAAB• DSNA-DGAC1 • Sandia National Laboratories• DLR2 • Thales• DSNA-DTI • Wright-Patterson Air Force Base• Egis-Avia (Sofreavia)• MetaSlash• Sofreavia• FAA WJHTC3

• Thales ATM/Air Systems

Financial, Business and Security

• Alebra • Alebra• Automated Trading Desk (now Citi) • Boldon James• Banco Credicoop • Fujitsu-Seimens• BeMac • FutureSoft• Boldon James • GSX• CyberSource Corporation • HOB International• Fujitsu-Seimens • HP (Hewlett-Packard)• FutureSoft • IBM• Gcom• GSX• HOB International• HP (Hewlett-Packard)• IBM• Lightbride (now CyberSource)• MasterCard • Alert Logic• Network Executive Software Inc. • Apani• Packetware Inc. • BeMac

1 La Direction des Services de la Navigation Aerienne - La Direction General de l’Aviation Civile2 Deutsches Zentrum fur Luft- unde Raumfarht3 Federal Aviation Administration - William J. Hughes Technical Center

2014-10-25 3

Preface

• Packetware Inc. • ERCOM• Prism Holdings Ltd. • Hitech Systems• S2 Systems (now ACI) • iMETRIK• Symicron Computer CommunicationsLimited

• Intrado Inc.

Education, Health Care and Nuclear Power

• IEEE Computer Society • Ateb• ENST4 • Mandexin Systems Corporation• HTW-Saarland5

• Kansas State University • Areva NP• University of North Carolina Charlotte • European Organization for Nuclear Re-

search

Agencies

It would be difficult for the OpenSS7 Project to attain the conformance and certifications that ithas without the free availability of specifications documents and standards from standards bodiesand industry associations. In particular, the following:

• 3GPP (Third Generation Partnership Project)• ATM Forum• EIA/TIA (Electronic Industries Alliance)• ETSI (European Telecommunications Standards Institute)• ICAO (International Civil Aviation Organization)• IEEE (Institute of Electrical and Electronic Engineers)• IETF (The Internet Engineering Task Force)• ISO (International Organization for Standardization)• ITU (International Telecommunications Union)• Mulutiservices Forum• The Open Group

Of these, ICAO, ISO, IEEE and EIA have made at least some documents publicly available. ANSIis notably missing from the list: at one time draft documents were available from ANSI (ATIS), butthat was curtailed some years ago. Telecordia does not release any standards publicly. Hopefullythese organizations will see the light and realize, as the others have, that to remain current as astandards organization in today’s digital economy requires providing individuals with free access todocuments.

4 Ecole Nationale Superieure des Telecommunications5 Hochschule fur Technik und Wirtschaft des Saarlandes

4 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Introduction to the XTI Library

1 Introduction to the XTI Library

This manual documents how to run, install and port the OpenSS7 XTI Library, and how to reportbugs.

2014-10-25 5

OpenSS7 XNS/XTI Library Reference

2 Reference

2.1 Overview

2.2 XTI Function Reference

2014-10-25 7

Chapter 2: Reference

t accept

NAME

t accept - accept a connection request

SYNOPSIS

#include <xti.h>

int t_accept(int fd, int resfd, struct t_call *call);

ARGUMENTS

fd the transport endpoint upon which a connection indication was received.

resfd the transport endpoint upon which to accept the connection.

call a pointer to a t call structure containing information about the responding endpointand any data to be transferred in response.

DESCRIPTION

The fd argument is an integer file descriptor specifying the stream upon which a previous connec-tion indication was received with t listen(3), and for which the connection indication is to now beaccepted.

The resfd argument is an integer file descriptor specifying the stream upon which to accept thetransport connection. resfd can be the same as fd or different. When resfd is different from fd, thecaller specifies that the connection is to be accepted on the stream associated with resfd. Whenresfd is different from fd, the stream associated with resfd must be an XTI/TLI[1..3] stream on thesame transport provider that is either in the T_UNBND state, or is in the T_IDLE state and bound tothe same address as the responding address.

The call argument is a pointer to a t call structure, specifying the responding address, addr, theresponse options, opt, and any response user data, udata. format ted as follows:

struct t_call {

struct netbuf addr; /* address */

struct netbuf opt; /* options */

struct netbuf udata; /* data */

int sequence; /* identification */

};

The addr, opt and udata members of the t call structure are netbuf(3) structures, each formattedas follows:

struct netbuf {

unsigned int maxlen; /* max length */

unsigned int len; /* current length */

char *buf; /* data */

};

addr A netbuf(3) structure that specifies the responding address. The responding addressis the address accepting the connection. call->addr.maxlen is set to zero (0) by thecaller and ignored by the provider. call->addr.len is set to the length of the respond-ing address. If the length of the responding address is zero (0) then the destination

8 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

address of the connection indication is used as the responding address. call->addr.buf points to the responding address.

opt A netbuf(3) structure that specifies the responding options. The responding optionscan be both end-to-end and local transport options. call->opt.maxlen is set to zero(0) by the caller and is ignored by the provider. call->opt.len is set to the length ofthe options. If the length of the responding options is zero (0) no options are specified.call->opt.buf points to the options.

udata A netbuf(3) structure that specifies the data to send with the connection response.call->udata.maxlen is set to zero (0) by the caller and is ignored by the provider.call->udata.len is set to the length of the data. If the length of the data is zero (0)no data is included in the response message. call->udata.buf points to the data.

sequence specifies a sequence number of the connection indication that is to be accepted. Thisvalue was returned by a previous call to t lis ten(3).

CAVEATS

t accept() is only valid in state T_INCON with an out standing number of connection indicationsgreater than zero (0).

t accept() is only valid for transport service providers of service type T_COTS or T_COTS_ORD.

RETURN VALUE

Upon success, t accept() returns zero (0). Upon failure, t accept() returns -1 and sets t errno(3) toan appropriate error number.

ERRORS

When t accept() fails, it returns -1 and sets t errno(3) to an appropriate error number as follows:

[TACCES] The caller did not have sufficient permissions to accept a connection on the resfd filedescriptor, or did not have sufficient permissions to use the responding address specifiedin call->addr.

[TBADADDR]

The address specified was of an invalid format or contained invalid information. Thiserror is returned from the transport service provider.

[TBADDATA]

The amount of data specified for the call and underlying transport service providerwas invalid (i.e. was outside the protocol limits). See t getinfo(3) and t open(3) formore information.

[TBADF] The fd or resfd file descriptor was invalid.

[TBADOPT] The options specified were of an invalid for mat or contained invalid information. Thiserror is returned from the transport service provider. See t optmgmt(3) for moreinformation on option formats.

[TBADSEQ] The sequence number provided was invalid, or is not associated with an outstandingconnection indication.

[TINDOUT] The file descriptor resfd has outstanding connection indications.

[TLOOK] An asynchronous event occurred before the call could complete. See t look(3) for moreinformation.

2014-10-25 9

Chapter 2: Reference

[TNOTSUPPORT]

The call requires the use of a TLI primitive not supported by the underlying transportprovider.

[TOUTSTATE]

The call was issued with the interface in an incorrect state.

[TPROTO] A protocol error occurred between the XTI library and the underlying transportprovider.

[TPROVMISMATCH]

The transport provider associated with resfd is not the same as the transport providerassociated with fd.

[TRESADDR]

The file descriptor resfd was bound to a different address than the responding address.

[TRESQLEN]

The file descriptor resfd is listening (i.e. it was bound with a qlen > 0).

[TSYSERR] A Linux system error occurred and the Linux error number is set in errno(3).

SEE ALSO

netbuf(3), t listen(3).

CONFORMING TO

XTI/TLI[4], TPI[5], XPG5, XNS 5.2[6], SUSv2[7].

REFERENCES

Trademarks mentioned are the property of their owners.

VERSIONS

OpenSS7 XTI Library: $Name: $($Revision: 1.1.2.2 $); $Date: 2011-02-07 02:21:33 $.

AUTHOR

Brian F. G. Bidulock bidulock@openss7.org

The OpenSS7 Project http://www.openss7.org/

COPYRIGHT

Copyright c© 1997-2008 OpenSS7 Corporation.All Rights Reserved.(See roff source for permission notice.)

TRADEMARKS

Linux is a registered trademark of Linus TorvaldsUNIX is a registered trademark of The Open Group.OpenSS7tm is a trademark of OpenSS7 Corporation.Other trademarks are the property of their respective owners.

10 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.2 t addleaf

NAME

t addleaf - add a point to a point to multi-point connection

SYNOPSIS

#include <xti.h>

int t_addleaf(int fd, int leafid, struct netbuf *addr);

ARGUMENTS

fd the transport endpoint to which to add a leaf.

leafid the identifier for the leaf.

addr a pointer to a netbuf(3) structure containing the address of the leaf.

DESCRIPTION

Requests that an endpoint be added to a point to multi-point connection.

fd is the file descriptor of the local transport endpoint.

leafid is a transport user assigned integer value which will be used to identify the point added tothe point to multi-point connection in subsequent interactions with the transport user.

addr is a netbuf(3) structure specifying on call the address of the local point being added to thepoint to multi-point connection. No information is returned in addr. ‘addr->maxlen’ is ignored bythe call. ‘addr->len’ is the length of the address. If ‘addr->len’ is zero, it indicates that no addressis provided. ‘addr->buf’ is a pointer to the user buffer containing the address.

CAVEATS

t addleaf() is only valid in the T DATAXFER state.

t addleaf() is only valid for transport service providers of service type T COTS or T COTS ORDthat support point to multi-point connection management.

In synchronous mode, t addleaf() blocks until a leaf change confirmation is received. In asynchronousmode where no leaf change confirmation is immediately available, t addleaf() fails, returns -1 andsets t errno(3) to [TNODATA].

RETURN VALUE

Upon success, t addleaf() returns zero (0) and confirms the addition of the requested leaf. Uponfailure, t addleaf() returns -1 and sets t errno(3) to an appropriate error number.

ERRORS

When t addleaf() fails, it returns -1 and sets t errno(3) to an appropriate error number as follows:

[TBADF] fd is invalid.

[TADDRBUSY]

address specificed was already in use by another transport endpoint.

[TBADADDR]

address specified was of an invalid format or contained invalid information.

2014-10-25 11

Chapter 2: Reference

[TLOOK] asynchronous event occurred before the call could complete. See Section 2.2.14 [t˙look],page 25, for more information.

[TNOADDR] address was not specified and the transport provider could not assign one.

[TNODATA] attempt was made to read the add leaf confirmation but no add leaf confirmation wasavailable.

[TNOTSUPPORT]

call requires the use of a TLI primitive not supported by the underlying transportprovider.

[TOUTSTATE]

call was issued with the interface in an incorrect state.

[TPROTO] protocol error occurred between the XTI library and the underlying transport provider.

[TSYSERR] Linux system error occurred and the Linux error number is set in errno(3).

SEE ALSO

netbuf(3), t rcvleafchange(3), t removeleaf(3).

CONFORMING TO

XTI/TLI[1], TPI[2], XPG5, XNS 5.2[3], SUSv2[4].

REFERENCES

1. XOpen Transport Interface, n.d., XPG, X Programmer’s Group. <http://www.open-group.org/onlinepubs/>

2. Transport Provider Interface (TPI) Specification, Draft 2, 1999, (Parsippany, New Jersey),Open Group, Open Group Publication. <http://www.opengroup.org/onlinepubs/>

3. Technical Standard: Network Services (XNS), 1999, Open Group, Open Group Publication.[ISBN 1-85912-241-8] <http://www.opengroup.org/onlinepubs/>

4. Single UNIX Specification, Open Group, Open Group Publication. <http://www.open-group.org/onlinepubs/>

Trademarks mentioned are the property of their owners.

VERSIONS

Linux Fast-STREAMS: $Name: $($Revision: 1.1.2.2 $); $Date: 2011-02-07 02:21:33 $.

AUTHOR

Brian F. G. Bidulock <bidulock@openss7.org>The OpenSS7 Project http://www.openss7.org/

COPYRIGHT

Copyright (C) 1997-2008 OpenSS7 Corporation.All Rights Reserved.(See roff source for permission notice.)

12 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

TRADEMARKS

OpenSS7tm is a trademark of OpenSS7 Corporation.LinuxR© is a registered trademark of Linus Torvalds.UNIXR© is a registered trademark of The Open Group.SolarisR© is a registered trademark of Sun Microsystems.Other trademarks are the property of their respective owners.

2014-10-25 13

Chapter 2: Reference

2.2.3 t alloc

14 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.4 t bind

2014-10-25 15

Chapter 2: Reference

2.2.5 t close

16 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.6 t connect

2014-10-25 17

Chapter 2: Reference

2.2.7 t errno

18 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.8 t error

2014-10-25 19

Chapter 2: Reference

2.2.9 t free

20 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.10 t getinfo

2014-10-25 21

Chapter 2: Reference

2.2.11 t geprotaddr

22 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.12 t getstate

2014-10-25 23

Chapter 2: Reference

2.2.13 t listen

24 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.14 t look

2014-10-25 25

Chapter 2: Reference

2.2.15 t open

26 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.16 t optmgmt

2014-10-25 27

Chapter 2: Reference

2.2.17 t rcv

28 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.18 t rcvconnect

2014-10-25 29

Chapter 2: Reference

2.2.19 t rcvdis

30 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.20 t rcvleafchange

2014-10-25 31

Chapter 2: Reference

2.2.21 t rcvrel

32 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.22 t rcvreldata

2014-10-25 33

Chapter 2: Reference

2.2.23 t rcvudata

34 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.24 t rcvuderr

2014-10-25 35

Chapter 2: Reference

2.2.25 t rcvv

36 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.26 t rcvvudata

2014-10-25 37

Chapter 2: Reference

2.2.27 t removeleaf

38 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.28 t snd

2014-10-25 39

Chapter 2: Reference

2.2.29 t snddis

40 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.30 t sndrel

2014-10-25 41

Chapter 2: Reference

2.2.31 t sndreldata

42 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.32 t sndudata

2014-10-25 43

Chapter 2: Reference

2.2.33 t sndv

44 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.34 t sndvudata

2014-10-25 45

Chapter 2: Reference

2.2.35 t strerror

46 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.36 t sync

2014-10-25 47

Chapter 2: Reference

2.2.37 t sysconf

48 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.2.38 t unbind

2014-10-25 49

Chapter 2: Reference

2.3 XTI Header File Reference

50 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.3.1 xti

2014-10-25 51

Chapter 2: Reference

2.3.2 xti ip

52 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.3.3 xti mtp

2014-10-25 53

Chapter 2: Reference

2.3.4 xti sccp

54 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.3.5 xti sctp

2014-10-25 55

Chapter 2: Reference

2.3.6 xti ss7

56 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.3.7 xti sccop

2014-10-25 57

Chapter 2: Reference

2.3.8 xti tcap

58 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Reference

2.3.9 xti tcp

2014-10-25 59

Chapter 2: Reference

2.3.10 xti udp

60 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Conformance

3 Conformance

This section lists the standards conformance of the OpenSS7 XTI Library.

2014-10-25 61

OpenSS7 XNS/XTI Library Multi-Threading

4 Multi-Threading

2014-10-25 63

OpenSS7 XNS/XTI Library Error Handling

5 Error Handling

This chapter describes error handling in the XTI Library.

2014-10-25 65

OpenSS7 XNS/XTI Library Installation

6 Installation

This chapter describes configuration, compilation and installation of the XTI library.

2014-10-25 67

OpenSS7 XNS/XTI Library Bugs

7 Bugs

This is a description of the known bugs, installation troubles, known causes of trouble, troubleshoot-ing.

2014-10-25 69

OpenSS7 XNS/XTI Library Licenses

Appendix A Licenses

2014-10-25 71

Appendix A: Licenses texi/lgpl3.texi

A.1 GNU Lesser General Public License

GNU LESSER GENERAL PUBLIC LICENSEVersion 3, 29 June 2007

Copyright c© 2007 Free Software Foundation, Inc. http://fsf.org/

Everyone is permitted to copy and distribute verbatim copies of thislicense document, but changing it is not allowed.

A.1.1 Terms and Conditions

This version of the GNU Lesser General Public License incorporates the terms and conditions ofversion 3 of the GNU General Public License, supplemented by the additional permissions listedbelow.

0. Additional Definitions.

As used herein, “this License” refers to version 3 of the GNU Lesser General Public License,and the “GNU GPL” refers to version 3 of the GNU General Public License.

“The Library” refers to a covered work governed by this License, other than an Application ora Combined Work as defined below.

An “Application” is any work that makes use of an interface provided by the Library, but whichis not otherwise based on the Library. Defining a subclass of a class defined by the Library isdeemed a mode of using an interface provided by the Library.

A “Combined Work” is a work produced by combining or linking an Application with theLibrary. The particular version of the Library with which the Combined Work was made isalso called the “Linked Version”.

The “Minimal Corresponding Source” for a Combined Work means the Corresponding Sourcefor the Combined Work, excluding any source code for portions of the Combined Work that,considered in isolation, are based on the Application, and not on the Linked Version.

The “Corresponding Application Code” for a Combined Work means the object code and/orsource code for the Application, including any data and utility programs needed for reproducingthe Combined Work from the Application, but excluding the System Libraries of the CombinedWork.

1. Exception to Section 3 of the GNU GPL.

You may convey a covered work under sections 3 and 4 of this License without being bound bysection 3 of the GNU GPL.

2. Conveying Modified Versions.

If you modify a copy of the Library, and, in your modifications, a facility refers to a function ordata to be supplied by an Application that uses the facility (other than as an argument passedwhen the facility is invoked), then you may convey a copy of the modified version:

a. under this License, provided that you make a good faith effort to ensure that, in theevent an Application does not supply the function or data, the facility still operates, andperforms whatever part of its purpose remains meaningful, or

b. under the GNU GPL, with none of the additional permissions of this License applicableto that copy.

72 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Licenses

3. Object Code Incorporating Material from Library Header Files.

The object code form of an Application may incorporate material from a header file that is partof the Library. You may convey such object code under terms of your choice, provided that,if the incorporated material is not limited to numerical parameters, data structure layouts andaccessors, or small macros, inline functions and templates (ten or fewer lines in length), you doboth of the following:

a. Give prominent notice with each copy of the object code that the Library is used in it andthat the Library and its use are covered by this License.

b. Accompany the object code with a copy of the GNU GPL and this license document.

4. Combined Works.

You may convey a Combined Work under terms of your choice that, taken together, effectivelydo not restrict modification of the portions of the Library contained in the Combined Workand reverse engineering for debugging such modifications, if you also do each of the following:

a. Give prominent notice with each copy of the Combined Work that the Library is used init and that the Library and its use are covered by this License.

b. Accompany the Combined Work with a copy of the GNU GPL and this license document.

c. For a Combined Work that displays copyright notices during execution, include the copy-right notice for the Library among these notices, as well as a reference directing the userto the copies of the GNU GPL and this license document.

d. Do one of the following:

0. Convey the Minimal Corresponding Source under the terms of this License, and theCorresponding Application Code in a form suitable for, and under terms that permit,the user to recombine or relink the Application with a modified version of the LinkedVersion to produce a modified Combined Work, in the manner specified by section 6of the GNU GPL for conveying Corresponding Source.

1. Use a suitable shared library mechanism for linking with the Library. A suitablemechanism is one that (a) uses at run time a copy of the Library already present onthe user’s computer system, and (b) will operate properly with a modified version ofthe Library that is interface-compatible with the Linked Version.

e. Provide Installation Information, but only if you would otherwise be required to providesuch information under section 6 of the GNU GPL, and only to the extent that suchinformation is necessary to install and execute a modified version of the Combined Workproduced by recombining or relinking the Application with a modified version of the LinkedVersion. (If you use option 4d0, the Installation Information must accompany the MinimalCorresponding Source and Corresponding Application Code. If you use option 4d1, youmust provide the Installation Information in the manner specified by section 6 of the GNUGPL for conveying Corresponding Source.)

5. Combined Libraries.

You may place library facilities that are a work based on the Library side by side in a singlelibrary together with other library facilities that are not Applications and are not covered bythis License, and convey such a combined library under terms of your choice, if you do both ofthe following:

a. Accompany the combined library with a copy of the same work based on the Library,uncombined with any other library facilities, conveyed under the terms of this License.

2014-10-25 73

Appendix A: Licenses

b. Give prominent notice with the combined library that part of it is a work based on theLibrary, and explaining where to find the accompanying uncombined form of the samework.

6. Revised Versions of the GNU Lesser General Public License.

The Free Software Foundation may publish revised and/or new versions of the GNU LesserGeneral Public License from time to time. Such new versions will be similar in spirit to thepresent version, but may differ in detail to address new problems or concerns.

Each version is given a distinguishing version number. If the Library as you received it specifiesthat a certain numbered version of the GNU Lesser General Public License “or any later version”applies to it, you have the option of following the terms and conditions either of that publishedversion or of any later version published by the Free Software Foundation. If the Library asyou received it does not specify a version number of the GNU Lesser General Public License,you may choose any version of the GNU Lesser General Public License ever published by theFree Software Foundation.

If the Library as you received it specifies that a proxy can decide whether future versions of theGNU Lesser General Public License shall apply, that proxy’s public statement of acceptance ofany version is permanent authorization for you to choose that version for the Library.

END OF TERMS AND CONDITIONS

74 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Licenses

A.2 GNU Free Documentation License

GNU FREE DOCUMENTATION LICENSEVersion 1.3, 3 November 2008

Copyright c© 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.http://fsf.org/

Everyone is permitted to copy and distribute verbatim copiesof this license document, but changing it is not allowed.

0. PREAMBLE

The purpose of this License is to make a manual, textbook, or other functional and usefuldocument free in the sense of freedom: to assure everyone the effective freedom to copy andredistribute it, with or without modifying it, either commercially or noncommercially. Secon-darily, this License preserves for the author and publisher a way to get credit for their work,while not being considered responsible for modifications made by others.

This License is a kind of “copyleft”, which means that derivative works of the document mustthemselves be free in the same sense. It complements the GNU General Public License, whichis a copyleft license designed for free software.

We have designed this License in order to use it for manuals for free software, because freesoftware needs free documentation: a free program should come with manuals providing thesame freedoms that the software does. But this License is not limited to software manuals; itcan be used for any textual work, regardless of subject matter or whether it is published as aprinted book. We recommend this License principally for works whose purpose is instructionor reference.

1. APPLICABILITY AND DEFINITIONS

This License applies to any manual or other work, in any medium, that contains a notice placedby the copyright holder saying it can be distributed under the terms of this License. Such anotice grants a world-wide, royalty-free license, unlimited in duration, to use that work underthe conditions stated herein. The “Document”, below, refers to any such manual or work. Anymember of the public is a licensee, and is addressed as “you”. You accept the license if youcopy, modify or distribute the work in a way requiring permission under copyright law.

A “Modified Version” of the Document means any work containing the Document or a portionof it, either copied verbatim, or with modifications and/or translated into another language.

A “Secondary Section” is a named appendix or a front-matter section of the Document thatdeals exclusively with the relationship of the publishers or authors of the Document to theDocument’s overall subject (or to related matters) and contains nothing that could fall directlywithin that overall subject. (Thus, if the Document is in part a textbook of mathematics,a Secondary Section may not explain any mathematics.) The relationship could be a matterof historical connection with the subject or with related matters, or of legal, commercial,philosophical, ethical or political position regarding them.

The “Invariant Sections” are certain Secondary Sections whose titles are designated, as beingthose of Invariant Sections, in the notice that says that the Document is released under thisLicense. If a section does not fit the above definition of Secondary then it is not allowed to bedesignated as Invariant. The Document may contain zero Invariant Sections. If the Documentdoes not identify any Invariant Sections then there are none.

2014-10-25 75

Appendix A: Licenses texi/fdl13.texi

The “Cover Texts” are certain short passages of text that are listed, as Front-Cover Texts orBack-Cover Texts, in the notice that says that the Document is released under this License. AFront-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words.

A “Transparent” copy of the Document means a machine-readable copy, represented in a formatwhose specification is available to the general public, that is suitable for revising the documentstraightforwardly with generic text editors or (for images composed of pixels) generic paintprograms or (for drawings) some widely available drawing editor, and that is suitable for inputto text formatters or for automatic translation to a variety of formats suitable for input to textformatters. A copy made in an otherwise Transparent file format whose markup, or absence ofmarkup, has been arranged to thwart or discourage subsequent modification by readers is notTransparent. An image format is not Transparent if used for any substantial amount of text.A copy that is not “Transparent” is called “Opaque”.

Examples of suitable formats for Transparent copies include plain ascii without markup, Tex-info input format, LaTEX input format, SGML or XML using a publicly available DTD, andstandard-conforming simple HTML, PostScript or PDF designed for human modification. Ex-amples of transparent image formats include PNG, XCF and JPG. Opaque formats includeproprietary formats that can be read and edited only by proprietary word processors, SGML orXML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML, PostScript or PDF produced by some word processors for output purposesonly.

The “Title Page” means, for a printed book, the title page itself, plus such following pages asare needed to hold, legibly, the material this License requires to appear in the title page. Forworks in formats which do not have any title page as such, “Title Page” means the text nearthe most prominent appearance of the work’s title, preceding the beginning of the body of thetext.

The “publisher” means any person or entity that distributes copies of the Document to thepublic.

A section “Entitled XYZ” means a named subunit of the Document whose title either is preciselyXYZ or contains XYZ in parentheses following text that translates XYZ in another language.(Here XYZ stands for a specific section name mentioned below, such as “Acknowledgements”,“Dedications”, “Endorsements”, or “History”.) To “Preserve the Title” of such a section whenyou modify the Document means that it remains a section “Entitled XYZ” according to thisdefinition.

The Document may include Warranty Disclaimers next to the notice which states that thisLicense applies to the Document. These Warranty Disclaimers are considered to be includedby reference in this License, but only as regards disclaiming warranties: any other implicationthat these Warranty Disclaimers may have is void and has no effect on the meaning of thisLicense.

2. VERBATIM COPYING

You may copy and distribute the Document in any medium, either commercially or noncom-mercially, provided that this License, the copyright notices, and the license notice saying thisLicense applies to the Document are reproduced in all copies, and that you add no other con-ditions whatsoever to those of this License. You may not use technical measures to obstruct orcontrol the reading or further copying of the copies you make or distribute. However, you mayaccept compensation in exchange for copies. If you distribute a large enough number of copiesyou must also follow the conditions in section 3.

You may also lend copies, under the same conditions stated above, and you may publicly displaycopies.

76 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Licenses

3. COPYING IN QUANTITY

If you publish printed copies (or copies in media that commonly have printed covers) of theDocument, numbering more than 100, and the Document’s license notice requires Cover Texts,you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts:Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both coversmust also clearly and legibly identify you as the publisher of these copies. The front covermust present the full title with all words of the title equally prominent and visible. You mayadd other material on the covers in addition. Copying with changes limited to the covers, aslong as they preserve the title of the Document and satisfy these conditions, can be treated asverbatim copying in other respects.

If the required texts for either cover are too voluminous to fit legibly, you should put the firstones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacentpages.

If you publish or distribute Opaque copies of the Document numbering more than 100, you musteither include a machine-readable Transparent copy along with each Opaque copy, or state inor with each Opaque copy a computer-network location from which the general network-usingpublic has access to download using public-standard network protocols a complete Transparentcopy of the Document, free of added material. If you use the latter option, you must takereasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensurethat this Transparent copy will remain thus accessible at the stated location until at least oneyear after the last time you distribute an Opaque copy (directly or through your agents orretailers) of that edition to the public.

It is requested, but not required, that you contact the authors of the Document well beforeredistributing any large number of copies, to give them a chance to provide you with an updatedversion of the Document.

4. MODIFICATIONS

You may copy and distribute a Modified Version of the Document under the conditions ofsections 2 and 3 above, provided that you release the Modified Version under precisely thisLicense, with the Modified Version filling the role of the Document, thus licensing distributionand modification of the Modified Version to whoever possesses a copy of it. In addition, youmust do these things in the Modified Version:

A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document,and from those of previous versions (which should, if there were any, be listed in the Historysection of the Document). You may use the same title as a previous version if the originalpublisher of that version gives permission.

B. List on the Title Page, as authors, one or more persons or entities responsible for authorshipof the modifications in the Modified Version, together with at least five of the principalauthors of the Document (all of its principal authors, if it has fewer than five), unless theyrelease you from this requirement.

C. State on the Title page the name of the publisher of the Modified Version, as the publisher.

D. Preserve all the copyright notices of the Document.

E. Add an appropriate copyright notice for your modifications adjacent to the other copyrightnotices.

F. Include, immediately after the copyright notices, a license notice giving the public permis-sion to use the Modified Version under the terms of this License, in the form shown in theAddendum below.

2014-10-25 77

Appendix A: Licenses texi/fdl13.texi

G. Preserve in that license notice the full lists of Invariant Sections and required Cover Textsgiven in the Document’s license notice.

H. Include an unaltered copy of this License.

I. Preserve the section Entitled “History”, Preserve its Title, and add to it an item statingat least the title, year, new authors, and publisher of the Modified Version as given on theTitle Page. If there is no section Entitled “History” in the Document, create one statingthe title, year, authors, and publisher of the Document as given on its Title Page, thenadd an item describing the Modified Version as stated in the previous sentence.

J. Preserve the network location, if any, given in the Document for public access to a Trans-parent copy of the Document, and likewise the network locations given in the Documentfor previous versions it was based on. These may be placed in the “History” section. Youmay omit a network location for a work that was published at least four years before theDocument itself, or if the original publisher of the version it refers to gives permission.

K. For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Title of thesection, and preserve in the section all the substance and tone of each of the contributoracknowledgements and/or dedications given therein.

L. Preserve all the Invariant Sections of the Document, unaltered in their text and in theirtitles. Section numbers or the equivalent are not considered part of the section titles.

M. Delete any section Entitled “Endorsements”. Such a section may not be included in theModified Version.

N. Do not retitle any existing section to be Entitled “Endorsements” or to conflict in titlewith any Invariant Section.

O. Preserve any Warranty Disclaimers.

If the Modified Version includes new front-matter sections or appendices that qualify as Sec-ondary Sections and contain no material copied from the Document, you may at your optiondesignate some or all of these sections as invariant. To do this, add their titles to the list ofInvariant Sections in the Modified Version’s license notice. These titles must be distinct fromany other section titles.

You may add a section Entitled “Endorsements”, provided it contains nothing but endorsementsof your Modified Version by various parties—for example, statements of peer review or thatthe text has been approved by an organization as the authoritative definition of a standard.

You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Onlyone passage of Front-Cover Text and one of Back-Cover Text may be added by (or througharrangements made by) any one entity. If the Document already includes a cover text for thesame cover, previously added by you or by arrangement made by the same entity you are actingon behalf of, you may not add another; but you may replace the old one, on explicit permissionfrom the previous publisher that added the old one.

The author(s) and publisher(s) of the Document do not by this License give permission to usetheir names for publicity for or to assert or imply endorsement of any Modified Version.

5. COMBINING DOCUMENTS

You may combine the Document with other documents released under this License, underthe terms defined in section 4 above for modified versions, provided that you include in thecombination all of the Invariant Sections of all of the original documents, unmodified, and listthem all as Invariant Sections of your combined work in its license notice, and that you preserveall their Warranty Disclaimers.

78 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Licenses

The combined work need only contain one copy of this License, and multiple identical InvariantSections may be replaced with a single copy. If there are multiple Invariant Sections with thesame name but different contents, make the title of each such section unique by adding at theend of it, in parentheses, the name of the original author or publisher of that section if known,or else a unique number. Make the same adjustment to the section titles in the list of InvariantSections in the license notice of the combined work.

In the combination, you must combine any sections Entitled “History” in the various originaldocuments, forming one section Entitled “History”; likewise combine any sections Entitled“Acknowledgements”, and any sections Entitled “Dedications”. You must delete all sectionsEntitled “Endorsements.”

6. COLLECTIONS OF DOCUMENTS

You may make a collection consisting of the Document and other documents released underthis License, and replace the individual copies of this License in the various documents with asingle copy that is included in the collection, provided that you follow the rules of this Licensefor verbatim copying of each of the documents in all other respects.

You may extract a single document from such a collection, and distribute it individually underthis License, provided you insert a copy of this License into the extracted document, and followthis License in all other respects regarding verbatim copying of that document.

7. AGGREGATION WITH INDEPENDENT WORKS

A compilation of the Document or its derivatives with other separate and independent docu-ments or works, in or on a volume of a storage or distribution medium, is called an “aggregate”if the copyright resulting from the compilation is not used to limit the legal rights of the com-pilation’s users beyond what the individual works permit. When the Document is included inan aggregate, this License does not apply to the other works in the aggregate which are notthemselves derivative works of the Document.

If the Cover Text requirement of section 3 is applicable to these copies of the Document, then ifthe Document is less than one half of the entire aggregate, the Document’s Cover Texts may beplaced on covers that bracket the Document within the aggregate, or the electronic equivalentof covers if the Document is in electronic form. Otherwise they must appear on printed coversthat bracket the whole aggregate.

8. TRANSLATION

Translation is considered a kind of modification, so you may distribute translations of theDocument under the terms of section 4. Replacing Invariant Sections with translations requiresspecial permission from their copyright holders, but you may include translations of some orall Invariant Sections in addition to the original versions of these Invariant Sections. Youmay include a translation of this License, and all the license notices in the Document, andany Warranty Disclaimers, provided that you also include the original English version of thisLicense and the original versions of those notices and disclaimers. In case of a disagreementbetween the translation and the original version of this License or a notice or disclaimer, theoriginal version will prevail.

If a section in the Document is Entitled “Acknowledgements”, “Dedications”, or “History”,the requirement (section 4) to Preserve its Title (section 1) will typically require changing theactual title.

9. TERMINATION

You may not copy, modify, sublicense, or distribute the Document except as expressly providedunder this License. Any attempt otherwise to copy, modify, sublicense, or distribute it is void,and will automatically terminate your rights under this License.

2014-10-25 79

Appendix A: Licenses texi/fdl13.texi

However, if you cease all violation of this License, then your license from a particular copyrightholder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finallyterminates your license, and (b) permanently, if the copyright holder fails to notify you of theviolation by some reasonable means prior to 60 days after the cessation.

Moreover, your license from a particular copyright holder is reinstated permanently if thecopyright holder notifies you of the violation by some reasonable means, this is the first timeyou have received notice of violation of this License (for any work) from that copyright holder,and you cure the violation prior to 30 days after your receipt of the notice.

Termination of your rights under this section does not terminate the licenses of parties whohave received copies or rights from you under this License. If your rights have been terminatedand not permanently reinstated, receipt of a copy of some or all of the same material does notgive you any rights to use it.

10. FUTURE REVISIONS OF THIS LICENSE

The Free Software Foundation may publish new, revised versions of the GNU Free Documen-tation License from time to time. Such new versions will be similar in spirit to the presentversion, but may differ in detail to address new problems or concerns. See http://www.gnu.

org/copyleft/.

Each version of the License is given a distinguishing version number. If the Document specifiesthat a particular numbered version of this License “or any later version” applies to it, youhave the option of following the terms and conditions either of that specified version or of anylater version that has been published (not as a draft) by the Free Software Foundation. Ifthe Document does not specify a version number of this License, you may choose any versionever published (not as a draft) by the Free Software Foundation. If the Document specifiesthat a proxy can decide which future versions of this License can be used, that proxy’s publicstatement of acceptance of a version permanently authorizes you to choose that version for theDocument.

11. RELICENSING

“Massive Multiauthor Collaboration Site” (or “MMC Site”) means any World Wide Web serverthat publishes copyrightable works and also provides prominent facilities for anybody to editthose works. A public wiki that anybody can edit is an example of such a server. A “MassiveMultiauthor Collaboration” (or “MMC”) contained in the site means any set of copyrightableworks thus published on the MMC site.

“CC-BY-SA” means the Creative Commons Attribution-Share Alike 3.0 license published byCreative Commons Corporation, a not-for-profit corporation with a principal place of businessin San Francisco, California, as well as future copyleft versions of that license published by thatsame organization.

“Incorporate” means to publish or republish a Document, in whole or in part, as part of anotherDocument.

An MMC is “eligible for relicensing” if it is licensed under this License, and if all works thatwere first published under this License somewhere other than this MMC, and subsequentlyincorporated in whole or in part into the MMC, (1) had no cover texts or invariant sections,and (2) were thus incorporated prior to November 1, 2008.

The operator of an MMC Site may republish an MMC contained in the site under CC-BY-SAon the same site at any time before August 1, 2009, provided the MMC is eligible for relicensing.

80 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Licenses

ADDENDUM: How to use this License for your documents

To use this License in a document you have written, include a copy of the License in the documentand put the following copyright and license notices just after the title page:

Copyright (C) year your name.

Permission is granted to copy, distribute and/or modify this document

under the terms of the GNU Free Documentation License, Version 1.3

or any later version published by the Free Software Foundation;

with no Invariant Sections, no Front-Cover Texts, and no Back-Cover

Texts. A copy of the license is included in the section entitled ‘‘GNU

Free Documentation License’’.

If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the “with. . .Texts.”line with this:

with the Invariant Sections being list their titles, with

the Front-Cover Texts being list, and with the Back-Cover Texts

being list.

If you have Invariant Sections without Cover Texts, or some other combination of the three, mergethose two alternatives to suit the situation.

If your document contains nontrivial examples of program code, we recommend releasing theseexamples in parallel under your choice of free software license, such as the GNU General PublicLicense, to permit their use in free software.

2014-10-25 81

OpenSS7 XNS/XTI Library Indices

Appendix B Indices

2014-10-25 83

Appendix B: Indices

B.1 Concept Index

Aagencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Bbugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Cconformance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61contributors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Eerror handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Ffunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Hheader files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50header files, xti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51header files, xti ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

IIndices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5ip, xti header file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Llicense, FDL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75license, GNU Free Documentation License . . . . . 75license, Lesser General Public License . . . . . . . . . . 72license, LGPL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Ooverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Rreference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Ssponsors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1supporters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Tthread safety . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Xxti header file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51xti ip header file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

84 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Indices

B.2 Type Index

(Index is nonexistent)

2014-10-25 85

Appendix B: Indices

B.3 Function and Macro Index

t_accept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8t_addleaf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11t_alloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14t_bind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15t_close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16t_connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17t_errno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18t_error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19t_free . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20t_geprotaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22t_getinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21t_getstate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23t_listen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24t_look . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25t_open . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26t_optmgmt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27t_rcv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28t_rcvconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29t_rcvdis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

t_rcvleafchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31t_rcvrel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32t_rcvreldata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33t_rcvudata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34t_rcvuderr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35t_rcvv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36t_rcvvudata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37t_removeleaf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38t_snd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39t_snddis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40t_sndrel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41t_sndreldata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42t_sndudata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43t_sndv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44t_sndvudata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45t_strerror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46t_sync . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47t_sysconf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48t_unbind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

86 Version 1.1 Rel. 7.20141001

OpenSS7 XNS/XTI Library Indices

B.4 Variable and Constant Macro Index

Qqlen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

TT_COTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9T_COTS_ORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9T_IDLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8T_INCON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9T_UNBND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8TACCES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9TADDRBUSY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11TBADADDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9, 11TBADDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

TBADF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9, 11TBADOPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9TBADSEQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9TINDOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9TLOOK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9, 12TNOADDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12TNODATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11, 12TNOTSUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10, 12TOUTSTATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10, 12TPROTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10, 12TPROVMISMATCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10TRESADDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10TRESQLEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10TSYSERR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10, 12

2014-10-25 87

Appendix B: Indices

B.5 Program and File Index

xti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51xti_ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52xti_mtp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53xti_sccop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57xti_sccp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

xti_sctp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55xti_ss7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56xti_tcap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58xti_tcp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59xti_udp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

88 Version 1.1 Rel. 7.20141001