Volo Interfaces Amendment [PSARC/2008/694 FastTrack timeout 11/18/2008]

[Kais Belgaied]

Template Version: @(#)sac_nextcase %I% %G% SMI
This information is Copyright 2008 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 Volo Interfaces Amendment
    1.2. Name of Document Author/Supplier:
	 Author:  Rao Shoaib
    1.3  Date of This Document:
	11 November, 2008
4. Technical Description
I am sponsoring the following fast-track for Rao Shoaib and the Volo project
team. This case is a collection of minor changes to the interfaces introduced
by Project Volo PSARC/2007/587.
This amendment does not affect the original minor release binding.
All interfaces added by this amendment are Consolidation Private.

The updated  full Volo design document will be placed in the case directory.
Below is a summary of the changes covered by this fasttrack.

*) In the initial design a socket module writer was allowed to register it own
   sonodeops. This facility was deemed unnecessary and problematic. In the
   current design module writer registers only one create function that is
   called by the socket framework after allocating an sonode.

*) Functions used in fallback are no longer part of the public upcalls and
   downcalls vector. Since fallback is supported only on native protocols
   it is handled via private function calls. There is no change in how
   fallback works.

*) To support 3rd party socket modules two new downcalls sd_send_uio and
   sd_recv_uio have been introduced. These interfaces all protocol writer
   to control how data is copied to and from the user buffer. 

*) A new down call sd_poll has been introduced. This down call support
   polling when the protocol is doing it own buffering

*) To support evolution the interface is versioned.
   Current versions are obtained via the macros
	SOCK_UC_VERSION (upcall interface)
	SOCK_DC_VERSION (downcall interface)

*) /etc/sock2path now supports either a module name or a device name as the
   fourth member of the table.

*) Two new socket options have been added
	SO_SNDTIMEO
	SO_RCVTIMEO
   both take a pointer to struct timeval and return EWOUBLOCK if the timer
   expires.
	

6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		on
    6.5. ARC review type: FastTrack
    6.6. ARC Exposure: open