Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ t_sndudata(3N) — DG/UX 4.30

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

intro(3)

t_rcvudata(3N)

t_rcvuderr(3N)



     TSNDUDATA(3N)             DG/UX 4.30              TSNDUDATA(3N)



     NAME
          t_sndudata - send a data unit

     SYNOPSIS
          #include <tiuser.h>

          int tsndudata(fd, unitdata)
          int fd;
          struct tunitdata *unitdata;

     DESCRIPTION
          This function is used in connectionless mode to send a data
          unit to another transport user.  Fd identifies the local
          transport endpoint through which data will be sent, and
          unitdata points to a t_unitdata structure containing the
          following members:

               struct netbuf addr;
               struct netbuf opt;
               struct netbuf udata;

          Netbuf is described in intro(3).  In unitdata, addr
          specifies the protocol address of the destination user, opt
          identifies protocol-specific options that the user wants
          associated with this request, and udata specifies the user
          data to be sent.  The user may choose not to specify what
          protocol options are associated with the transfer by setting
          the len field of opt to zero.  In this case, the provider
          may use default options.

          If the len field of udata is zero, no data unit will be
          passed to the transport provider; tsndudata will not send
          zero-length data units.

          By default, tsndudata operates in synchronous mode and may
          wait if flow control restrictions prevent the data from
          being accepted by the local transport provider at the time
          the call is made.  However, if O_NDELAY is set (via topen
          or fcntl), tsndudata will execute in asynchronous mode and
          will fail under such conditions.

          If tsndudata is issued from an invalid state, or if the
          amount of data specified in udata exceeds the TSDU size as
          returned by topen or tgetinfo, the provider will generate
          an EPROTO protocol error.  (See TSYSERR below.)

          On failure, t_errno may be set to one of the following:

          [TBADF]           The specified file descriptor does not
                            refer to a transport endpoint.

          [TFLOW]           O_NDELAY was set, but the flow control



     Licensed material--property of copyright holder(s)         Page 1





     TSNDUDATA(3N)             DG/UX 4.30              TSNDUDATA(3N)



                            mechanism prevented the transport provider
                            from accepting data at this time.

          [TNOTSUPPORT]     This function is not supported by the
                            underlying transport provider.

          [TSYSERR]         A system error has occurred during
                            execution of this function.

     SEE ALSO
          intro(3), t_rcvudata(3N), t_rcvuderr(3N).

     DIAGNOSTICS
          tsndudata returns 0 on successful completion and -1 on
          failure t_errno is set to indicate the error.








































     Licensed material--property of copyright holder(s)         Page 2



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026