Manualshelf

t_open.3 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
1234
t
t_open(3) t_open(3)
NAME
t_open() - establish a transport endpoint
SYNOPSIS
#include <fcntl.h>
#include <xti.h> /* for X/OPEN Transport Interface - XTI */
/* or */
#include <tiuser.h> /* for Transport Layer Interface - TLI */
int t_open (name, oflag, info);
char *name;
int oflag;
struct t_info *info;
DESCRIPTION
The t_open() function must be called as the first step in the initialization of a transport endpoint. This
function establishes a transport endpoint by opening a file that identifies a particular transport provider
and returning a file descriptor that identifies that endpoint.
The argument name points to a file name that identifies a transport provider. When using HP XTI to con-
nect to the OSI protocol stack, name must be
/dev/ositpi for the connection-mode service, or
/dev/osicltpi for the connectionless service. When using HP XTI to connect to the TCP protocol
stack, name should be /dev/tcp.ForUDP,name should be /dev/udp
. (See also the OBSOLESCENT
INTERFACES section.) For TLI, use the device file name of the transport provider desired. Note that
HP TCP/UDP/IP and HP OSI COTS and CLTS only support XTI.
oflag identifies any open flags (as in
open()) and is constructed from
O_RDWR optionally or-ed with
O_NONBLOCK. These flags are defined by the header file <fcntl.h>.
t_open() returns a file
descriptor that will be used by all subsequent functions to identify the particular local transport endpoint.
This function also returns various default characteristics of the underlying transport protocol by setting
fields in the
t_info structure. This argument points to a t_info which contains the following
members:
t_scalar_t addr; /* max size of the transport protocol */
/* address */
t_scalar_t options; /* max number of bytes of */
/* protocol-specific options */
t_scalar_t tsdu; /* max size of a transport service data */
/* unit (TSDU) */
t_scalar_t etsdu; /* max size of an expedited transport */
/* service data unit (ETSDU) */
t_scalar_t connect; /* max amount of data allowed on */
/* connection establishment functions */
t_scalar_t discon; /* max amount of data allowed on */
/* t_snddis and t_rcvdis functions */
t_scalar_t servtype; /* service type supported by the */
/* transport provider */
t_scalar_t flags; /* other info about the transport provider */
The values of the fields have the following meanings:
addr A value greater than or equal to zero indicates the maximum size of a transport protocol
address.
A value of − 1 specifies that there is no limit on the address size.
A value of −2 specifies that the transport provider does not provide user access to tran-
sport protocol addresses.
options A value greater than or equal to zero indicates the maximum number of bytes of
protocol-specific options supported by the provider.
A value of − 1 specifies that there is no limit on the option size.
A value of − 2 specifies that the transport provider does not support user-settable options.
tsdu A value greater than zero specifies the maximum size of a transport service data unit
(TSDU).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)