From sacadmin Mon Dec 18 09:11:08 2006
Received: from phorcys.east.sun.com (phorcys.East.Sun.COM [129.148.174.143])
	by sac.sfbay.sun.com (8.13.6+Sun/8.13.6) with ESMTP id kBIHB76r012011
	for <psarc@sac.sfbay.sun.com>; Mon, 18 Dec 2006 09:11:08 -0800 (PST)
Received: from phorcys.east.sun.com (localhost [127.0.0.1])
	by phorcys.east.sun.com (8.13.8+Sun/8.13.8) with ESMTP id kBIHEo7P003406;
	Mon, 18 Dec 2006 12:14:50 -0500 (EST)
Received: (from carlsonj@localhost)
	by phorcys.east.sun.com (8.13.8+Sun/8.13.8/Submit) id kBIHEnxP003403;
	Mon, 18 Dec 2006 12:14:50 -0500 (EST)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Message-ID: <17798.52361.919947.852686@gargle.gargle.HOWL>
Date: Mon, 18 Dec 2006 12:14:49 -0500
From: James Carlson <james.d.carlson@sun.com>
To: psarc@sac.sfbay.sun.com
cc: kacheong.poon@sun.com
Subject: 2006/712 Extend SO_PROTOTYPE
X-Mailer: VM 7.01 under Emacs 21.3.1
Status: RO
Content-Length: 2651

I'm sponsoring the following fast-track request for Kacheong Poon.  As
the change is fairly obvious, and the holiday is approaching, I've set
the timer to 12/22/2006.

The case exposure is set to 'open,' as this was originally discussed
on an open list, and there's nothing proprietary involved.



This project has a Patch/Micro release binding and the interface
stability level is Committed.

Currently, there is no reliable way for an application to find out the
underlying protocol used in a socket.  While this is not a problem if
the socket is created by the application itself, it is an issue if the
socket is passed from other applications such as inetd(1M).  This
project proposes to extend the existing socket option SO_PROTOTYPE to
be used in socket type other than raw and routing socket as a get only
option.  If the socket's domain is AF_INET or AF_INET6, the option
will return the underlying protocol number used in the socket.  If the
socket's domain is AF_ROUTE, the option will return the underlying
address family used in the socket.  This project does not propose to
include the use of the option on raw sockets, as currently raw socket
mode is not documented anywhere.

Since the SO_PROTOTYPE option user really needs to know the domain of
a socket to determine the meaning of the return value, this project
introduces a new get only option, SO_DOMAIN, which returns the domain
used in a socket.  This option is applicable to all types of socket.

The following will be added to the getsockopt(3SOCKET) man page:

---  
+      SO_DOMAIN        get the domain used in the socket (get only)
  
+ 
+      SO_PROTOTYPE     for socket in domains PF_INET and PF_INET6,
+                       get the underlying protocol number used in
+                       the socket.  For socket in domain PF_ROUTE,
+                       get the address family used in the socket.
+ 
+ 
+ 
       SO_DEBUG  enables  debugging  in  the  underlying   protocol
       modules. SO_REUSEADDR indicates that the rules used in vali-
       dating addresses supplied in  a  bind(3SOCKET)  call  should
---

The following will be added to getsockopt(3XNET) man page:

---  
+      SO_DOMAIN        get the domain used in the socket (get only)
  
+ 
+      SO_PROTOTYPE     for socket in domains AF_INET and AF_INET6,
+                       get the underlying protocol number used in
+                       the socket.  For socket in domain AF_ROUTE,
+                       get the address family used in the socket.
+ 
+ 
+ 
       For boolean options, 0 indicates that the option is disabled
       and 1 indicates that the option is enabled.
---  


From sacadmin Wed Dec 20 16:09:16 2006
Received: from phorcys.east.sun.com (phorcys.East.Sun.COM [129.148.174.143])
	by sac.sfbay.sun.com (8.13.6+Sun/8.13.6) with ESMTP id kBL09FYI015674
	for <psarc@sac.sfbay.sun.com>; Wed, 20 Dec 2006 16:09:16 -0800 (PST)
Received: from phorcys.east.sun.com (localhost [127.0.0.1])
	by phorcys.east.sun.com (8.13.8+Sun/8.13.8) with ESMTP id kBL0D0tr013034;
	Wed, 20 Dec 2006 19:13:00 -0500 (EST)
Received: (from carlsonj@localhost)
	by phorcys.east.sun.com (8.13.8+Sun/8.13.8/Submit) id kBL0D0EG013031;
	Wed, 20 Dec 2006 19:13:00 -0500 (EST)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Message-ID: <17801.53643.651097.257191@gargle.gargle.HOWL>
Date: Wed, 20 Dec 2006 19:12:59 -0500
From: James Carlson <james.d.carlson@sun.com>
To: psarc@sac.sfbay.sun.com
cc: kacheong.poon@sun.com
Subject: Re: 2006/712 Extend SO_PROTOTYPE
In-Reply-To: <17798.52361.919947.852686@gargle.gargle.HOWL>
References: <17798.52361.919947.852686@gargle.gargle.HOWL>
X-Mailer: VM 7.01 under Emacs 21.3.1
Status: RO
Content-Length: 301

This fast-track request was approved during ARC business at today's
meeting.

-- 
James Carlson, KISS Network                    <james.d.carlson@sun.com>
Sun Microsystems / 1 Network Drive         71.232W   Vox +1 781 442 2084
MS UBUR02-212 / Burlington MA 01803-2757   42.496N   Fax +1 781 442 1677

