Name
intro - introduction to the Network Services library.
Description
This section contains sets of functions constituting the
Network Services library. These sets provide protocol
independent interfaces to networking services based on the
service definitions of the OSI (Open Systems
Interconnection) reference model. Application developers
access the function sets that provide services at a
particular level.
The function sets contained in the library are:
TRANSPORT LAYER INTERFACE (TLI)-provide the services of
the OSI Transport Layer. These services provide
reliable end-to-end data transmission using the services
of an underlying network. Applications written using
the TLI functions are independent of the underlying
protocols. Declarations for these functions may be
obtained from the #include file <tiuser.h>. The link
editor ld(M) searches this library under the -lnsl_s
option.
Definitions
netbuf
In the Network Services library, netbuf is a structure used
in various Transport Layer Interface (TLI) functions to send
and receive data and information. It contains the following
members:
unsigned int maxlen;
unsigned int len;
char *buf;
buf points to a user input and/or output buffer. len
generally specifies the number of bytes contained in the
buffer. If the structure is used for both input and output,
the function will replace the user value of len on return.
maxlen generally has significance only when buf is used to
receive output from the TLI function. In this case, it
specifies the physical size of the buffer, the maximum value
of len that can be set by the function. If maxlen is not
large enough to hold the returned information, a TBUFOVFLW
error will generally result. However, certain functions may
return part of the data and not generate an error.
(printed 6/18/89)