[Sois-tcons] Proposed TCONS API manpage

[gregory.menke at gsfc.nasa.gov]

Keith Scott writes:
 > I have been marking up the red book (mainly section 3.6, the transport layer
 > primitives and API).  Some issues are:
 > 
 > What to do if the incoming data unit is larger than the buffer supplied by
 > the application?

Truncate the buffer.


 > Making sure we always give the application the length of the various data
 > items (particularly payload items).

The 2 receive function do give the packet length- did I mess that up?


 > Do we want to be able to cancel receive requests (or send requests before
 > the callback is invoked)?

on a connection-oriented connection, all pending receives should fail
when its closed- corresponding to all sends failing.  connectionless
receives do seem like they will wait forever.  send requests will
always succeed or fail, so I don't think the cancel issue is as
important for them.

Perhaps we must include the concept of a TCONS session, within which
connections, sends, receives occur.  Then, the session can be closed,
releasing any accumulated state & aborting pending events.

Gregm