Manpage of T_ADDLEAF

T_ADDLEAF

Section: OpenSS7 XTI/TLI Networking Library Calls (3)
Updated: 2008-10-31
Index Return to Main Contents

NAME

t_addleaf - add a point to a point to multipoint 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 multipoint 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 to the point to multipoint 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 the point to multipoint connection. No information is returned in addr. addr->maxlen is ignored by the call. add->len is the length of the address. If add->len is zero, it indicates that no address is provided. add->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_ORD that support point to multipoint connection management.

In synchronous mode, t_addleaf() blocks until a leaf change confirmation is received. In asynchronous mode where no leaf change confirmation is immediately avaialble, t_addleaf() fails, returns -1 and sets t_errno(3) to [TNODATA].

RETURN VALUE

Upon success, t_addleaf() returns zero (0) and confirms the addition of the requested leaf. Upon failure, 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]: The address specificed was already in use by another transport endpoint.
[TBADADDR]: The address specified was of an invalid format or contained invalid information.
[TLOOK]: An asynchronous event occured before the call could complete. See t_look(3) for more information.
[TNOADDR]: An address was not specified and the transport provider could not assign one.
[TNODATA]: An attempt was made to read the add leaf confirmation but no add leaf confirmation was available.
[TNOTSUPPORT]: The call requires the use of a TLI primitive not supported by the underlying transport provider.
[TOUTSTATE]: The call was issued with the interface in an incorrect state.
[TPROTO]: A protocol error occured between the XTI/TLI library and the underlying transport provider.
[TSYSERR]: A Linux system error occured and the Linux error number is set in errno(3).

BUGS

t_addleaf() has no known bugs. t_addleaf() has been tested with the test-xnet(8) and test-xnet_thr(8) conformance test suites.

COMPATIBILITY

The XTI/TLI library functions are compatible with SVR4.2[1], XNS 5.2[2], SUSv2[3]. Compatibility is tested using the test-xnet(8) and test-xnet_thr(8) test case executables and the OpenSS7 XTI/TLI Networking autotest test suite.

CONFORMANCE

XTI/TLI[4], TPI[5], XPG5, XNS 5.2[2], SUSv2[3]. Conformance is tested using the test-xnet(8) and test-xnet_thr(8) test case executables and the OpenSS7 XTI/TLI Networking autotest test suite.

HISTORY

t_addleaf first appeared in SVR4.2[1].

VERSIONS

This manpage was written for the OpenSS7 XTI/TLI Library.

REFERENCES

[1]: SVR 4.2, UNIX® System V Release 4.2 Programmer's Manual, 1992, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[2]: XNS, Open Group CAE Specification: Technical Standard: Network Services (XNS), Issue 5.2, Draft 2, 1999, (Berkshire, UK), OpenGroup, Open Group Publication. [ISBN 1-85912-241-8] <http://www.opengroup.org/onlinepubs/>
[3]: SUS Version 2, Single UNIX Specification, OpenGroup, Open Group Publication. <http://www.opengroup.org/onlinepubs/>
[4]: XTI/TLI Revision 1.0, Open Group CAE Specification: XOpen Transport Interface, Revision 1, n.d., (Berkshire, UK), XPG, X Programmer's Group. <http://www.opengroup.org/onlinepubs/>
[5]: TPI Revision 2.0.0, Open Group CAE Specification: Transport Provider Interface (TPI) Specification, Revision 2.0.0, Draft 2, 1999, (Berkshire, UK), OpenGroup, Open Group Publication. <http://www.opengroup.org/onlinepubs/>

TRADEMARKS

OpenSS7tm: is a trademark of OpenSS7 Corporation.
Linux®: is a registered trademark of Linus Torvalds.
UNIX®: is a registered trademark of The Open Group.
Solaris®: is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

OpenSS7 XTI/TLI Networking: Package strxnet version 0.9.2.12 released 2008-10-31.

Index

NAME
SYNOPSIS
ARGUMENTS
DESCRIPTION
CAVEATS
RETURN VALUE
ERRORS
SEE ALSO
BUGS
COMPATIBILITY
CONFORMANCE
HISTORY
VERSIONS
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 19:11:42 GMT, May 22, 2013