timod.4

7号信令功能代码,为开源代码

    t_scalar_t OPT_length;      /* options length */
    t_scalar_t OPT_offset;      /* options offset */
    t_scalar_t SEQ_number;      /* sequence number */
};
\fR\s+1
.fi
following by any connection response data.
.PP
and returning a
.B T_ok_ack
structure, formatted as follows:
.sp
.nf
\fC\s-1\
struct T_ok_ack {
    t_scalar_t PRIM_type;       /* always T_OK_ACK */
    t_scalar_t CORRECT_prim;    /* primitive */
};
\fR\s+1
.fi
.PP
or an error return value.  See
.I \*(lqRETURN VALUES,\*(rq
below.
.PP
The buffer passed in the
.B strioctl
structure
.RI ( ic_dp )
must be of sufficient size
.RI ( ic_len )
to hold the returned
.B T_ok_ack
structure.
.\"
.\"
.SS TI_SETPEERNAME (('T' << 8) + 147)
.PP
.I arg
is a pointer to a buffer passing in a
.B T_conn_req
structure, formatted as follows:
.sp
.nf
\fC\s-1\
struct T_conn_req {
    t_scalar_t PRIM_type;       /* always T_CONN_REQ */
    t_scalar_t DEST_length;     /* dest addr length */
    t_scalar_t DEST_offset;     /* dest addr offset */
    t_scalar_t OPT_length;      /* options length */
    t_scalar_t OPT_offset;      /* options offset */
};
\fR\s+1
followed by any connection request data.
.fi
.PP
and returning a
.B T_ok_ack
structure, formatted as follows:
.sp
.nf
\fC\s-1\
struct T_ok_ack {
    t_scalar_t PRIM_type;       /* always T_OK_ACK */
    t_scalar_t CORRECT_prim;    /* primitive */
};
\fR\s+1
.fi
.PP
or an error return value.  See
.I \*(lqRETURN VALUES,\*(rq
below.
.PP
The buffer passed in the
.B strioctl
structure
.RI ( ic_dp )
must be of sufficient size
.RI ( ic_len )
to hold the returned
.B T_ok_ack
structure.
.\"
.\"
.SS TI_SYNC (('T' << 8) + 148)
.PP
.I arg
is a pointer to a buffer passing in a
.B ti_sync_req
structure, formatted as follows:
.sp
.nf
\fC\s-1\
struct ti_sync_req {
    u_int32_t tsr_flags;
};
\fR\s+1
.fi
.PP
and returning a
.B ti_sync_ack
structure, formatted as follows:
.sp
.nf
\fC\s-1\
struct ti_sync_ack {
    t_scalar_t PRIM_type;
    t_scalar_t TSDU_size;
    t_scalar_t ETSDU_size;
    t_scalar_t CDATA_size;
    t_scalar_t DDATA_size;
    t_scalar_t ADDR_size;
    t_scalar_t OPT_size;
    t_scalar_t TIDU_size;
    t_scalar_t SERV_type;
    t_scalar_t CURRENT_state;
    t_scalar_t PROVIDER_flag;
    t_uscalar_t tsa_qlen;
    u_int32_t tsa_flags;
};
\fR\s+1
.fi
.PP
or an error return value.  See
.I \*(lqRETURN VALUES,\*(rq
below.
.PP
Field
.I tsr_flags
can contain zero or more of the following flags bitwise OR'ed together:
.TP
.B TSRF_INFO_REQ
Requests that the response contain a completed information request.
.TP
.B TSRF_IS_EXP_IN_RCVBUF
Requests that the response contain a flag indicating whether there is
expedited data in the receive buffer.
.TP
.B TSRF_QLEN_REQ
Requests that the response contain the queue length of the transport service
provider.  Note that this information is not contained in a
.B T_capability_ack
but is necessary when a file descriptor is being synced on an open transport
endpoint.
.PP
Field
.I tsa_flags
can contain zero or more of the following flags bitwise OR'ed together:
.TP
.B TSAF_EXP_QUEUED
Indicates that there is expedited data queued in the transport endpoint
receive buffer.
.PP
The buffer passed in the
.B strioctl
structure
.RI ( ic_dp )
must be of sufficient size
.RI ( ic_len )
to hold the returned
.B ti_sync_ack
structure.
.\"
.\"
.SS TI_GETADDRS (('T' << 8) + 149)
.PP
.I arg
is a pointer to a buffer passing in a
.B T_addr_req
structure, formatted as follows:
.sp
.nf
\fC\s-1\
struct T_addr_req {
    t_scalar_t PRIM_type;       /* always T_ADDR_REQ */
};
\fR\s+1
.fi
.PP
and returning a
.B T_addr_ack
structure, formatted as follows:
.sp
.nf
\fC\s-1\
struct T_addr_ack {
    t_scalar_t PRIM_type;       /* always T_ADDR_ACK */
    t_scalar_t LOCADDR_length;  /* length of local address */
    t_scalar_t LOCADDR_offset;  /* offset of local address */
    t_scalar_t REMADDR_length;  /* length of remote address */
    t_scalar_t REMADDR_offset;  /* offset of remote address */
};
\fR\s+1
.fi
.PP
or an error return value, See
.I \*(lqRETURN VALUES,\*(rq
below.
.PP
The buffer passed in the
.B strioctl
structure
.RI ( ic_dp )
must be of sufficient size
.RI ( ic_len )
to hold the returned
.B T_addr_ack
structure.
.\"
.\"
.SS TI_CAPABILITY (('T' << 8) + 150)
.PP
.I arg
is a pointer to a buffer passing in a
.BR T_capability_req
structure, formatted as follows:
.sp
.nf
\fC\s-1\
struct T_capability_req {
    t_scalar_t PRIM_type;       /* T_CAPABILITY_REQ */
    t_uscalar_t CAP_bits1;      /* capability bits 1 */
};
\fR\s+1
.fi
.PP
and returning a
.B T_capability_ack
structure, formatted as follows:
.sp
.nf
\fC\s-1\
struct T_capability_ack {
    t_scalar_t PRIM_type;       /* T_CAPABILITY_ACK */
    t_uscalar_t CAP_bits1;      /* capability bits #1 */
    struct T_info_ack INFO_ack; /* info acknowledgement */
    t_uscalar_t ACCEPTOR_id;    /* accepting endpoint id */
};
\fR\s+1
.fi
.PP
or an error return value, See
.I \*(lqRETURN VALUES,\*(rq
below.
.PP
The buffer passed in the
.B strioctl
structure
.RI ( ic_dp )
must be of sufficient size
.RI ( ic_len )
to hold the returned
.B T_capability_ack
structure.
.\"
.\"
.SH "RETURN VALUES"
.PP
.PP
When
.B timod
ioctls succeed, they return zero and the returned TLI message in the area
pointed to by the
.I ic_dp
member of the
.B strioctl
structure pointed to by
.IR arg .
When
.B timod
ioctls fail due to a
.B T_ERROR_ACK
being returned from the underlying TLI driver,
.B timod
returns a concatentation of the UNIX_error and the TLI_error as follows:
.BR "((p->UNIX_error << 8) + p->TLI_error)" .
When the ioctl fails, 
.B timod
returns -1 and sets
.BI errno (3)
to an appropriate error number.
See
.BR streamio (7)
for a list of error numbers returned by the
.B I_STR
command.
.\"
.\"
.SH ERRORS
.PP
.PP
When
.B timod
ioctl calls fail,
.B timod
returns -1 and sets the
.BI errno (3)
to an appropriate error number.
See
.BR streamio (7)
for a list of error numbers returned by the
.B I_STR
command.
.\"
.\"
.SH MODULES
.PP
.RB \*(lq timod \*(rq
.I STREAMS
module.
.\"
.\"
.SH "SEE ALSO"
.PP
.BR ioctl (2),
.BR streamio (7),
.BR tpi (7),
.BR sockmod (4).
.\"
.\"
.SH BUGS
.PP
.B timod
has been tested with the
.I /usr/bin/test-timod
conformance test suite.
.PP
.B timod
has no known bugs.
.\"
.\"
.SH COMPATIBILITY
.PP
.PP
This
.B Linux Fast-STREAMS
.[
lfs
.]
implementation of
.B timod
was backported to
.B LiS
.[
LiS
.]
to repair deficiencies in the previous
.B LiS
implementation.
.PP
.B timod
is compatible with
.BR "XNS 5.2"
.[
xns
.]
and
.BR "SVR 4.2" ,
.[
svr42spg
.]
and descriptions for
.BR UnixWare7 \(rg,
.[
uw7doc
.]
.BR AIX \(rg,
.[
aixdoc
.]
.BR DigitalUNIX \(rg,
.[
osfdoc
.]
.BR HP-UX \(rg,
.[
hpuxdoc
.]
.BR Solaris \(rg,
.[
soldoc
.]
.BR SUPER-UX \(rg,
.[
suxdoc
.]
with the following portability considerations:
.IP \(em \w'\(em\ \ 'u
Most other implementations only document the
.BR TI_GETINFO ,
.BR TI_OPTMGMT ,
.BR TI_BIND " and " T_UNBIND
IO controls.
.B timod
is consistent with this documentation.
.IP \(em
Most other implementations do not document
.BR TI_GETMYNAME ,
.BR TI_GETPEERNAME ,
.BR TI_SETMYNAME " and " TI_SETPEERNAME
IO controls.  Some of these are archaic and deprecated.
.B timod
provides the non-portable mechanisms described here.  Portable application
programs should not use these IO controls directly.
.B timod
uses special versions of these IO controls to ease work involved in the
XTI/TLI library and to increase efficiency of that library.
.IP \(em
.BR TI_SYNC ,
.BR TI_GETADDR " and " TI_CAPABILITY
IO controls are consistent with internal documentation of other implementations.
.B timod
uses these IO controls to ease work involved in the XTI/TLI library and to
increase efficiency of that library.
.B timod
provides the non-portable mechanisms described here.  Portable application
programs should not use these IO controls directly.
.\"
.\"
.SH CONFORMANCE
.PP
.BR SVID ,
.[
svid
.]
.BR XID ,
.[
xbd5
.]
.BR "XNS 5.2" ,
.[
xns
.]
.BR SUSv2 ,
.[
susv2
.]
.BR SUSv3 / POSIX ,
.[
susv3
.]
.\"
.\"
.SH HISTORY
.PP
.B timod
first appeared in
.B SVR 3
.[
svr3
.]
.\"
.\"
.[
$LIST$
.]
.TI