1. Oracle Solaris 11.4 Programming Interfaces Guide
  2. Programming With XTI and TLI
  3. XTI/TLI Read/Write Interface
  4. Read Data

Read Data

Receive data arrives at the transport connection with read(). The tirdwr module passes data from the transport provider. The tirdwr module processes any other event or request passed to the user from the provider as follows:

  • read() cannot identify expedited data to the user. If read() receives an expedited data request, tirdwr generates a fatal protocol error, EPROTO, on the stream. The error causes further system calls to fail. Do not use read() to receive expedited data.

  • tirdwr discards an abortive disconnect request and generates a hang-up condition on the stream. Subsequent read() calls retrieve any remaining data, then return zero for all further calls, indicating end of file.

  • tirdwr discards an orderly release request and delivers a zero-length message to the user. As described in the read() man page, this notifies the user of end of file by returning 0.

  • If read() receives any other XTI/TLI request, tirdwr generates a fatal protocol error, EPROTO, on the stream. This causes further system calls to fail. If a user pushes tirdwr onto a stream after establishing the connection, tirdwr generates no request. For more information, see the read(2) man page.