From sacadmin Fri Jun 1 15:31:31 2007 Received: from sac.sfbay.sun.com (localhost [127.0.0.1]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l51MVVHF021244; Fri, 1 Jun 2007 15:31:31 -0700 (PDT) Received: (from tedk@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id l51MVUDe021240; Fri, 1 Jun 2007 15:31:30 -0700 (PDT) Date: Fri, 1 Jun 2007 15:31:30 -0700 (PDT) From: Ted Kim Message-Id: <200706012231.l51MVUDe021240@sac.sfbay.sun.com> To: PSARC-record@sac.sfbay.sun.com Subject: IBTF IP Addressing [PSARC/2007/323 FastTrack timeout 06/08/2007] Status: RO Content-Length: 529 Template Version: @(#)sac_nextcase 1.61 05/24/07 SMI This information is Copyright 2007 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: IBTF IP Addressing 1.2. Name of Document Author/Supplier: Author: Shantkumar Hiremath 1.3 Date of This Document: 01 June, 2007 4. Technical Description See the case directory for more detail 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: ON 6.5. ARC review type: FastTrack From sacadmin Fri Jun 1 15:44:20 2007 Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l51MiKak021361 for ; Fri, 1 Jun 2007 15:44:20 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l51MgxSf017547 for <@sunmail2sca.sfbay.sun.com:psarc@sun.com>; Fri, 1 Jun 2007 15:42:59 -0700 (PDT) Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JIZ00D03B3NDZ00@nwk-avmta-1.sfbay.Sun.COM> for psarc@sun.com (ORCPT psarc@sun.com); Fri, 01 Jun 2007 15:42:59 -0700 (PDT) Received: from sca-es-mail-2.sun.com ([192.18.43.133]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JIZ00IYCB3N7ZD0@nwk-avmta-1.sfbay.Sun.COM> for psarc@sun.com (ORCPT psarc@sun.com); Fri, 01 Jun 2007 15:42:59 -0700 (PDT) Received: from fe-sfbay-10.sun.com ([192.18.43.129]) by sca-es-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id l51MgxFB004413 for ; Fri, 01 Jun 2007 15:42:59 -0700 (PDT) Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0JIZ00M01B0WN800@fe-sfbay-10.sun.com> (original mail from Ted.Kim@Sun.COM) for psarc@sun.com (ORCPT psarc@sun.com); Fri, 01 Jun 2007 15:42:59 -0700 (PDT) Received: from [129.153.3.74] by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0JIZ00BFEB3K5UE0@fe-sfbay-10.sun.com> for psarc@sun.com (ORCPT psarc@sun.com); Fri, 01 Jun 2007 15:42:58 -0700 (PDT) Date: Fri, 01 Jun 2007 15:42:12 -0700 From: "Ted H. Kim" Subject: IBTF IP Addressing [PSARC/2007/323 FastTrack timeout 06/08/2007] Sender: Ted.Kim@sun.com To: psarc@sun.com Cc: "Ted H. Kim" , Shanthkumar Hiremath , Bill Taylor , Brendan Doyle Message-id: <4660A0C4.3060107@sun.com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 User-Agent: Thunderbird 1.5.0.7 (X11/20060915) Status: RO Content-Length: 7791 Folks, I am sponsoring this fasttrack (IBTF IP Addressing, PSARC/2007/323) for Shantkumar Hiremath. Timer expires on 06/08/2007. -ted ++++ IBTF IP Addressing ================== Table of Contents ----------------- I. Introduction II. Summary of Changes by Interface A. Transport Interface III. Description of Changes 1. Add PathRecord Lookup APIs, based on IP address 2. Add RDMA IP CM Service APIs 3. Cross references updates, mostly in the "SEE ALSO" IV. Summary of Changes by Man Page I. Introduction --------------- PSARC 2002/132 and successor cases defined the InfiniBand Transport Framework (IBTF) interfaces. This fast track proposes enhancements to provide support for IP addressing based on the RDMA IP CM service as defined by the IBTA 1.2 vol 1 specification, Annex A11. These additions and changes will have a micro/patch binding. In general, there has been a long standing goal of using IP based addresses with Solaris InfiniBand support. To this point, the IB ULPs have used a variety of methods of providing IP addressing. Reliable Datagram Sockets (PSARC/2006/356) (for Oracle support), Sockets Direct Protocol (PSARC/2006/389) and the new NFS over RDMA (currently being developed in OpenSolaris with Ohio State University) all use variations of the same method to get IP addresses. uDAPL (PSARC/2003/145) and the old NFS over RDMA (PSARC/2001/398) also use ATS (PSARC/2004/115) via contracts PSARC/2004/195 and PSARC/2004/715. This case introduces new interfaces for the framework that provide the ability to lookup IB path information based on IP addresses paving the way for all the above cases to be replaced by calls to this new common framework code. Essentially the method used by RDS, SDP and new NFS over RDMA is absorbed into the framework. Eventually the implementation will make use of ip2mac (PSARC/2006/482) when available. The actual obsoleting of the ATS contracts (and possible EOL of ATS itself) will occur in a separate case when it is confirmed that we no longer have external commitments for ATS. Further, the new APIs fold in the now standardized method of exchanging addressing info described in the IB Annex A11 RDMA IP CM Service (see http://webhome.central/iot/ibtf/website/specs/ib-1.2/ip_address_annex.pdf ). II. Summary of Changes by Interface Transport Interface (ON consolidation private) changed ibti(9) ibt_get_paths(9F) ibt_open_rc_channel(9F) ibt_register_service(9F) ibt_set_alt_path(9F) ibt_alt_path_info_t(9S) ibt_arej_info_t(9S) ibt_cm_reason_t(9S) new ibt_ip_path_handler_t(9E) ibt_aget_ip_paths(9F) ibt_format_ip_private_data(9F) ibt_get_ip_alt_path(9F) ibt_get_ip_data() (in ibt_format_ip_private_data(9F)) ibt_get_ip_dst_port() in (ibt_get_ip_protocol_num(9F)) ibt_get_ip_paths(9F) ibt_get_ip_protocol_num(9F) ibt_get_ip_sid(9F) ibt_get_src_ip(9F) ibt_release_ip_sid() (in ibt_get_ip_sid(9F)) ibt_alt_ip_path_attr_t(9S) ibt_ip_addr_t(9S) ibt_ip_path_attr_t(9S) ibt_path_ip_src_t(9S) III. Description of Changes --------------------------- 1. Add PathRecord Lookup APIs, based on IP address These APIs are basically the same as the existing ibt_get_paths(), except adapted to use IP addresses. Likewise, there are async and automatic path migration lookup versions; also the related structs are adapted to use IP addresses. ibti(9) - Add list of new man pages ibt_get_ip_paths(9F) - New, equivalent to ibt_get_paths() ibt_ip_path_attr_t(9S) - New, equivalent to ibt_path_attr_t ibt_ip_addr_t(9S) - New, definitions for IP address query in IB calls ibt_path_ip_src_t(9S) - New, src IP addrs for returned IB paths ibt_aget_ip_paths(9F) - New, equivalent to ibt_aget_paths() ibt_ip_path_handler_t(9E) - New, equivalent to ibt_path_handler_t ibt_get_ip_alt_path(9F) - New, equivalent to ibt_get_alt_path() ibt_alt_ip_path_attr_t(9S) - New, equivalent to ibt_alt_path_attr_t 2. Add RDMA IP CM Service APIs The new RDMA CM IP Addressing A11 annex describes a standard way to map from IP addresses to IB Service IDs (SIDs). The following functions access fields of the newly defined CM IP Address SID range. ibt_get_ip_sid(9F) - New, format and reserve a particular SID ibt_release_ip_sid() (in ibt_get_ip_sid(9F)) - New, release the SID ibt_get_ip_protocol_num(9F) - New, extract the protocol from SID ibt_get_ip_dst_port() in (ibt_get_ip_protocol_num(9F)) - New, extract port These functions format and access fields of the new Communication Manager private data fields for IP address info interchange. Also, new error codes are added to existing man pages: ibt_format_ip_private_data(9F) - New ibt_get_ip_data() (in ibt_format_ip_private_data(9F) - New ibt_cm_reason_t(9S) - Add RDMA IP CM service reject codes. ibt_arej_info_t(9S) - Add RDMA IP CM service reject data. ibt_get_src_ip(9F) - New, find local source IP address based on IB addrs Other: ibt_ip_addr_t(9S) - New, definitions for IP address in IB calls ibti(9) - add references to all new man pages 3. Cross references update, mostly in the "SEE ALSO" ibt_get_paths(9F) ibt_open_rc_channel(9F) ibt_register_service(9F) ibt_set_alt_path(9F) ibt_alt_path_info_t(9S) IV. Summary of Changes by Man Page ---------------------------------- All new man pages can be found in the case materials directory. Changed man pages are also there with change bars applied to the text. Note that the diff files also include some changes which are NOT pertinent to the case. These changes include: o correction of typos o minor changes in phrasing that don't change semantics o formatting changes (mostly reformats done by pubs group) o changes to cross references mostly in the "SEE ALSO" section, but sometimes in the text body Man page Disposition Reason(s) for Change (sorted by section and name) (see section III) ------------------------------------------------------------------------------ ibti(9) changed 1,2 ibt_ip_path_handler_t(9E) New 1 ibt_aget_ip_paths(9F) New 1 ibt_format_ip_private_data(9F) New 2 ibt_get_ip_alt_path(9F) New 1 ibt_get_ip_paths(9F) New 1 ibt_get_ip_protocol_num(9F) New 2 ibt_get_ip_sid(9F) New 2 ibt_get_paths(9F) changed 3 ibt_get_src_ip(9F) New 2 ibt_open_rc_channel(9F) changed 3 ibt_register_service(9F) changed 3 ibt_set_alt_path(9F) changed 3 ibt_alt_ip_path_attr_t(9S) New 1 ibt_alt_path_info_t(9S) changed 3 ibt_arej_info_t(9S) changed 2 ibt_cm_reason_t(9S) changed 2 ibt_ip_addr_t(9S) New 1,2 ibt_ip_path_attr_t(9S) New 1 ibt_path_ip_src_t(9S) New 1 # eof -- Ted H. Kim Sun Microsystems, Inc. ted.kim@sun.com 222 North Sepulveda Blvd., 10th Floor (310) 341-1116 El Segundo, CA 90245 (310) 341-1120 FAX From sacadmin Mon Jun 11 16:50:13 2007 Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id l5BNoDuV014146 for ; Mon, 11 Jun 2007 16:50:13 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l5BNmdks007443 for <@newsunmail1brm.central.sun.com:psarc@sun.com>; Mon, 11 Jun 2007 16:48:40 -0700 (PDT) Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JJH00M01WT3US00@brm-avmta-1.central.sun.com> for psarc@sun.com (ORCPT psarc@sun.com); Mon, 11 Jun 2007 17:48:39 -0600 (MDT) Received: from sca-es-mail-2.sun.com ([192.18.43.133]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JJH00ENHWT27T50@brm-avmta-1.central.sun.com> for psarc@sun.com (ORCPT psarc@sun.com); Mon, 11 Jun 2007 17:48:39 -0600 (MDT) Received: from fe-sfbay-09.sun.com ([192.18.43.129]) by sca-es-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id l5BNmcWT003845 for ; Mon, 11 Jun 2007 16:48:38 -0700 (PDT) Received: from conversion-daemon.fe-sfbay-09.sun.com by fe-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0JJH00501WMCGY00@fe-sfbay-09.sun.com> (original mail from Ted.Kim@Sun.COM) for psarc@sun.com (ORCPT psarc@sun.com); Mon, 11 Jun 2007 16:48:38 -0700 (PDT) Received: from [129.153.3.74] by fe-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0JJH00365WSZBY20@fe-sfbay-09.sun.com> for psarc@sun.com (ORCPT psarc@sun.com); Mon, 11 Jun 2007 16:48:38 -0700 (PDT) Date: Mon, 11 Jun 2007 16:47:35 -0700 From: "Ted H. Kim" Subject: Re: IBTF IP Addressing [PSARC/2007/323 FastTrack timeout 06/08/2007] In-reply-to: <4660A0C4.3060107@sun.com> Sender: Ted.Kim@Sun.COM To: psarc@Sun.COM Cc: "Ted H. Kim" , Shanthkumar Hiremath , Bill Taylor , Brendan Doyle Message-id: <466DDF17.9090201@sun.com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.2.0.264296 References: <4660A0C4.3060107@sun.com> User-Agent: Thunderbird 1.5.0.7 (X11/20060915) Status: RO Content-Length: 289 The timer has expired with no comments on this case. So I am marking this case closed approved. -ted -- Ted H. Kim Sun Microsystems, Inc. ted.kim@sun.com 222 North Sepulveda Blvd., 10th Floor (310) 341-1116 El Segundo, CA 90245 (310) 341-1120 FAX