From mws@zion.sfbay.sun.com Thu Mar 13 15:34:19 2008 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca [129.145.155.234]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2DMYJHn017747 for ; Thu, 13 Mar 2008 15:34:19 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m2DMYHMD000687; Thu, 13 Mar 2008 15:34:19 -0700 (PDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JXO00C09XD5XF00@nwk-avmta-2.sfbay.sun.com>; Thu, 13 Mar 2008 15:34:17 -0700 (PDT) Received: from zion.sfbay.sun.com ([129.146.17.75]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXO0088TXD47S80@nwk-avmta-2.sfbay.sun.com>; Thu, 13 Mar 2008 15:34:16 -0700 (PDT) Received: from zion.sfbay.sun.com (localhost [127.0.0.1]) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id m2DMYFSE558368; Thu, 13 Mar 2008 22:34:15 +0000 (GMT) Received: (from mws@localhost) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit) id m2DMYFuS558367; Thu, 13 Mar 2008 15:34:15 -0700 (PDT) Date: Thu, 13 Mar 2008 15:34:14 -0700 From: Mike Shapiro Subject: PSARC 2008/196 libscsi and libses To: PSARC-ext@sun.com Cc: eric.schrock@sun.com, keith.wesolowski@sun.com, mws@sun.com Message-id: <20080313223414.GA558351@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 User-Agent: Mutt/1.4.2.1i Status: RO Content-Length: 10394 I'm sponsoring the following fast-track for Eric Schrock and Keith Wesolowski to introduce new Private libscsi and libses libraries. The case timer is set for 3/19 and the binding is for a Patch release. A copy of the spec (below) is also saved in the incept.materials directory, and I've also put copies of header files there. -Mike ---8<--- A. DESCRIPTION On Solaris, userland applications wishing to interact with SES devices currently use a combination of uscsi(7I) and ses(7D). Both of these interfaces are difficult to use, and require significant infrastructure in each application. As part of the Sun storage strategy, encompassing both work in Solaris and in the Systems group, it is necessary to create libraries that hide such implementation details and provide clean interfaces on which higher level applications can be developed. The initial consumers of this will be the SES libtopo FMA enumerator and the unbundled CAM storage management utility, but the libraries are being delivered separately as part of this case to enable future work (both in management software and hardware development) to occur in parallel. These interfaces will initially be delivered as consolidation private, with the expectation that they will be made public after we have more experience using them in a wider variety of applications. SES is an industry standard protocol for describing SCSI device enclosures and retrieving status information from them. Refer to t10.org for background and copies of the specifications. SES operates by encoding operations inside of SCSI packets directed as particular SCSI targets that offer SES services. All new disk enclosures being produced by Sun, and many by other vendors, use the SAS protocol as the underlying transport, which in turn escapsulates SCSI, and therefore encapsulates SES. Thus SES is used to manage a SAS JBOD. SES was first introduced into Solaris for use with Tabasco back in 1996 as part of the "envsen" driver, which was renamed to "ses" by a later update. (Score 1 on the crusty old-timer list if you remember Tabasco. Score 2 if somewhere in your office right now a Tabasco is collecting dust.) The ses driver fundamentally provided the ability to statically configure the driver for a given parent and set of nodes in ses.conf so that it would bind to these nodes, and then one can use the ioctl API to read and write SES using some simple C abstractions for the SES data. The binding is described in ses(7D) and the complete history of this stuff is found in: PSARC/1996/289 envsen driver PSARC 1996/421 SES device naming PSARC/1997/195 Common SCSI Enclosure Services Driver PSARC 2001/442 Correcting Device Node Type for SES Later on, Dan "i/o Dan" Price introduced a much more generic mechanism for this kind of software: the sgen driver. Rather than having to rewrite special kernel drivers like ses for these operations, sgen is a generic SCSI pass-through driver that permits userland code to read and write the underlying SCSI protocol and anything that travels in it, like SES. Notice that if "sgen" had existed first, no "ses" driver ever would have been needed in Solaris. sgen exports a generic ioctl API described in uscsi(7I). sgen is described in: PSARC 1999/525 Generic SCSI Pass Through for Solaris PSARC 1999/561 Generic SCSI Pass Through -- Corrections and Update Therefore, the strategy for libses and libscsi, described by this case, is to provide generic services that can sit on top of uscsi and sgen, entirely ignoring the legacy "ses" driver. Future work can EOL that driver, but that is an issue entirely orthogonal to the new software in this case. The project team requests that new work build on this case, rather than the "ses" driver. B. LIBSCSI This library is a thin layer on top of uscsi(7I). It provides an abstraction for managing actions, consisting of CDB, payload, and sense data. The library interfaces with devices through a set of engines that are delivered as separate plugins. While the primary engine for Solaris is uscsi, the plan is to eventually deliver an emulation engine that allows for simplified testing or hardware prototyping. This library also allows cross-platform consumers to be written generically, by porting the basic libscsi interface but providing a different engine on different platforms. The current library header file will be provided in the case materials as an example of the interfaces. C. LIBSES The current ses(7D) driver has several major drawbacks. It is hard to use, requires specialized kernel support, and is difficult to extend. Rather than introducing further complexity into the kernel, it is preferable to construct a library that presents a higher level interface built on uscsi(7I). This library will allow for future changes to the spec as well as vendor-specific functionality. The SES-2 specification presents a straightforward topology of the form: TARGET -> ENCLOSURE -> AGGREGATE -> ELEMENT There is one implicit target at the root of the tree, but each subsequent level can have multiple children. The primary responsibility of the core libses library is to take snapshots of the device state and parse the config page into a tree of nodes, where each node has a set of properties exposed as an nvlist. Control operations are modeled as a per-node function that takes a string indicating the control operation and an nvlist of parameters. Apart from reading the supported pages and parsing the configuration page, libses itself doesn't know anything about parsing per-node properties. Instead, these properties are added by plugins, which can be either framework plugins (SES spec and libses extensions), or vendor-specific (indexed by vendor/product/revision). Each plugin can provide the following functionality: - Descriptions of how to retrieve and parse supported pages. - Method to fill in properties for a node. - Method to handle control operations on a node. This allows plugins to reinterpret existing data (such as the STRING IN page or vendor-specific enclosure data), parse data from vendor-specific pages, or define vendor-specific control operations. The ses2 plugin does the the work of interpreting the SES-2 specification. These properties are prefixed by SES_ (or "ses-" in the nvlist representation). It provides control operations for setting properties (a generic control op for a variety of features) and downloading microcode. There are also several properties that are not defined by the spec, but are common across multiple vendors and products. These properties begin with the prefix LIBSES_ (or "libses-"). The most important one is LIBSES_EN_PROP_CSN, which is the chassis serial number. The SES spec doesn't provide a way to correlate multiple SES processes within in a single logical chassis. In order for SES enumeration of enclosures to work, we need to know when two different SES targets physically reside in the same chassis (either accessing the same elements or disparate elements). Other standard properties include part number and serial number that can be attached to any element. The current header files for the library and plugins are provided in the case materials directory. D. SESTOPO While this case does not deliver any public consumers of libscsi or libses, it does introduce a Private utility, sestopo, which simply iterates over the SES topology and dumps all properties for all nodes. This provides a simple test of libses functionality, and a debugging tool for both enclosure firmware and higher level software. Some example output: Node Type: 2 nvlist version: 0 ses-enclosure-id = 0x0 ses-enclosure-service-proc-id = 0x0 ses-enclosure-service-proc-count = 0x0 ses-logical-id = (embedded nvlist) nvlist version: 0 naa-id-integer = 0x500163600004ddbd naa-id-type = 0x5 naa-company-id = 0x1636 naa-vendor-specific-a = 0x4ddbd (end ses-logical-id) ses-vendor-id = SUN ses-product-id = StorageTek J4400 ses-product-revision = 1R20 ses-element-index = 0x31 ses-element-type = 0xe ses-class-description = Enclosure ... E. DELIVERABLES AND INTERFACES All the interfaces are Contracted Consolidation Private. While it would be possible to deliver these objects in a separate package, the core FMA infrastructure will depend on these libraries, so it seems of little use to deliver them separately. These devlierables will be part of the core Solaris packages (SUNWcsl, SUNWhea, SUNWarc). The exception will be vendor specific plugins, which will be delivered as part of a new SUNWscsip package in order to facilitate creation of minimized systems (such as the miniroot) and easier patching. Summary of Exported Interfaces, all Contracted Consolidation Private: --------------------------------------------------------------------- /usr/lib/scsi SCSI libraries and private commands /usr/lib/scsi/libscsi.so.1 /usr/lib/scsi/{amd64,sparcv9}/libscsi.so.1 SCSI library /usr/lib/scsi/libses.so.1 /usr/lib/scsi/$MACH64/libses.so.1 SES library /usr/lib/scsi/plugins/scsi/engines /usr/lib/scsi/plugins/scsi/engines/uscsi.so /usr/lib/scsi/plugins/scsi/engines/$MACH64/uscsi.so SCSI engines and default system engine (uscsi). /usr/lib/scsi/plugins/ses/framework /usr/lib/scsi/plugins/ses/framework/libses.so /usr/lib/scsi/plugins/ses/framework/ses2.so /usr/lib/scsi/plugins/ses/framework/$MACH64/libses.so /usr/lib/scsi/plugins/ses/framework/$MACH64/ses2.so /usr/lib/scsi/plugins/ses/vendor /usr/lib/scsi/plugins/ses/vendor/Sun-StorageTek-J4400.so /usr/lib/scsi/plugins/ses/vendor/$MACH64/Sun-StorageTek-J4400.so SES plugins, including standard framework plugins and a sample vendor-specific plugin for the J4400. /usr/lib/scsi/sestopo Sample SES program for debugging. /usr/include/scsi /usr/include/scsi/libscsi.h /usr/include/scsi/libses.h SCSI/SES include files /usr/include/scsi/plugins/ses /usr/include/scsi/plugins/ses/framework /usr/include/scsi/plugins/ses/framework/ses2.h /usr/include/scsi/plugins/ses/framework/libses.h /usr/include/scsi/plugins/ses/vendor Plugin-specific headers. The primary purpose is to define available properties that are exported by a plugin. -- Mike Shapiro, Sun Microsystems Fishworks. blogs.sun.com/mws/ From sacadmin Thu Mar 13 15:28:02 2008 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 m2DMS2Xb017564; Thu, 13 Mar 2008 15:28:02 -0700 (PDT) Received: (from mws@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m2DMS2k9017560; Thu, 13 Mar 2008 15:28:02 -0700 (PDT) Date: Thu, 13 Mar 2008 15:28:02 -0700 (PDT) From: Michael Shapiro Message-Id: <200803132228.m2DMS2k9017560@sac.sfbay.sun.com> To: PSARC-record@sac.sfbay.sun.com Subject: libscsi and libses [PSARC/2008/196 FastTrack timeout 03/19/2008] Status: RO Content-Length: 556 Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI This information is Copyright 2008 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: libscsi and libses 1.2. Name of Document Author/Supplier: Author: Eric Schrock 1.3 Date of This Document: 13 March, 2008 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: OS/Net 6.5. ARC review type: FastTrack 6.6. ARC Exposure: open From mws@sac.sfbay.sun.com Thu Mar 13 15:38:37 2008 Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk [129.146.11.52]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2DMcbsf017772 for ; Thu, 13 Mar 2008 15:38:37 -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 m2DMcZxp017323; Thu, 13 Mar 2008 15:38:36 -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 <0JXO0060PXKBSS00@brm-avmta-1.central.sun.com>; Thu, 13 Mar 2008 16:38:35 -0600 (MDT) Received: from dm-sfbay-02.sfbay.sun.com ([129.146.11.31]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXO000X9XKAZV40@brm-avmta-1.central.sun.com>; Thu, 13 Mar 2008 16:38:34 -0600 (MDT) Received: from sac.sfbay.sun.com (new-sac.SFBay.Sun.COM [129.146.175.65]) by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2DMcYTh004064; Thu, 13 Mar 2008 15:38:34 -0700 (PDT) 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 m2DMV4Fh017632; Thu, 13 Mar 2008 15:31:04 -0700 (PDT) Received: (from mws@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m2DMV4t6017631; Thu, 13 Mar 2008 15:31:04 -0700 (PDT) Date: Thu, 13 Mar 2008 15:31:04 -0700 (PDT) From: Michael Shapiro Subject: PSARC 2008/196 libscsi and libses To: psarc-ext@sun.com Cc: eric.schrock@sun.com, keith.wesolowski@sun.com, mws@sun.com Message-id: <200803132231.m2DMV4t6017631@sac.sfbay.sun.com> MIME-version: 1.0 X-Mailer: ELM [version 2.4ME+ PL31H (25)] Content-type: text/plain; charset=US-ASCII Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 Status: RO Content-Length: 10329 I'm sponsoring the following fast-track for Eric Schrock and Keith Wesolowski to introduce new Private libscsi and libses libraries. The case timer is set for 3/19 and the binding is for a Patch release. A copy of the spec (below) is also saved in the incept.materials directory, and I've also put copies of header files there. -Mike ---8<--- A. DESCRIPTION On Solaris, userland applications wishing to interact with SES devices currently use a combination of uscsi(7I) and ses(7D). Both of these interfaces are difficult to use, and require significant infrastructure in each application. As part of the Sun storage strategy, encompassing both work in Solaris and in the Systems group, it is necessary to create libraries that hide such implementation details and provide clean interfaces on which higher level applications can be developed. The initial consumers of this will be the SES libtopo FMA enumerator and the unbundled CAM storage management utility, but the libraries are being delivered separately as part of this case to enable future work (both in management software and hardware development) to occur in parallel. These interfaces will initially be delivered as consolidation private, with the expectation that they will be made public after we have more experience using them in a wider variety of applications. SES is an industry standard protocol for describing SCSI device enclosures and retrieving status information from them. Refer to t10.org for background and copies of the specifications. SES operates by encoding operations inside of SCSI packets directed as particular SCSI targets that offer SES services. All new disk enclosures being produced by Sun, and many by other vendors, use the SAS protocol as the underlying transport, which in turn escapsulates SCSI, and therefore encapsulates SES. Thus SES is used to manage a SAS JBOD. SES was first introduced into Solaris for use with Tabasco back in 1996 as part of the "envsen" driver, which was renamed to "ses" by a later update. (Score 1 on the crusty old-timer list if you remember Tabasco. Score 2 if somewhere in your office right now a Tabasco is collecting dust.) The ses driver fundamentally provided the ability to statically configure the driver for a given parent and set of nodes in ses.conf so that it would bind to these nodes, and then one can use the ioctl API to read and write SES using some simple C abstractions for the SES data. The binding is described in ses(7D) and the complete history of this stuff is found in: PSARC/1996/289 envsen driver PSARC 1996/421 SES device naming PSARC/1997/195 Common SCSI Enclosure Services Driver PSARC 2001/442 Correcting Device Node Type for SES Later on, Dan "i/o Dan" Price introduced a much more generic mechanism for this kind of software: the sgen driver. Rather than having to rewrite special kernel drivers like ses for these operations, sgen is a generic SCSI pass-through driver that permits userland code to read and write the underlying SCSI protocol and anything that travels in it, like SES. Notice that if "sgen" had existed first, no "ses" driver ever would have been needed in Solaris. sgen exports a generic ioctl API described in uscsi(7I). sgen is described in: PSARC 1999/525 Generic SCSI Pass Through for Solaris PSARC 1999/561 Generic SCSI Pass Through -- Corrections and Update Therefore, the strategy for libses and libscsi, described by this case, is to provide generic services that can sit on top of uscsi and sgen, entirely ignoring the legacy "ses" driver. Future work can EOL that driver, but that is an issue entirely orthogonal to the new software in this case. The project team requests that new work build on this case, rather than the "ses" driver. B. LIBSCSI This library is a thin layer on top of uscsi(7I). It provides an abstraction for managing actions, consisting of CDB, payload, and sense data. The library interfaces with devices through a set of engines that are delivered as separate plugins. While the primary engine for Solaris is uscsi, the plan is to eventually deliver an emulation engine that allows for simplified testing or hardware prototyping. This library also allows cross-platform consumers to be written generically, by porting the basic libscsi interface but providing a different engine on different platforms. The current library header file will be provided in the case materials as an example of the interfaces. C. LIBSES The current ses(7D) driver has several major drawbacks. It is hard to use, requires specialized kernel support, and is difficult to extend. Rather than introducing further complexity into the kernel, it is preferable to construct a library that presents a higher level interface built on uscsi(7I). This library will allow for future changes to the spec as well as vendor-specific functionality. The SES-2 specification presents a straightforward topology of the form: TARGET -> ENCLOSURE -> AGGREGATE -> ELEMENT There is one implicit target at the root of the tree, but each subsequent level can have multiple children. The primary responsibility of the core libses library is to take snapshots of the device state and parse the config page into a tree of nodes, where each node has a set of properties exposed as an nvlist. Control operations are modeled as a per-node function that takes a string indicating the control operation and an nvlist of parameters. Apart from reading the supported pages and parsing the configuration page, libses itself doesn't know anything about parsing per-node properties. Instead, these properties are added by plugins, which can be either framework plugins (SES spec and libses extensions), or vendor-specific (indexed by vendor/product/revision). Each plugin can provide the following functionality: - Descriptions of how to retrieve and parse supported pages. - Method to fill in properties for a node. - Method to handle control operations on a node. This allows plugins to reinterpret existing data (such as the STRING IN page or vendor-specific enclosure data), parse data from vendor-specific pages, or define vendor-specific control operations. The ses2 plugin does the the work of interpreting the SES-2 specification. These properties are prefixed by SES_ (or "ses-" in the nvlist representation). It provides control operations for setting properties (a generic control op for a variety of features) and downloading microcode. There are also several properties that are not defined by the spec, but are common across multiple vendors and products. These properties begin with the prefix LIBSES_ (or "libses-"). The most important one is LIBSES_EN_PROP_CSN, which is the chassis serial number. The SES spec doesn't provide a way to correlate multiple SES processes within in a single logical chassis. In order for SES enumeration of enclosures to work, we need to know when two different SES targets physically reside in the same chassis (either accessing the same elements or disparate elements). Other standard properties include part number and serial number that can be attached to any element. The current header files for the library and plugins are provided in the case materials directory. D. SESTOPO While this case does not deliver any public consumers of libscsi or libses, it does introduce a Private utility, sestopo, which simply iterates over the SES topology and dumps all properties for all nodes. This provides a simple test of libses functionality, and a debugging tool for both enclosure firmware and higher level software. Some example output: Node Type: 2 nvlist version: 0 ses-enclosure-id = 0x0 ses-enclosure-service-proc-id = 0x0 ses-enclosure-service-proc-count = 0x0 ses-logical-id = (embedded nvlist) nvlist version: 0 naa-id-integer = 0x500163600004ddbd naa-id-type = 0x5 naa-company-id = 0x1636 naa-vendor-specific-a = 0x4ddbd (end ses-logical-id) ses-vendor-id = SUN ses-product-id = StorageTek J4400 ses-product-revision = 1R20 ses-element-index = 0x31 ses-element-type = 0xe ses-class-description = Enclosure ... E. DELIVERABLES AND INTERFACES All the interfaces are Contracted Consolidation Private. While it would be possible to deliver these objects in a separate package, the core FMA infrastructure will depend on these libraries, so it seems of little use to deliver them separately. These devlierables will be part of the core Solaris packages (SUNWcsl, SUNWhea, SUNWarc). The exception will be vendor specific plugins, which will be delivered as part of a new SUNWscsip package in order to facilitate creation of minimized systems (such as the miniroot) and easier patching. Summary of Exported Interfaces, all Contracted Consolidation Private: --------------------------------------------------------------------- /usr/lib/scsi SCSI libraries and private commands /usr/lib/scsi/libscsi.so.1 /usr/lib/scsi/{amd64,sparcv9}/libscsi.so.1 SCSI library /usr/lib/scsi/libses.so.1 /usr/lib/scsi/$MACH64/libses.so.1 SES library /usr/lib/scsi/plugins/scsi/engines /usr/lib/scsi/plugins/scsi/engines/uscsi.so /usr/lib/scsi/plugins/scsi/engines/$MACH64/uscsi.so SCSI engines and default system engine (uscsi). /usr/lib/scsi/plugins/ses/framework /usr/lib/scsi/plugins/ses/framework/libses.so /usr/lib/scsi/plugins/ses/framework/ses2.so /usr/lib/scsi/plugins/ses/framework/$MACH64/libses.so /usr/lib/scsi/plugins/ses/framework/$MACH64/ses2.so /usr/lib/scsi/plugins/ses/vendor /usr/lib/scsi/plugins/ses/vendor/Sun-StorageTek-J4400.so /usr/lib/scsi/plugins/ses/vendor/$MACH64/Sun-StorageTek-J4400.so SES plugins, including standard framework plugins and a sample vendor-specific plugin for the J4400. /usr/lib/scsi/sestopo Sample SES program for debugging. /usr/include/scsi /usr/include/scsi/libscsi.h /usr/include/scsi/libses.h SCSI/SES include files /usr/include/scsi/plugins/ses /usr/include/scsi/plugins/ses/framework /usr/include/scsi/plugins/ses/framework/ses2.h /usr/include/scsi/plugins/ses/framework/libses.h /usr/include/scsi/plugins/ses/vendor Plugin-specific headers. The primary purpose is to define available properties that are exported by a plugin. From Joerg.Schilling@fokus.fraunhofer.de Thu Mar 13 16:09:07 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2DN96q3019492 for ; Thu, 13 Mar 2008 16:09:06 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2DN93Kk001882; Thu, 13 Mar 2008 23:09:04 GMT Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JXO00E0HYZ2E600@nwk-avmta-2.sfbay.sun.com>; Thu, 13 Mar 2008 16:09:02 -0700 (PDT) Received: from brmea-mail-4.sun.com ([192.18.98.36]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXO008BGYZ17SA0@nwk-avmta-2.sfbay.sun.com>; Thu, 13 Mar 2008 16:09:01 -0700 (PDT) Received: from relay42i.sun.com ([192.5.209.72]) by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m2DLv91K027347; Thu, 13 Mar 2008 23:09:01 +0000 (GMT) Received: from mms49es.sun.com ([160.41.221.233] [160.41.221.233]) by relay42i.sun.com with ESMTP id BT-MMP-228334; Thu, 13 Mar 2008 23:09:00 +0000 (Z) Received: from relay43i.sun.com (relay43i.sun.com [192.5.209.74]) by mms49es.sun.com with ESMTP id BT-MMP-435876; Thu, 13 Mar 2008 23:09:00 +0000 (Z) Received: from mailgw11.noc.fraunhofer.de ([153.96.1.28] [153.96.1.28]) by relay4i.sun.com with ESMTP id BT-MMP-5531821; Thu, 13 Mar 2008 23:09:00 +0000 (Z) Received: from mailgw11.noc.fraunhofer.de (localhost [127.0.0.1]) by mailgw11.noc.fraunhofer.de (8.13.5+/8.13.4) with ESMTP id m2DN7II9013649; Fri, 14 Mar 2008 00:07:18 +0100 (MET) Received: from pluto.fokus.fraunhofer.de (pluto.fokus.fraunhofer.de [195.37.77.164]) by mailgw11.noc.fraunhofer.de (8.13.5+/8.13.4) with ESMTP id m2DN7I5w013640 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 14 Mar 2008 00:07:18 +0100 (MET) Received: from EXCHSRV.fokus.fraunhofer.de (bohr [10.147.9.231]) by pluto.fokus.fraunhofer.de (8.13.7/8.13.7) with SMTP id m2DN7H5J019809; Fri, 14 Mar 2008 00:07:17 +0100 (MET) Received: from rigel ([10.147.65.195]) by EXCHSRV.fokus.fraunhofer.de with Microsoft SMTPSVC(6.0.3790.3959); Fri, 14 Mar 2008 00:07:17 +0100 Date: Fri, 14 Mar 2008 00:07:17 +0100 From: Joerg.Schilling@fokus.fraunhofer.de (Joerg Schilling) Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <20080313223414.GA558351@sun.com> To: PSARC-ext@sun.com, mws@sun.com Cc: mws@sun.com, keith.wesolowski@sun.com, eric.schrock@sun.com Message-id: <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1 Content-transfer-encoding: 8BIT X-PMX-Version: 5.4.1.325704 X-Brightmail-Tracker: AAAAAA== X-Fraunhofer-Email-Policy: accepted X-Antispam: No, score=-1.1/5.0, scanned in 0.122sec at (localhost [127.0.0.1]) by smf-spamd v1.3.1 - http://smfs.sf.net/ References: <20080313223414.GA558351@sun.com> User-Agent: nail 11.22 3/20/05 X-OriginalArrivalTime: 13 Mar 2008 23:07:17.0988 (UTC) FILETIME=[FBE9C240:01C8855E] Status: RO Content-Length: 943 Mike Shapiro wrote: > > I'm sponsoring the following fast-track for Eric Schrock and Keith > Wesolowski to introduce new Private libscsi and libses libraries. > The case timer is set for 3/19 and the binding is for a Patch release. > A copy of the spec (below) is also saved in the incept.materials > directory, and I've also put copies of header files there. Please do not call something libscsi unless you prove that this library really an abstraction from the low level transport interface and the Solaris platform. If you don't know, such a library already exists since August 1986, so why should there be another one. Jörg -- EMail:joerg@schily.isdn.cs.tu-berlin.de (home) Jörg Schilling D-13353 Berlin js@cs.tu-berlin.de (uni) schilling@fokus.fraunhofer.de (work) Blog: http://schily.blogspot.com/ URL: http://cdrecord.berlios.de/old/private/ ftp://ftp.berlios.de/pub/schily From mws@zion.sfbay.sun.com Thu Mar 13 16:27:24 2008 Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2DNRNZZ020010 for ; Thu, 13 Mar 2008 16:27:24 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id m2DNRJXM006764; Fri, 14 Mar 2008 07:27:21 +0800 (SGT) 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 <0JXO00109ZTIR900@nwk-avmta-1.sfbay.Sun.COM>; Thu, 13 Mar 2008 16:27:18 -0700 (PDT) Received: from zion.sfbay.sun.com ([129.146.17.75]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXO00KGEZTH2420@nwk-avmta-1.sfbay.Sun.COM>; Thu, 13 Mar 2008 16:27:17 -0700 (PDT) Received: from zion.sfbay.sun.com (localhost [127.0.0.1]) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id m2DNJlTS559394; Thu, 13 Mar 2008 23:19:47 +0000 (GMT) Received: (from mws@localhost) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit) id m2DNJkpT559393; Thu, 13 Mar 2008 16:19:46 -0700 (PDT) Date: Thu, 13 Mar 2008 16:19:46 -0700 From: Mike Shapiro Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> To: Joerg Schilling Cc: PSARC-ext@sun.com, keith.wesolowski@sun.com, eric.schrock@sun.com Message-id: <20080313231946.GA559252@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> User-Agent: Mutt/1.4.2.1i Status: RO Content-Length: 1064 On Fri, Mar 14, 2008 at 12:07:17AM +0100, Joerg Schilling wrote: > Mike Shapiro wrote: > > > > > I'm sponsoring the following fast-track for Eric Schrock and Keith > > Wesolowski to introduce new Private libscsi and libses libraries. > > The case timer is set for 3/19 and the binding is for a Patch release. > > A copy of the spec (below) is also saved in the incept.materials > > directory, and I've also put copies of header files there. > > Please do not call something libscsi unless you prove that this library > really an abstraction from the low level transport interface and the Solaris > platform. That's what libscsi is. > If you don't know, such a library already exists since August 1986, so why > should there be another one. Solaris is allowed to have whatever namespace of whatever pieces of software we all choose. The ARC's job is to own that namespace and approve changes. There is no common library with this name in Solaris. This case adds one. -Mike -- Mike Shapiro, Sun Microsystems Fishworks. blogs.sun.com/mws/ From Joerg.Schilling@fokus.fraunhofer.de Thu Mar 13 16:29:32 2008 Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2DNTVie020050 for ; Thu, 13 Mar 2008 16:29:32 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id m2DNTSpV007878; Fri, 14 Mar 2008 07:29:29 +0800 (SGT) 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 <0JXO00A0BZX4UX00@brm-avmta-1.central.sun.com>; Thu, 13 Mar 2008 17:29:28 -0600 (MDT) Received: from sca-ea-mail-3.sun.com ([192.18.43.21]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXO001TNZX30050@brm-avmta-1.central.sun.com>; Thu, 13 Mar 2008 17:29:28 -0600 (MDT) Received: from relay41i.sun.com ([192.5.209.70]) by sca-ea-mail-3.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m2DMxI7I026643; Thu, 13 Mar 2008 23:29:27 +0000 (GMT) Received: from mms49es.sun.com ([160.41.221.233] [160.41.221.233]) by relay41i.sun.com with ESMTP id BT-MMP-231643; Thu, 13 Mar 2008 23:29:27 +0000 (Z) Received: from relay42i.sun.com (relay42i.sun.com [192.5.209.72]) by mms49es.sun.com with ESMTP id BT-MMP-546715; Thu, 13 Mar 2008 23:29:27 +0000 (Z) Received: from mailgw2-out.fraunhofer.de ([153.96.1.28] [153.96.1.28]) by relay4i.sun.com with ESMTP id BT-MMP-5543555; Thu, 13 Mar 2008 23:29:26 +0000 (Z) Received: from mailgw25.noc.fraunhofer.de (localhost [127.0.0.1]) by mailgw2-out.fraunhofer.de[host mailgw25] (8.14.2+/8.14.2) with ESMTP id m2DNSZ2b025733; Fri, 14 Mar 2008 00:28:35 +0100 (CET) Received: from pluto.fokus.fraunhofer.de (pluto.fokus.fraunhofer.de [195.37.77.164]) by mailgw25.noc.fraunhofer.de (8.14.2+/8.14.2) with ESMTP id m2DNSYF6025705 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 14 Mar 2008 00:28:34 +0100 (CET) Received: from EXCHSRV.fokus.fraunhofer.de (bohr [10.147.9.231]) by pluto.fokus.fraunhofer.de (8.13.7/8.13.7) with SMTP id m2DNSYiV020531; Fri, 14 Mar 2008 00:28:34 +0100 (MET) Received: from rigel ([10.147.65.195]) by EXCHSRV.fokus.fraunhofer.de with Microsoft SMTPSVC(6.0.3790.3959); Fri, 14 Mar 2008 00:28:34 +0100 Date: Fri, 14 Mar 2008 00:28:34 +0100 From: Joerg.Schilling@fokus.fraunhofer.de (Joerg Schilling) Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <20080313231946.GA559252@sun.com> To: mws@sun.com Cc: PSARC-ext@sun.com, keith.wesolowski@sun.com, eric.schrock@sun.com Message-id: <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1 Content-transfer-encoding: 8BIT X-PMX-Version: 5.4.1.325704 X-Brightmail-Tracker: AAAAAA== X-Fraunhofer-Email-Policy: accepted X-Antispam: No, score=0.0/5.0, scanned in 0.129sec at (localhost [127.0.0.1]) by smf-spamd v1.3.1 - http://smfs.sf.net/ References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> X-Authentication-warning: mailgw25.noc.fraunhofer.de: Host localhost [127.0.0.1] claimed to be mailgw25.noc.fraunhofer.de User-Agent: nail 11.22 3/20/05 X-OriginalArrivalTime: 13 Mar 2008 23:28:34.0372 (UTC) FILETIME=[F4B28040:01C88561] Status: RO Content-Length: 614 Mike Shapiro wrote: > > Please do not call something libscsi unless you prove that this library > > really an abstraction from the low level transport interface and the Solaris > > platform. > > That's what libscsi is. Then send an interface description to allow to check whether this is true... Jörg -- EMail:joerg@schily.isdn.cs.tu-berlin.de (home) Jörg Schilling D-13353 Berlin js@cs.tu-berlin.de (uni) schilling@fokus.fraunhofer.de (work) Blog: http://schily.blogspot.com/ URL: http://cdrecord.berlios.de/old/private/ ftp://ftp.berlios.de/pub/schily From James.McPherson@sun.com Thu Mar 13 16:45:52 2008 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2DNjq9N020227 for ; Thu, 13 Mar 2008 16:45:52 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m2DNjnTF012308 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 13 Mar 2008 17:45:52 -0600 (MDT) 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 <0JXP0031B0OETP00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 13 Mar 2008 16:45:50 -0700 (PDT) Received: from sineb-mail-1.sun.com ([192.18.19.6]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXP00KRH0OC1V20@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 13 Mar 2008 16:45:50 -0700 (PDT) Received: from fe-apac-05.sun.com (fe-apac-05.sun.com [192.18.19.176] (may be forged)) by sineb-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m2DNjtpW013933 for ; Thu, 13 Mar 2008 23:45:55 +0000 (GMT) Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0JXP004010L5H300@mail-apac.sun.com> (original mail from James.McPherson@Sun.COM) for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri, 14 Mar 2008 07:45:48 +0800 (SGT) Received: from [192.168.1.35] ([220.157.71.44]) by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0JXP00JBJ0OAE77D@mail-apac.sun.com>; Fri, 14 Mar 2008 07:45:48 +0800 (SGT) Date: Fri, 14 Mar 2008 09:46:32 +1000 From: "James C. McPherson" Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> Sender: James.McPherson@sun.com To: Joerg Schilling Cc: mws@sun.com, PSARC-ext@sun.com, keith.wesolowski@sun.com, eric.schrock@sun.com Reply-to: James.McPherson@sun.com Message-id: <47D9BCD8.4030708@Sun.COM> Organization: Sun Microsystems MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=UTF-8 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> User-Agent: Thunderbird 2.0.0.9 (X11/20080128) Status: RO Content-Length: 949 Joerg Schilling wrote: > Mike Shapiro wrote: > >>> Please do not call something libscsi unless you prove that this library >>> really an abstraction from the low level transport interface and the Solaris >>> platform. >> That's what libscsi is. > > Then send an interface description to allow to check whether this is true... The preface that Mike added to the original email said "A copy of the spec (below) is also saved in the incept.materials directory, and I've also put copies of header files there." I expect - since this is an Open fasttrack - that the materials should show up on opensolaris.org fairly soon. Perhaps you might want to check the directory http://opensolaris.org/os/community/arc/caselog/2008/196 in a few hours (give the synchronisation time to occur). James C. McPherson -- Senior Kernel Software Engineer, Solaris Sun Microsystems http://blogs.sun.com/jmcp http://www.jmcp.homeunix.com/blog From gdamore@sun.com Thu Mar 13 21:34:16 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2E4YFO5026773 for ; Thu, 13 Mar 2008 21:34:16 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2E4Y64i024011 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 14 Mar 2008 04:34:14 GMT 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 <0JXP00B01E11P200@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 13 Mar 2008 22:34:13 -0600 (MDT) Received: from sca-es-mail-1.sun.com ([192.18.43.132]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXP002VGE0ZVW80@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 13 Mar 2008 22:34:12 -0600 (MDT) Received: from fe-sfbay-09.sun.com ([192.18.43.129]) by sca-es-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m2E4YBMX026650 for ; Thu, 13 Mar 2008 21:34:11 -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 <0JXP00901E077600@fe-sfbay-09.sun.com> (original mail from gdamore@sun.com) for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 13 Mar 2008 21:34:11 -0700 (PDT) Received: from [192.168.251.106] ([76.174.83.55]) by fe-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0JXP00CHZE0YKM80@fe-sfbay-09.sun.com>; Thu, 13 Mar 2008 21:34:10 -0700 (PDT) Date: Thu, 13 Mar 2008 21:31:34 -0700 From: "Garrett D'Amore" Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47D9BCD8.4030708@Sun.COM> Sender: Garrett.Damore@sun.com To: James.McPherson@sun.com Cc: Joerg Schilling , mws@sun.com, PSARC-ext@sun.com, Keith.Wesolowski@sun.com, Eric.Schrock@sun.com Message-id: <47D9FFA6.1070406@sun.com> MIME-version: 1.0 Content-type: multipart/mixed; boundary="Boundary_(ID_2oJ5GPk6ovcA41T0lavFkQ)" X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> User-Agent: Thunderbird 2.0.0.6 (X11/20071023) Status: RO Content-Length: 8207 This is a multi-part message in MIME format. --Boundary_(ID_2oJ5GPk6ovcA41T0lavFkQ) Content-type: text/plain; format=flowed; charset=UTF-8 Content-transfer-encoding: 7BIT Its not updated yet. I've attached a copy of libscsi.h for Joerg's benefit. -- Garrett James C. McPherson wrote: > Joerg Schilling wrote: >> Mike Shapiro wrote: >> >>>> Please do not call something libscsi unless you prove that this >>>> library really an abstraction from the low level transport >>>> interface and the Solaris platform. >>> That's what libscsi is. >> >> Then send an interface description to allow to check whether this is >> true... > > The preface that Mike added to the original email said > > "A copy of the spec (below) is also saved in the incept.materials > directory, and I've also put copies of header files there." > > > > > I expect - since this is an Open fasttrack - that the materials > should show up on opensolaris.org fairly soon. > > Perhaps you might want to check the directory > > http://opensolaris.org/os/community/arc/caselog/2008/196 > > in a few hours (give the synchronisation time to occur). > > > > James C. McPherson > -- > Senior Kernel Software Engineer, Solaris > Sun Microsystems > http://blogs.sun.com/jmcp http://www.jmcp.homeunix.com/blog --Boundary_(ID_2oJ5GPk6ovcA41T0lavFkQ) Content-type: text/plain; name=libscsi.h Content-transfer-encoding: 7BIT Content-disposition: inline; filename=libscsi.h /* * CDDL HEADER START * * The contents of this file are subject to the terms of the * Common Development and Distribution License (the "License"). * You may not use this file except in compliance with the License. * * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE * or http://www.opensolaris.org/os/licensing. * See the License for the specific language governing permissions * and limitations under the License. * * When distributing Covered Code, include this CDDL HEADER in each * file and include the License file at usr/src/OPENSOLARIS.LICENSE. * If applicable, add the following below this CDDL HEADER, with the * fields enclosed by brackets "[]" replaced with your own identifying * information: Portions Copyright [yyyy] [name of copyright owner] * * CDDL HEADER END */ /* * Copyright 2008 Sun Microsystems, Inc. All rights reserved. * Use is subject to license terms. */ #ifndef _LIBSCSI_H #define _LIBSCSI_H #pragma ident "@(#)libscsi.h 1.1 08/03/03 SMI" #ifdef __cplusplus extern "C" { #endif #include #include #include #include #define LIBSCSI_VERSION 1 #define LIBSCSI_STATUS_INVALID ((sam4_status_t)-1) #define LIBSCSI_DEFAULT_ENGINE_PATH "/usr/lib/scsi/plugins/scsi/engines" #define LIBSCSI_DEFAULT_ENGINE "uscsi" /* * Flags for action creation. Selected to avoid overlap with the uscsi * flags with similar or identical meaning. */ #define LIBSCSI_AF_READ 0x80000000 #define LIBSCSI_AF_WRITE 0x40000000 #define LIBSCSI_AF_SILENT 0x20000000 #define LIBSCSI_AF_DIAGNOSE 0x10000000 #define LIBSCSI_AF_ISOLATE 0x08000000 #define LIBSCSI_AF_RQSENSE 0x04000000 typedef enum libscsi_errno { ESCSI_NONE, /* no error */ ESCSI_NOMEM, /* no memory */ ESCSI_ZERO_LENGTH, /* zero-length allocation requested */ ESCSI_VERSION, /* library version mismatch */ ESCSI_BADTARGET, /* invalid target specification */ ESCSI_BADCMD, /* invalid SCSI command */ ESCSI_BADENGINE, /* engine library corrupt */ ESCSI_NOENGINE, /* engine library not found */ ESCSI_ENGINE_INIT, /* engine initialization failed */ ESCSI_ENGINE_VER, /* engine version mismatch */ ESCSI_ENGINE_BADPATH, /* engine path contains no usable components */ ESCSI_BADFLAGS, /* incorrect action flags */ ESCSI_BOGUSFLAGS, /* unknown flag value */ ESCSI_BADLENGTH, /* buffer length overflow */ ESCSI_NEEDBUF, /* missing required buffer */ ESCSI_IO, /* I/O operation failed */ ESCSI_SYS, /* system call failed */ ESCSI_PERM, /* insufficient permissions */ ESCSI_RANGE, /* parameter outside valid range */ ESCSI_NOTSUP, /* operation not supported */ ESCSI_UNKNOWN, /* error of unknown type */ ESCSI_INQUIRY_FAILED, /* initial inquiry command failed */ ESCSI_MAX /* maximum libscsi errno value */ } libscsi_errno_t; struct libscsi_hdl; typedef struct libscsi_hdl libscsi_hdl_t; struct libscsi_target; typedef struct libscsi_target libscsi_target_t; typedef struct libscsi_status { uint64_t lss_status; /* SCSI status of this command */ size_t lss_sense_len; /* Length in bytes of sense data */ uint8_t *lss_sense_data; /* Pointer to sense data */ } libscsi_status_t; struct libscsi_action; typedef struct libscsi_action libscsi_action_t; struct libscsi_result; typedef struct libscsi_result libscsi_result_t; typedef struct libscsi_engine_ops { void *(*lseo_open)(libscsi_hdl_t *, const void *); void (*lseo_close)(libscsi_hdl_t *, void *); int (*lseo_exec)(libscsi_hdl_t *, void *, libscsi_action_t *); void (*lseo_target_name)(libscsi_hdl_t *, void *, char *, size_t); } libscsi_engine_ops_t; typedef struct libscsi_engine { const char *lse_name; uint_t lse_libversion; const libscsi_engine_ops_t *lse_ops; } libscsi_engine_t; extern libscsi_hdl_t *libscsi_init(uint_t, libscsi_errno_t *); extern void libscsi_fini(libscsi_hdl_t *); extern libscsi_target_t *libscsi_open(libscsi_hdl_t *, const char *, const void *); extern void libscsi_close(libscsi_hdl_t *, libscsi_target_t *); extern libscsi_hdl_t *libscsi_get_handle(libscsi_target_t *); extern const char *libscsi_vendor(libscsi_target_t *); extern const char *libscsi_product(libscsi_target_t *); extern const char *libscsi_revision(libscsi_target_t *); extern libscsi_errno_t libscsi_errno(libscsi_hdl_t *); extern const char *libscsi_errmsg(libscsi_hdl_t *); extern const char *libscsi_strerror(libscsi_errno_t); extern const char *libscsi_errname(libscsi_errno_t); extern libscsi_errno_t libscsi_errcode(const char *); extern libscsi_action_t *libscsi_action_alloc(libscsi_hdl_t *, spc3_cmd_t, uint_t, void *, size_t); extern sam4_status_t libscsi_action_get_status(const libscsi_action_t *); extern void libscsi_action_set_timeout(libscsi_action_t *, uint32_t); extern uint32_t libscsi_action_get_timeout(const libscsi_action_t *); extern uint_t libscsi_action_get_flags(const libscsi_action_t *); extern uint8_t *libscsi_action_get_cdb(const libscsi_action_t *); extern int libscsi_action_get_buffer(const libscsi_action_t *, uint8_t **, size_t *, size_t *); extern int libscsi_action_get_sense(const libscsi_action_t *, uint8_t **, size_t *, size_t *); extern int libscsi_action_parse_sense(const libscsi_action_t *, uint64_t *, uint64_t *, uint64_t *, diskaddr_t *); extern void libscsi_action_set_status(libscsi_action_t *, sam4_status_t); extern int libscsi_action_set_datalen(libscsi_action_t *, size_t); extern int libscsi_action_set_senselen(libscsi_action_t *, size_t); extern int libscsi_exec(libscsi_action_t *, libscsi_target_t *); extern void libscsi_action_free(libscsi_action_t *); extern const char *libscsi_sense_key_name(uint64_t); extern const char *libscsi_sense_code_name(uint64_t, uint64_t); /* * Interfaces for engine providers */ extern void *libscsi_alloc(libscsi_hdl_t *, size_t); extern void *libscsi_zalloc(libscsi_hdl_t *, size_t); extern char *libscsi_strdup(libscsi_hdl_t *, const char *); extern void libscsi_free(libscsi_hdl_t *, void *); extern libscsi_status_t *libscsi_status_alloc(libscsi_hdl_t *, size_t); extern int libscsi_status_fill(libscsi_hdl_t *, libscsi_status_t *, uint16_t, size_t); extern void libscsi_status_free(libscsi_hdl_t *, libscsi_status_t *); extern int libscsi_set_errno(libscsi_hdl_t *, libscsi_errno_t); extern int libscsi_verror(libscsi_hdl_t *, libscsi_errno_t, const char *, va_list); extern int libscsi_error(libscsi_hdl_t *, libscsi_errno_t, const char *, ...); typedef const libscsi_engine_t *(*libscsi_engine_init_f)(libscsi_hdl_t *); /* * Generic SCSI utility functions. */ extern size_t libscsi_cmd_cdblen(libscsi_hdl_t *, uint8_t); #ifdef __cplusplus } #endif #endif /* _LIBSCSI_H */ --Boundary_(ID_2oJ5GPk6ovcA41T0lavFkQ)-- From Joerg.Schilling@fokus.fraunhofer.de Fri Mar 14 07:06:49 2008 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2EE6nkN011736 for ; Fri, 14 Mar 2008 07:06:49 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m2EE6ilT018623; Fri, 14 Mar 2008 08:06:46 -0600 (MDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JXQ0071T4J98S00@nwk-avmta-2.sfbay.sun.com>; Fri, 14 Mar 2008 07:06:45 -0700 (PDT) Received: from brmea-mail-2.sun.com ([192.18.98.43]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXQ007UE4J74M00@nwk-avmta-2.sfbay.sun.com>; Fri, 14 Mar 2008 07:06:43 -0700 (PDT) Received: from relay12i.sun.com (ip122.net129179-4.block1.us.syntegra.com [129.179.4.122]) by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m2EDolkH022516; Fri, 14 Mar 2008 14:06:42 +0000 (GMT) Received: from mmp11es.sun.com ([160.41.209.21] [160.41.209.21]) by relay12i.sun.com with ESMTP id BT-MMP-99678; Fri, 14 Mar 2008 14:06:42 +0000 (Z) Received: from relay12i.sun.com (relay12i.sun.com [129.179.4.122]) by mmp11es.sun.com with ESMTP id BT-MMP-2207454; Fri, 14 Mar 2008 14:06:42 +0000 (Z) Received: from mailgwb1.fraunhofer.de ([153.96.1.17] [153.96.1.17]) by relay1i.sun.com with ESMTP id BT-MMP-767381; Fri, 14 Mar 2008 14:06:42 +0000 (Z) Received: from mailgwb1.fraunhofer.de (localhost [127.0.0.1]) by mailgwb1.fraunhofer.de[host mailgwb1] (8.14.2+/8.14.2) with ESMTP id m2EE4vmS019346; Fri, 14 Mar 2008 15:04:57 +0100 (CET) Received: from pluto.fokus.fraunhofer.de (pluto.fokus.fraunhofer.de [195.37.77.164]) by mailgwb1.fraunhofer.de (8.14.2+/8.14.2) with ESMTP id m2EE4vAB019317 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 14 Mar 2008 15:04:57 +0100 (CET) Received: from EXCHSRV.fokus.fraunhofer.de (bohr [10.147.9.231]) by pluto.fokus.fraunhofer.de (8.13.7/8.13.7) with SMTP id m2EE6ZZ8005727; Fri, 14 Mar 2008 15:06:35 +0100 (MET) Received: from rigel ([10.147.65.195]) by EXCHSRV.fokus.fraunhofer.de with Microsoft SMTPSVC(6.0.3790.3959); Fri, 14 Mar 2008 15:06:36 +0100 Date: Fri, 14 Mar 2008 15:06:35 +0100 From: Joerg.Schilling@fokus.fraunhofer.de (Joerg Schilling) Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47D9BCD8.4030708@Sun.COM> To: james.mcpherson@sun.com Cc: PSARC-ext@sun.com, mws@sun.com, Keith.Wesolowski@sun.com, Eric.Schrock@sun.com Message-id: <47da866b.c79QReI9BmlTbLzj%Joerg.Schilling@fokus.fraunhofer.de> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1 Content-transfer-encoding: 8BIT X-PMX-Version: 5.4.1.325704 X-Brightmail-Tracker: AAAAAA== X-Fraunhofer-Email-Policy: accepted X-Antispam: No, score=-2.6/5.0, scanned in 0.079sec at (localhost [127.0.0.1]) by smf-spamd v1.3.1 - http://smfs.sf.net/ References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> User-Agent: nail 11.22 3/20/05 X-OriginalArrivalTime: 14 Mar 2008 14:06:36.0071 (UTC) FILETIME=[9D6FD370:01C885DC] Status: RO Content-Length: 687 "James C. McPherson" wrote: > I expect - since this is an Open fasttrack - that the materials > should show up on opensolaris.org fairly soon. > > Perhaps you might want to check the directory > > http://opensolaris.org/os/community/arc/caselog/2008/196 > > in a few hours (give the synchronisation time to occur). The data is (14+ hours later) still missing. Jörg -- EMail:joerg@schily.isdn.cs.tu-berlin.de (home) Jörg Schilling D-13353 Berlin js@cs.tu-berlin.de (uni) schilling@fokus.fraunhofer.de (work) Blog: http://schily.blogspot.com/ URL: http://cdrecord.berlios.de/old/private/ ftp://ftp.berlios.de/pub/schily From John.Plocher@sun.com Fri Mar 14 15:11:58 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2EMBvup027877 for ; Fri, 14 Mar 2008 15:11:57 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2EMBs6v011021 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 14 Mar 2008 22:11:56 GMT 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 <0JXQ0070HQZVQR00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri, 14 Mar 2008 15:11:55 -0700 (PDT) Received: from sca-es-mail-1.sun.com ([192.18.43.132]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXQ001MGQZUO430@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri, 14 Mar 2008 15:11:54 -0700 (PDT) Received: from fe-sfbay-10.sun.com ([192.18.43.129]) by sca-es-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m2EMBsSa012218 for ; Fri, 14 Mar 2008 15:11:54 -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 <0JXQ00K01QEEAM00@fe-sfbay-10.sun.com> (original mail from John.Plocher@Sun.COM) for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri, 14 Mar 2008 15:11:54 -0700 (PDT) Received: from wp668.local ([208.74.177.212]) by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0JXQ00EA4QZNAR80@fe-sfbay-10.sun.com>; Fri, 14 Mar 2008 15:11:47 -0700 (PDT) Date: Fri, 14 Mar 2008 15:11:47 -0700 From: John Plocher Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47da866b.c79QReI9BmlTbLzj%Joerg.Schilling@fokus.fraunhofer.de> Sender: John.Plocher@sun.com To: Joerg Schilling Cc: James.McPherson@sun.com, PSARC-ext@sun.com, Eric.Schrock@sun.com, Keith.Wesolowski@sun.com, mws@sun.com Message-id: <47DAF823.3040207@Sun.Com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 8BIT X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> <47da866b.c79QReI9BmlTbLzj%Joerg.Schilling@fokus.fraunhofer.de> User-Agent: Thunderbird 2.0.0.12 (Macintosh/20080213) Status: RO Content-Length: 3331 >> http://opensolaris.org/os/community/arc/caselog/2008/196 >> > in a few hours (give the synchronisation time to occur). > > The data is (14+ hours later) still missing. The mirroring script runs in the wee hours of the morning here in California; it takes several to many hours to run (mostly due to the slowness of the OS.o web app) and fails quite often (due to the bugginess in the OS.o web app and associated web infrastructure). The cron job failed to successfully interact with the OS.o website after 5 retries this morning. After poking around the OS.o website to check and see if there were indeed any long term breakages or web form changes, I manually reran the mirror this morning at ~10:00amPDT: >... > Updating html .../caselog/2008/189/ (2008/189 - Meld - graphical diff/merge tool) > Already uploaded .../caselog/2008/189/materials/ (materials) > Already uploaded .../caselog/2008/189/materials/meld-1/ (meld.1) > Updating attachment .../caselog/2008/189/mail/ (Mail Folder (6 msgs)) > Already uploaded .../caselog/2008/189/onepager/ (onepager) > Updating html .../caselog/2008/191/ (2008/191 - Deliver Lighttpd 1.4.x into OpenSolaris) > Already uploaded .../caselog/2008/191/onepager/ (onepager) > Already uploaded .../caselog/2008/191/materials/ (materials) > Already uploaded .../caselog/2008/191/materials/lighttpd-txt/ (lighttpd) > Updating attachment .../caselog/2008/191/mail/ (Mail Folder (10 msgs)) > Creating html .../caselog/2008/196/ (2008/196 - libscsi and libses) > Creating html .../caselog/2008/196/incept-materials/ (incept.materials) > Creating html .../caselog/2008/196/incept-materials/libscsi-h/ (libscsi.h) > Creating html .../caselog/2008/196/incept-materials/ses2-h/ (ses2.h) > Creating html .../caselog/2008/196/incept-materials/libses-h/ (libses.h) > Creating html .../caselog/2008/196/incept-materials/spec-txt/ (spec) > Creating html .../caselog/2008/196/incept-materials/libses_plugin-h/ (libses_plugin.h) > Attaching .../caselog/2008/196/mail/ (Mail Folder (9 msgs)) > Creating html .../caselog/2008/196/onepager/ (onepager) > Stats: > Web Site Interactions: > +-------------+------------------+------------------+------------------+ > |Page |Failed |Unchanged |Uploaded | > | Type |pages/sec (each)|pages/sec (each)|pages/sec (each)| > +-------------+------------------+------------------+------------------+ > |attachment | 0/0 ( 0.0)| 11/1 ( 0.1)| 12/925 (77.1)| > |page | 0/0 ( 0.0)| 314/8824 (28.1)| 34/3329 (97.9)| > +-------------+------------------+------------------+------------------+ > > Web site interactions for 371 files took 3 hours 37 min 59 sec > Total program run time was 3 hours 42 min 56 sec -John Joerg Schilling wrote: > "James C. McPherson" wrote: > >> I expect - since this is an Open fasttrack - that the materials >> should show up on opensolaris.org fairly soon. >> >> Perhaps you might want to check the directory >> >> http://opensolaris.org/os/community/arc/caselog/2008/196 >> >> in a few hours (give the synchronisation time to occur). > > The data is (14+ hours later) still missing. > > Jörg > From James.McPherson@sun.com Sun Mar 16 17:00:51 2008 Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2H00oSh023451 for ; Sun, 16 Mar 2008 17:00:51 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id m2H00m9b000314 for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Mon, 17 Mar 2008 08:00:49 +0800 (SGT) 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 <0JXU00J0PLDB2S00@brm-avmta-1.central.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Sun, 16 Mar 2008 18:00:47 -0600 (MDT) Received: from sineb-mail-1.sun.com ([192.18.19.6]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXU00IK0LD97600@brm-avmta-1.central.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Sun, 16 Mar 2008 18:00:46 -0600 (MDT) Received: from fe-apac-06.sun.com (fe-apac-06.sun.com [192.18.19.177] (may be forged)) by sineb-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m2H00riN028927 for ; Mon, 17 Mar 2008 00:00:53 +0000 (GMT) Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0JXU00901L9WFU00@mail-apac.sun.com> (original mail from James.McPherson@Sun.COM) for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Mon, 17 Mar 2008 08:00:38 +0800 (SGT) Received: from [192.168.1.35] ([220.157.71.44]) by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0JXU00B85LCZMGR4@mail-apac.sun.com>; Mon, 17 Mar 2008 08:00:37 +0800 (SGT) Date: Mon, 17 Mar 2008 10:01:36 +1000 From: "James C. McPherson" Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <20080313223414.GA558351@sun.com> Sender: James.McPherson@sun.com To: Eric.Schrock@sun.com Cc: Mike Shapiro , Keith.Wesolowski@sun.com, psarc-ext@sun.com Reply-to: James.McPherson@sun.com Message-id: <47DDB4E0.6050602@Sun.COM> Organization: Sun Microsystems MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=UTF-8 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> User-Agent: Thunderbird 2.0.0.9 (X11/20080128) Status: RO Content-Length: 1369 Mike Shapiro wrote: > I'm sponsoring the following fast-track for Eric Schrock and Keith > Wesolowski to introduce new Private libscsi and libses libraries. > The case timer is set for 3/19 and the binding is for a Patch release. > A copy of the spec (below) is also saved in the incept.materials > directory, and I've also put copies of header files there. > > -Mike > > ---8<--- ... > E. DELIVERABLES AND INTERFACES ... > Summary of Exported Interfaces, all Contracted Consolidation Private: > --------------------------------------------------------------------- ... > /usr/include/scsi > /usr/include/scsi/libscsi.h > /usr/include/scsi/libses.h > > SCSI/SES include files > > /usr/include/scsi/plugins/ses > /usr/include/scsi/plugins/ses/framework > /usr/include/scsi/plugins/ses/framework/ses2.h > /usr/include/scsi/plugins/ses/framework/libses.h > /usr/include/scsi/plugins/ses/vendor > > Plugin-specific headers. The primary purpose is to define > available properties that are exported by a plugin. Hi Eric, Could we get some common status code mappings / handlers added to ses2.h? Something common that makes use of the definitions in ses2_dl_ucode_status would probably be a good thing. thanks in advance, James C. McPherson -- Senior Kernel Software Engineer, Solaris Sun Microsystems http://blogs.sun.com/jmcp http://www.jmcp.homeunix.com/blog From eschrock@zion.sfbay.sun.com Mon Mar 17 09:30:22 2008 Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk [129.146.11.52]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2HGUMlE017060 for ; Mon, 17 Mar 2008 09:30:22 -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 m2HGUJkW020628; Mon, 17 Mar 2008 09:30:20 -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 <0JXV00M0TV6JVE00@brm-avmta-1.central.sun.com>; Mon, 17 Mar 2008 10:30:19 -0600 (MDT) Received: from zion.sfbay.sun.com ([129.146.17.75]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXV00L0WV6B6H20@brm-avmta-1.central.sun.com>; Mon, 17 Mar 2008 10:30:12 -0600 (MDT) Received: from zion.sfbay.sun.com (localhost [127.0.0.1]) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id m2HGUBur596769; Mon, 17 Mar 2008 16:30:11 +0000 (GMT) Received: (from eschrock@localhost) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit) id m2HGUAlA596768; Mon, 17 Mar 2008 09:30:10 -0700 (PDT) Date: Mon, 17 Mar 2008 09:30:10 -0700 From: Eric Schrock Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47DDB4E0.6050602@Sun.COM> To: "James C. McPherson" Cc: Mike Shapiro , Keith.Wesolowski@sun.com, psarc-ext@sun.com Message-id: <20080317163010.GC572045@eng.sun.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47DDB4E0.6050602@Sun.COM> User-Agent: Mutt/1.4.2.1i Status: RO Content-Length: 574 On Mon, Mar 17, 2008 at 10:01:36AM +1000, James C. McPherson wrote: > > Hi Eric, > Could we get some common status code mappings / handlers > added to ses2.h? Something common that makes use of the > definitions in ses2_dl_ucode_status would probably be a > good thing. > I'm not sure what you're asking for. The ses2_dl_ucode_status_t values are available in the SES_EN_PROP_UCODE property of the enclosure node. Why would we need any mappings / handlers, and what would they do? - Eric -- Eric Schrock, Fishworks http://blogs.sun.com/eschrock From James.McPherson@sun.com Mon Mar 17 14:06:49 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2HL6nFG027350 for ; Mon, 17 Mar 2008 14:06:49 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2HL6i9s006608 for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Mon, 17 Mar 2008 21:06:48 GMT Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JXW00J0L7ZB4L00@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Mon, 17 Mar 2008 14:06:47 -0700 (PDT) Received: from sineb-mail-1.sun.com ([192.18.19.6]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXW00I1G7Z9HZ10@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Mon, 17 Mar 2008 14:06:46 -0700 (PDT) Received: from fe-apac-05.sun.com (fe-apac-05.sun.com [192.18.19.176] (may be forged)) by sineb-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m2HL6sal003955 for ; Mon, 17 Mar 2008 21:06:54 +0000 (GMT) Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0JXW000017SZQ400@mail-apac.sun.com> (original mail from James.McPherson@Sun.COM) for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Tue, 18 Mar 2008 05:06:43 +0800 (SGT) Received: from [192.168.1.35] ([220.157.71.44]) by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0JXW00JRK7Z2C77O@mail-apac.sun.com>; Tue, 18 Mar 2008 05:06:43 +0800 (SGT) Date: Tue, 18 Mar 2008 07:07:37 +1000 From: "James C. McPherson" Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <20080317163010.GC572045@eng.sun.com> Sender: James.McPherson@sun.com To: Eric Schrock Cc: Mike Shapiro , Keith.Wesolowski@sun.com, psarc-ext@sun.com Reply-to: James.McPherson@sun.com Message-id: <47DEDD99.9050002@Sun.COM> Organization: Sun Microsystems MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=UTF-8 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47DDB4E0.6050602@Sun.COM> <20080317163010.GC572045@eng.sun.com> User-Agent: Thunderbird 2.0.0.9 (X11/20080128) Status: RO Content-Length: 2207 Eric Schrock wrote: > On Mon, Mar 17, 2008 at 10:01:36AM +1000, James C. McPherson wrote: >> Hi Eric, >> Could we get some common status code mappings / handlers >> added to ses2.h? Something common that makes use of the >> definitions in ses2_dl_ucode_status would probably be a >> good thing. >> > > I'm not sure what you're asking for. The ses2_dl_ucode_status_t values > are available in the SES_EN_PROP_UCODE property of the enclosure node. > Why would we need any mappings / handlers, and what would they do? Hi Eric, I was thinking that having something like the following as common code would be preferable to seeing consumers of libses rolling their own each time they needed some status mappings: ================ typedef struct ucode_statdesc { uint64_t us_value; const char *us_desc; boolean_t us_pending; boolean_t us_iserr; } ucode_statdesc_t; static ucode_statdesc_t ucode_statdesc_table[] = { { SES2_DLUCODE_S_NOP, "none", B_FALSE, B_FALSE }, { SES2_DLUCODE_S_INPROGRESS, "in progress", B_TRUE, B_FALSE }, { SES2_DLUCODE_S_SAVING, "saved", B_TRUE, B_FALSE }, { SES2_DLUCODE_S_COMPLETE_NOW, "completed (available)", B_FALSE, B_FALSE }, { SES2_DLUCODE_S_COMPLETE_AT_RESET, "completed (need reset or power on)", B_FALSE, B_FALSE }, { SES2_DLUCODE_S_COMPLETE_AT_POWERON, "completed (need power on)", B_FALSE, B_FALSE }, { SES2_DLUCODE_S_PAGE_ERR, "page error (offset %d)", B_FALSE, B_TRUE }, { SES2_DLUCODE_S_IMAGE_ERR, "invalid image", B_FALSE, B_TRUE }, { SES2_DLUCODE_S_TIMEOUT, "download timeout", B_FALSE, B_TRUE }, { SES2_DLUCODE_S_INTERNAL_NEEDIMAGE, "internal error (NEED NEW IMAGE BEFORE RESET)", B_FALSE, B_TRUE }, { SES2_DLUCODE_S_INTERNAL_SAFE, "internal error (reset to revert to backup)", B_FALSE, B_TRUE }, }; #define NUCODE_STATUS \ (sizeof (ucode_statdesc_table) / sizeof (ucode_statdesc_table[0])) typedef struct ucode_status { uint64_t us_status; boolean_t us_iserr; boolean_t us_pending; char us_desc[128]; } ucode_status_t; ================ cheers, James C. McPherson -- Senior Kernel Software Engineer, Solaris Sun Microsystems http://blogs.sun.com/jmcp http://www.jmcp.homeunix.com/blog From Nicolas.Williams@sun.com Mon Mar 17 14:32:53 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2HLWqEo028969 for ; Mon, 17 Mar 2008 14:32:53 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2HLWciO017016; Mon, 17 Mar 2008 21:32:50 GMT 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 <0JXW0030796OW600@brm-avmta-1.central.sun.com>; Mon, 17 Mar 2008 15:32:48 -0600 (MDT) Received: from binky.Central.Sun.COM ([129.153.128.104]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXW0000D96N62E0@brm-avmta-1.central.sun.com>; Mon, 17 Mar 2008 15:32:47 -0600 (MDT) Received: from binky.Central.Sun.COM (localhost [127.0.0.1]) by binky.Central.Sun.COM (8.14.1+Sun/8.14.1) with ESMTP id m2HLWkGR017669; Mon, 17 Mar 2008 16:32:46 -0500 (CDT) Received: (from nw141292@localhost) by binky.Central.Sun.COM (8.14.1+Sun/8.14.1/Submit) id m2HLWkZE017668; Mon, 17 Mar 2008 16:32:46 -0500 (CDT) Date: Mon, 17 Mar 2008 16:32:46 -0500 From: Nicolas Williams Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <20080313231946.GA559252@sun.com> To: Mike Shapiro Cc: Joerg Schilling , PSARC-ext@sun.com, Keith.Wesolowski@sun.com, Eric.Schrock@sun.com Mail-followup-to: Mike Shapiro , Joerg Schilling , PSARC-ext@sun.com, Keith.Wesolowski@sun.com, Eric.Schrock@sun.com Message-id: <20080317213246.GK16998@Sun.COM> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> X-Authentication-warning: binky.Central.Sun.COM: nw141292 set sender to Nicolas.Williams@sun.com using -f User-Agent: Mutt/1.5.7i Status: RO Content-Length: 2349 On Thu, Mar 13, 2008 at 04:19:46PM -0700, Mike Shapiro wrote: > On Fri, Mar 14, 2008 at 12:07:17AM +0100, Joerg Schilling wrote: > > If you don't know, such a library already exists since August 1986, so why > > should there be another one. > > Solaris is allowed to have whatever namespace of whatever pieces of software > we all choose. The ARC's job is to own that namespace and approve changes. > There is no common library with this name in Solaris. This case adds one. Well... While working on the SQLite3 integration into SFW Mike Sullivan requested that a heads up be sent to the w-team just in case there are library name conflicts elsewhere. Mike (Sullivan) went so far as to assert that we should do this when we add any libraries where other software might pick it up. It's not enough to install the WOS and see that there's not conflict because auto-configured items in, say, SFW, might incorrectly think that your new library is something they should use. I'm not sure how likely that is though. For example, there are two things in SFW (Apache2 modules) that can use SQLite3, but won't use it unless you add --with-sqlite3=... to the ./configure command line. But it's always possible that conflicts of this sort will arise. If we had tighter control over the Solaris library namespace then this might not be an issue, but such control would imply more process for folks integrating new libraries. There's a price to pay either. Finally, if there is a FOSS libscsi that predates ours and their ABIs are different (which, unless we're doing a re-write, they will be) then it would probably be better to avoid the conflict. The problem with this is that having to search freshmeat.net, sourceforge, etc..., gauge popularity/deployment of any conflicts found, and so on means that the Solaris library namespace has exploded and there is no more control. Which brings me to the frightening possibility that anyone integrating a new library into /usr/lib in Solaris would have to build and test *all* the Solaris consolidations. Yes, Mike (Sullivan) almost went as far as requiring that I do just that, but settled on requiring that I build SFWNV and ONNV and send a heads up to the w-team and the JDS team. I would rather we avoid such a namespace explosion, but I'm not sure we can, in the long-term anyways. Nico -- From eschrock@zion.sfbay.sun.com Mon Mar 17 14:43:09 2008 Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2HLh8q4029095 for ; Mon, 17 Mar 2008 14:43:09 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id m2HLgQJG029178; Tue, 18 Mar 2008 05:43:06 +0800 (SGT) 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 <0JXW0040X9NQN300@brm-avmta-1.central.sun.com>; Mon, 17 Mar 2008 15:43:02 -0600 (MDT) Received: from zion.sfbay.sun.com ([129.146.17.75]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXW004289NOMB00@brm-avmta-1.central.sun.com>; Mon, 17 Mar 2008 15:43:00 -0600 (MDT) Received: from zion.sfbay.sun.com (localhost [127.0.0.1]) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id m2HLZTbA604303; Mon, 17 Mar 2008 21:35:30 +0000 (GMT) Received: (from eschrock@localhost) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit) id m2HLZTrF604302; Mon, 17 Mar 2008 14:35:29 -0700 (PDT) Date: Mon, 17 Mar 2008 14:35:29 -0700 From: Eric Schrock Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <20080317213246.GK16998@Sun.COM> To: Mike Shapiro , Joerg Schilling , PSARC-ext@sun.com, Keith.Wesolowski@sun.com Message-id: <20080317213528.GH572045@eng.sun.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <20080317213246.GK16998@Sun.COM> User-Agent: Mutt/1.4.2.1i Status: RO Content-Length: 2174 On Mon, Mar 17, 2008 at 04:32:46PM -0500, Nicolas Williams wrote: > > Well... > > While working on the SQLite3 integration into SFW Mike Sullivan > requested that a heads up be sent to the w-team just in case there are > library name conflicts elsewhere. Mike (Sullivan) went so far as to > assert that we should do this when we add any libraries where other > software might pick it up. It's not enough to install the WOS and see > that there's not conflict because auto-configured items in, say, SFW, > might incorrectly think that your new library is something they should > use. > > I'm not sure how likely that is though. For example, there are two > things in SFW (Apache2 modules) that can use SQLite3, but won't use it > unless you add --with-sqlite3=... to the ./configure command line. > > But it's always possible that conflicts of this sort will arise. > > If we had tighter control over the Solaris library namespace then this > might not be an issue, but such control would imply more process for > folks integrating new libraries. There's a price to pay either. > > Finally, if there is a FOSS libscsi that predates ours and their ABIs > are different (which, unless we're doing a re-write, they will be) then > it would probably be better to avoid the conflict. The problem with > this is that having to search freshmeat.net, sourceforge, etc..., gauge > popularity/deployment of any conflicts found, and so on means that the > Solaris library namespace has exploded and there is no more control. > > Which brings me to the frightening possibility that anyone integrating a > new library into /usr/lib in Solaris would have to build and test *all* > the Solaris consolidations. Yes, Mike (Sullivan) almost went as far as > requiring that I do just that, but settled on requiring that I build > SFWNV and ONNV and send a heads up to the w-team and the JDS team. > > I would rather we avoid such a namespace explosion, but I'm not sure we > can, in the long-term anyways. > This case does not introduce any library into /usr/lib, only into /usr/lib/scsi. - Eric -- Eric Schrock, Fishworks http://blogs.sun.com/eschrock From mws@zion.sfbay.sun.com Mon Mar 17 14:44:14 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2HLiDim029188 for ; Mon, 17 Mar 2008 14:44:14 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2HLhxkN021644; Mon, 17 Mar 2008 21:44:11 GMT 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 <0JXW00F0L9PM8D00@nwk-avmta-1.sfbay.Sun.COM>; Mon, 17 Mar 2008 14:44:10 -0700 (PDT) Received: from zion.sfbay.sun.com ([129.146.17.75]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXW00DXZ9PM9820@nwk-avmta-1.sfbay.Sun.COM>; Mon, 17 Mar 2008 14:44:10 -0700 (PDT) Received: from zion.sfbay.sun.com (localhost [127.0.0.1]) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id m2HLae27604332; Mon, 17 Mar 2008 21:36:40 +0000 (GMT) Received: (from mws@localhost) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit) id m2HLadR9604331; Mon, 17 Mar 2008 14:36:39 -0700 (PDT) Date: Mon, 17 Mar 2008 14:36:39 -0700 From: Mike Shapiro Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <20080317213246.GK16998@Sun.COM> To: Joerg Schilling , PSARC-ext@sun.com, Keith.Wesolowski@sun.com, Eric.Schrock@sun.com Message-id: <20080317213639.GA604284@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <20080317213246.GK16998@Sun.COM> User-Agent: Mutt/1.4.2.1i Status: RO Content-Length: 1024 On Mon, Mar 17, 2008 at 04:32:46PM -0500, Nicolas Williams wrote: > On Thu, Mar 13, 2008 at 04:19:46PM -0700, Mike Shapiro wrote: > > On Fri, Mar 14, 2008 at 12:07:17AM +0100, Joerg Schilling wrote: > > > If you don't know, such a library already exists since August 1986, so why > > > should there be another one. > > > > Solaris is allowed to have whatever namespace of whatever pieces of software > > we all choose. The ARC's job is to own that namespace and approve changes. > > There is no common library with this name in Solaris. This case adds one. > > Well... > > While working on the SQLite3 integration into SFW Mike Sullivan > requested that a heads up be sent to the w-team just in case there are > library name conflicts elsewhere. > ... There are no known conflicts that I am aware of. Even if there were, since this library is being delivered into usr/lib/scsi and not usr/lib, there is no usr/lib issue to be concerned about. -Mike -- Mike Shapiro, Sun Microsystems Fishworks. blogs.sun.com/mws/ From eschrock@zion.sfbay.sun.com Tue Mar 18 09:16:17 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2IGGGWJ005717 for ; Tue, 18 Mar 2008 09:16:16 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2IGGAva003242; Tue, 18 Mar 2008 16:16:12 GMT 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 <0JXX00L0VP6YLC00@brm-avmta-1.central.sun.com>; Tue, 18 Mar 2008 10:16:10 -0600 (MDT) Received: from zion.sfbay.sun.com ([129.146.17.75]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JXX00H24P6OY370@brm-avmta-1.central.sun.com>; Tue, 18 Mar 2008 10:16:00 -0600 (MDT) Received: from zion.sfbay.sun.com (localhost [127.0.0.1]) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id m2IGFxRF619084; Tue, 18 Mar 2008 16:15:59 +0000 (GMT) Received: (from eschrock@localhost) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit) id m2IGFxxM619083; Tue, 18 Mar 2008 09:15:59 -0700 (PDT) Date: Tue, 18 Mar 2008 09:15:58 -0700 From: Eric Schrock Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47DEDD99.9050002@Sun.COM> To: "James C. McPherson" Cc: Mike Shapiro , Keith.Wesolowski@sun.com, psarc-ext@sun.com Message-id: <20080318161558.GF618489@eng.sun.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47DDB4E0.6050602@Sun.COM> <20080317163010.GC572045@eng.sun.com> <47DEDD99.9050002@Sun.COM> User-Agent: Mutt/1.4.2.1i Status: RO Content-Length: 2820 James - There are two problems with this: - The microcode status is exposed as part of a plugin, not as core libses functionality. So there is no way to expose a function on top of that. Any additional information should be presented in the nvlist, not as part of a separate callback. - Such a table makes a lot of assumptions about the consumers, the main one being non-localized ASCII text as the canonical format of describing the result. The correct way to do this would be to create new properties such as LIBSES_UCODE_ERR_CONDITION that could be filled in by the plugin. This would also allow for vendor-specific modules to fill in information about any vendor specific codes they may return. In any case, such a change is entirely within the scope of a future RFE, and doesn't affect the architecture of libses as it relates to this case. - Eric On Tue, Mar 18, 2008 at 07:07:37AM +1000, James C. McPherson wrote: > I was thinking that having something like the following as > common code would be preferable to seeing consumers of libses > rolling their own each time they needed some status mappings: > > > ================ > > typedef struct ucode_statdesc { > uint64_t us_value; > const char *us_desc; > boolean_t us_pending; > boolean_t us_iserr; > } ucode_statdesc_t; > > static ucode_statdesc_t ucode_statdesc_table[] = { > { SES2_DLUCODE_S_NOP, "none", B_FALSE, B_FALSE }, > { SES2_DLUCODE_S_INPROGRESS, "in progress", B_TRUE, B_FALSE }, > { SES2_DLUCODE_S_SAVING, "saved", B_TRUE, B_FALSE }, > { SES2_DLUCODE_S_COMPLETE_NOW, "completed (available)", B_FALSE, > B_FALSE }, > { SES2_DLUCODE_S_COMPLETE_AT_RESET, > "completed (need reset or power on)", B_FALSE, B_FALSE }, > { SES2_DLUCODE_S_COMPLETE_AT_POWERON, "completed (need power on)", > B_FALSE, B_FALSE }, > { SES2_DLUCODE_S_PAGE_ERR, "page error (offset %d)", > B_FALSE, B_TRUE }, > { SES2_DLUCODE_S_IMAGE_ERR, "invalid image", > B_FALSE, B_TRUE }, > { SES2_DLUCODE_S_TIMEOUT, "download timeout", > B_FALSE, B_TRUE }, > { SES2_DLUCODE_S_INTERNAL_NEEDIMAGE, > "internal error (NEED NEW IMAGE BEFORE RESET)", > B_FALSE, B_TRUE }, > { SES2_DLUCODE_S_INTERNAL_SAFE, > "internal error (reset to revert to backup)", > B_FALSE, B_TRUE }, > }; > > #define NUCODE_STATUS \ > (sizeof (ucode_statdesc_table) / sizeof (ucode_statdesc_table[0])) > > typedef struct ucode_status { > uint64_t us_status; > boolean_t us_iserr; > boolean_t us_pending; > char us_desc[128]; > } ucode_status_t; > > ================ > > > > cheers, > James C. McPherson > -- > Senior Kernel Software Engineer, Solaris > Sun Microsystems > http://blogs.sun.com/jmcp http://www.jmcp.homeunix.com/blog -- Eric Schrock, Fishworks http://blogs.sun.com/eschrock From Joerg.Schilling@fokus.fraunhofer.de Wed Mar 26 10:51:31 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2QHpTG0005694 for ; Wed, 26 Mar 2008 10:51:31 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2QHpKke006740; Wed, 26 Mar 2008 17:51:25 GMT 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 <0JYC00807MXNM800@brm-avmta-1.central.sun.com>; Wed, 26 Mar 2008 11:51:23 -0600 (MDT) Received: from brmea-mail-1.sun.com ([192.18.98.31]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JYC000WAMXK0BA0@brm-avmta-1.central.sun.com>; Wed, 26 Mar 2008 11:51:21 -0600 (MDT) Received: from relay43i.sun.com ([192.5.209.74]) by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m2QHikMv014525; Wed, 26 Mar 2008 17:51:20 +0000 (GMT) Received: from mms48es.sun.com ([160.41.221.231] [160.41.221.231]) by relay43i.sun.com with ESMTP id BT-MMP-2461742; Wed, 26 Mar 2008 17:51:15 +0000 (Z) Received: from relay41i.sun.com (relay41i.sun.com [192.5.209.70]) by mms48es.sun.com with ESMTP id BT-MMP-2712952; Wed, 26 Mar 2008 17:51:14 +0000 (Z) Received: from mailgw2-out.fraunhofer.de ([153.96.1.28] [153.96.1.28]) by relay4i.sun.com with ESMTP id BT-MMP-24529688; Wed, 26 Mar 2008 17:51:14 +0000 (Z) Received: from mailgw25.noc.fraunhofer.de (localhost [127.0.0.1]) by mailgw2-out.fraunhofer.de[host mailgw25] (8.14.2+/8.14.2) with ESMTP id m2QHnWaO015023; Wed, 26 Mar 2008 18:49:32 +0100 (CET) Received: from pluto.fokus.fraunhofer.de (pluto.fokus.fraunhofer.de [195.37.77.164]) by mailgw25.noc.fraunhofer.de (8.14.2+/8.14.2) with ESMTP id m2QHnKMm014839 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 26 Mar 2008 18:49:32 +0100 (CET) Received: from EXCHSRV.fokus.fraunhofer.de (bohr [10.147.9.231]) by pluto.fokus.fraunhofer.de (8.13.7/8.13.7) with SMTP id m2QHjZj2022669; Wed, 26 Mar 2008 18:45:35 +0100 (MET) Received: from rigel ([10.147.65.195]) by EXCHSRV.fokus.fraunhofer.de with Microsoft SMTPSVC(6.0.3790.3959); Wed, 26 Mar 2008 18:45:35 +0100 Date: Wed, 26 Mar 2008 18:45:35 +0100 From: Joerg.Schilling@fokus.fraunhofer.de (Joerg Schilling) Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47D9BCD8.4030708@Sun.COM> To: James.McPherson@sun.com Cc: PSARC-ext@sun.com, mws@sun.com, Keith.Wesolowski@sun.com, Eric.Schrock@sun.com Message-id: <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1 Content-transfer-encoding: 8BIT X-PMX-Version: 5.4.1.325704 X-Brightmail-Tracker: AAAAAA== X-Fraunhofer-Email-Policy: accepted X-Antispam: No, score=-0.2/5.0, scanned in 0.129sec at (localhost [127.0.0.1]) by smf-spamd v1.3.1 - http://smfs.sf.net/ References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> X-Authentication-warning: mailgw25.noc.fraunhofer.de: Host localhost [127.0.0.1] claimed to be mailgw25.noc.fraunhofer.de User-Agent: nail 11.22 3/20/05 X-OriginalArrivalTime: 26 Mar 2008 17:45:35.0327 (UTC) FILETIME=[32002EF0:01C88F69] Status: RO Content-Length: 856 "James C. McPherson" wrote: > I expect - since this is an Open fasttrack - that the materials > should show up on opensolaris.org fairly soon. > > Perhaps you might want to check the directory > > http://opensolaris.org/os/community/arc/caselog/2008/196 > > in a few hours (give the synchronisation time to occur). > Well, the material does not include manual pages. Please explain how "libscsi" is intended to work. Is "libscsi" intended to be a project private lib that is undocumented and not available as shared library? Jörg -- EMail:joerg@schily.isdn.cs.tu-berlin.de (home) Jörg Schilling D-13353 Berlin js@cs.tu-berlin.de (uni) schilling@fokus.fraunhofer.de (work) Blog: http://schily.blogspot.com/ URL: http://cdrecord.berlios.de/old/private/ ftp://ftp.berlios.de/pub/schily From Keith.Wesolowski@sun.com Wed Mar 26 10:58:52 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2QHwpcw006681 for ; Wed, 26 Mar 2008 10:58:51 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2QHweiY010213; Wed, 26 Mar 2008 17:58:47 GMT 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 <0JYC0091VN9V1900@brm-avmta-1.central.sun.com>; Wed, 26 Mar 2008 11:58:43 -0600 (MDT) Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.63]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JYC000D3N9U0BB0@brm-avmta-1.central.sun.com>; Wed, 26 Mar 2008 11:58:43 -0600 (MDT) Received: from jurassic-x4600.sfbay.sun.com (localhost [127.0.0.1]) by jurassic-x4600.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id m2QHwg1q438583 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 26 Mar 2008 10:58:42 -0700 (PDT) Received: (from wesolows@localhost) by jurassic-x4600.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit) id m2QHwgNw438582; Wed, 26 Mar 2008 10:58:42 -0700 (PDT) Date: Wed, 26 Mar 2008 10:58:42 -0700 From: Keith M Wesolowski Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> To: Joerg Schilling Cc: James.McPherson@sun.com, PSARC-ext@sun.com, mws@sun.com, Eric.Schrock@sun.com Message-id: <20080326175840.GA420188@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> User-Agent: Mutt/1.4.2.1i Status: RO Content-Length: 179 On Wed, Mar 26, 2008 at 06:45:35PM +0100, Joerg Schilling wrote: > Is "libscsi" intended to be a project private lib that is undocumented and > not available as shared library? From the spec at http://www.opensolaris.org/os/community/arc/caselog/2008/196/incept-materials/spec-txt/: Status: RO Content-Length: 337 # Summary of Exported Interfaces, all Contracted Consolidation Private ... I'm not sure what could be clearer than that. All libraries are delivered as shared objects, whether the interfaces they export are Public or Private. -- Keith M Wesolowski "Sir, we're surrounded!" Fishworks "Excellent; we can attack in any direction!" From Darren.Moffat@sun.com Wed Mar 26 11:07:24 2008 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2QI7OGn007104 for ; Wed, 26 Mar 2008 11:07:24 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m2QI72eC003996 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 26 Mar 2008 11:07:24 -0700 (PDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JYC00843NOBCX00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed, 26 Mar 2008 11:07:23 -0700 (PDT) Received: from gmp-eb-inf-1.sun.com ([192.18.6.21]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JYC00576NO5V7B0@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed, 26 Mar 2008 11:07:20 -0700 (PDT) Received: from fe-emea-10.sun.com (gmp-eb-lb-2-fe1.eu.sun.com [192.18.6.10]) by gmp-eb-inf-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m2QI7HI2001561 for ; Wed, 26 Mar 2008 18:07:17 +0000 (GMT) Received: from conversion-daemon.fe-emea-10.sun.com by fe-emea-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0JYC00D01NKC2M00@fe-emea-10.sun.com> (original mail from Darren.Moffat@Sun.COM) for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed, 26 Mar 2008 18:07:17 +0000 (GMT) Received: from [129.156.173.199] by fe-emea-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0JYC00B50NO3R620@fe-emea-10.sun.com>; Wed, 26 Mar 2008 18:07:16 +0000 (GMT) Date: Wed, 26 Mar 2008 18:07:15 +0000 From: Darren J Moffat Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> Sender: Darren.Moffat@sun.com To: Joerg Schilling Cc: James.McPherson@sun.com, PSARC-ext@sun.com, mws@sun.com, Keith.Wesolowski@sun.com, Eric.Schrock@sun.com Message-id: <47EA90D3.7000701@Sun.COM> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> User-Agent: Thunderbird 2.0.0.9 (X11/20080225) Status: RO Content-Length: 935 Joerg Schilling wrote: > "James C. McPherson" wrote: > >> I expect - since this is an Open fasttrack - that the materials >> should show up on opensolaris.org fairly soon. >> >> Perhaps you might want to check the directory >> >> http://opensolaris.org/os/community/arc/caselog/2008/196 >> >> in a few hours (give the synchronisation time to occur). >> > > Well, the material does not include manual pages. > > Please explain how "libscsi" is intended to work. > > Is "libscsi" intended to be a project private lib that is undocumented and > not available as shared library? What isn't clear in the spec where it says: Summary of Exported Interfaces, all Contracted Consolidation Private: ... SCSI libraries and private commands /usr/lib/scsi/libscsi.so.1 /usr/lib/scsi/{amd64,sparcv9}/libscsi.so.1 Note the file location and the explicit mention twice that this is private. -- Darren J Moffat From Joerg.Schilling@fokus.fraunhofer.de Wed Mar 26 15:30:16 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2QMUETc016147 for ; Wed, 26 Mar 2008 15:30:16 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2QMU5LF011809; Wed, 26 Mar 2008 22:30:10 GMT 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 <0JYC00G0BZU80L00@nwk-avmta-1.sfbay.Sun.COM>; Wed, 26 Mar 2008 15:30:08 -0700 (PDT) Received: from brmea-mail-3.sun.com ([192.18.98.34]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JYC00L8WZU6A9B0@nwk-avmta-1.sfbay.Sun.COM>; Wed, 26 Mar 2008 15:30:06 -0700 (PDT) Received: from relay24.sun.com (ip192-12-251-74.block6.us.syntegra.com [192.12.251.74]) by brmea-mail-3.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m2QMM5ca029550; Wed, 26 Mar 2008 22:30:05 +0000 (GMT) Received: from mms23es.sun.com ([150.143.232.54] [150.143.232.54]) by relay24i.sun.com with ESMTP id BT-MMP-1227425; Wed, 26 Mar 2008 22:30:05 +0000 (Z) Received: from relay23.sun.com (relay23.sun.com [192.12.251.54]) by mms23es.sun.com with ESMTP id BT-MMP-2788113; Wed, 26 Mar 2008 22:30:04 +0000 (Z) Received: from mailgw1.fraunhofer.de ([153.96.1.17] [153.96.1.17]) by relay23i.sun.com with ESMTP id BT-MMP-9033; Wed, 26 Mar 2008 22:30:03 +0000 (Z) Received: from mailgw1.fraunhofer.de (localhost [127.0.0.1]) by mailgw1.fraunhofer.de[host mailgw12] (8.13.5+/8.13.4) with ESMTP id m2QMTNC5028507; Wed, 26 Mar 2008 23:29:24 +0100 (CET) Received: from pluto.fokus.fraunhofer.de (pluto.fokus.fraunhofer.de [195.37.77.164]) by mailgw1.fraunhofer.de (8.13.5+/8.13.4) with ESMTP id m2QMSsic027977 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 26 Mar 2008 23:29:20 +0100 (CET) Received: from EXCHSRV.fokus.fraunhofer.de (bohr [10.147.9.231]) by pluto.fokus.fraunhofer.de (8.13.7/8.13.7) with SMTP id m2QMSsmf002877; Wed, 26 Mar 2008 23:28:54 +0100 (MET) Received: from rigel ([10.147.65.195]) by EXCHSRV.fokus.fraunhofer.de with Microsoft SMTPSVC(6.0.3790.3959); Wed, 26 Mar 2008 23:28:54 +0100 Date: Wed, 26 Mar 2008 23:28:54 +0100 From: Joerg.Schilling@fokus.fraunhofer.de (Joerg Schilling) Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47EA90D3.7000701@Sun.COM> To: Darren.Moffat@sun.com Cc: PSARC-ext@sun.com, mws@sun.com, Keith.Wesolowski@sun.com, James.McPherson@sun.com, Eric.Schrock@sun.com Message-id: <47eace26.BOWAUf9WyweLreUc%Joerg.Schilling@fokus.fraunhofer.de> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1 Content-transfer-encoding: 8BIT X-PMX-Version: 5.4.1.325704 X-Brightmail-Tracker: AAAAAA== X-Fraunhofer-Email-Policy: accepted X-Antispam: No, score=-1.1/5.0, scanned in 0.276sec at (localhost [127.0.0.1]) by smf-spamd v1.3.1 - http://smfs.sf.net/ References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> <47EA90D3.7000701@Sun.COM> User-Agent: nail 11.22 3/20/05 X-OriginalArrivalTime: 26 Mar 2008 22:28:54.0738 (UTC) FILETIME=[C6707320:01C88F90] Status: RO Content-Length: 846 Darren J Moffat wrote: > Joerg Schilling wrote: > > Is "libscsi" intended to be a project private lib that is undocumented and > > not available as shared library? > Summary of Exported Interfaces, all Contracted Consolidation Private: > > ... > SCSI libraries and private commands > > /usr/lib/scsi/libscsi.so.1 > /usr/lib/scsi/{amd64,sparcv9}/libscsi.so.1 > > > Note the file location and the explicit mention twice that this is private. Then avoid name space pollution and do not use a generic name for this lib. Jörg -- EMail:joerg@schily.isdn.cs.tu-berlin.de (home) Jörg Schilling D-13353 Berlin js@cs.tu-berlin.de (uni) schilling@fokus.fraunhofer.de (work) Blog: http://schily.blogspot.com/ URL: http://cdrecord.berlios.de/old/private/ ftp://ftp.berlios.de/pub/schily From James.McPherson@sun.com Wed Mar 26 15:37:24 2008 Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2QMbNXP016646 for ; Wed, 26 Mar 2008 15:37:24 -0700 (PDT) Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11]) by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id m2QMbIDP029830 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 27 Mar 2008 06:37:22 +0800 (SGT) 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 <0JYD0050B068KW00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed, 26 Mar 2008 16:37:20 -0600 (MDT) Received: from sineb-mail-1.sun.com ([192.18.19.6]) by brm-avmta-1.central.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JYD00E3E06593C0@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed, 26 Mar 2008 16:37:20 -0600 (MDT) Received: from fe-apac-05.sun.com (fe-apac-05.sun.com [192.18.19.176] (may be forged)) by sineb-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m2QMbQTM019801 for ; Wed, 26 Mar 2008 22:37:26 +0000 (GMT) Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0JYD00D0105XT600@mail-apac.sun.com> (original mail from James.McPherson@Sun.COM) for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 27 Mar 2008 06:37:13 +0800 (SGT) Received: from [192.168.1.35] ([220.157.71.44]) by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0JYD006JR05ZKKUZ@mail-apac.sun.com>; Thu, 27 Mar 2008 06:37:13 +0800 (SGT) Date: Thu, 27 Mar 2008 08:36:50 +1000 From: "James C. McPherson" Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47eace26.BOWAUf9WyweLreUc%Joerg.Schilling@fokus.fraunhofer.de> Sender: James.McPherson@sun.com To: mws@sun.com, Eric.Schrock@sun.com Cc: Joerg Schilling , Darren.Moffat@sun.com, PSARC-ext@sun.com, Keith.Wesolowski@sun.com Reply-to: James.McPherson@sun.com Message-id: <47EAD002.1040501@Sun.COM> Organization: Sun Microsystems MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=UTF-8 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> <47EA90D3.7000701@Sun.COM> <47eace26.BOWAUf9WyweLreUc%Joerg.Schilling@fokus.fraunhofer.de> User-Agent: Thunderbird 2.0.0.9 (X11/20080128) Status: RO Content-Length: 796 Joerg Schilling wrote: > Darren J Moffat wrote: > >> Joerg Schilling wrote: >>> Is "libscsi" intended to be a project private lib that is undocumented and >>> not available as shared library? > >> Summary of Exported Interfaces, all Contracted Consolidation Private: >> >> ... >> SCSI libraries and private commands >> >> /usr/lib/scsi/libscsi.so.1 >> /usr/lib/scsi/{amd64,sparcv9}/libscsi.so.1 >> >> >> Note the file location and the explicit mention twice that this is private. > > Then avoid name space pollution and do not use a generic name for this lib. Has this fasttrack timed out and got an automatic approval yet? James C. McPherson -- Senior Kernel Software Engineer, Solaris Sun Microsystems http://blogs.sun.com/jmcp http://www.jmcp.homeunix.com/blog From Alan.Coopersmith@sun.com Wed Mar 26 15:43:14 2008 Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2QMhD1P017370 for ; Wed, 26 Mar 2008 15:43:14 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id m2QMgpnj002307 for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Thu, 27 Mar 2008 06:43:12 +0800 (SGT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JYD00I0B0FX8V00@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Wed, 26 Mar 2008 15:43:09 -0700 (PDT) Received: from sca-es-mail-2.sun.com ([192.18.43.133]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JYD00HDJ0FW2O10@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Wed, 26 Mar 2008 15:43:08 -0700 (PDT) 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 m2QMh8m2025032 for ; Wed, 26 Mar 2008 15:43:08 -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 <0JYD00B010B4C400@fe-sfbay-09.sun.com> (original mail from Alan.Coopersmith@Sun.COM) for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Wed, 26 Mar 2008 15:43:08 -0700 (PDT) Received: from almas.sfbay.sun.com ([129.146.106.93]) by fe-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0JYD00I0M0FVXU70@fe-sfbay-09.sun.com>; Wed, 26 Mar 2008 15:43:08 -0700 (PDT) Date: Wed, 26 Mar 2008 15:43:07 -0700 From: Alan Coopersmith Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47EAD002.1040501@Sun.COM> Sender: Alan.Coopersmith@sun.com To: James.McPherson@sun.com Cc: mws@sun.com, Eric.Schrock@sun.com, Darren.Moffat@sun.com, psarc-ext@sun.com, Keith.Wesolowski@sun.com Message-id: <47EAD17B.4030700@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=UTF-8 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 X-Enigmail-Version: 0.95.1 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> <47EA90D3.7000701@Sun.COM> <47eace26.BOWAUf9WyweLreUc%Joerg.Schilling@fokus.fraunhofer.de> <47EAD002.1040501@Sun.COM> User-Agent: Thunderbird 2.0.0.6 (X11/20071203) Status: RO Content-Length: 319 James C. McPherson wrote: > Has this fasttrack timed out and got an automatic approval yet? It was approved during ARC business at today's PSARC meeting. The case owner needs to update the case status. -- -Alan Coopersmith- alan.coopersmith@sun.com Sun Microsystems, Inc. - X Window System Engineering From John.Plocher@Sun.COM Wed Mar 26 15:50:42 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2QMofIf017874 for ; Wed, 26 Mar 2008 15:50:42 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2QMoeSK021274 for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Wed, 26 Mar 2008 22:50:41 GMT Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JYD00I050SGJR00@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Wed, 26 Mar 2008 15:50:40 -0700 (PDT) Received: from sca-es-mail-2.sun.com ([192.18.43.133]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JYD00HUQ0SF2I10@nwk-avmta-2.sfbay.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Wed, 26 Mar 2008 15:50:39 -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 m2QModtr025792 for ; Wed, 26 Mar 2008 15:50:39 -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 <0JYD00E010LKXC00@fe-sfbay-10.sun.com> (original mail from John.Plocher@Sun.COM) for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Wed, 26 Mar 2008 15:50:39 -0700 (PDT) Received: from wp668.local ([208.74.177.212]) by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0JYD0093R0SCJED0@fe-sfbay-10.sun.com>; Wed, 26 Mar 2008 15:50:37 -0700 (PDT) Date: Wed, 26 Mar 2008 15:50:36 -0700 From: John Plocher Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47EAD002.1040501@Sun.COM> Sender: John.Plocher@Sun.COM To: James.McPherson@Sun.COM Cc: mws@Sun.COM, Eric.Schrock@Sun.COM, psarc-ext@Sun.COM, Keith.Wesolowski@Sun.COM Message-id: <47EAD33C.2090700@Sun.Com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> <47EA90D3.7000701@Sun.COM> <47eace26.BOWAUf9WyweLreUc%Joerg.Schilling@fokus.fraunhofer.de> <47EAD002.1040501@Sun.COM> User-Agent: Thunderbird 2.0.0.12 (Macintosh/20080213) Status: RO Content-Length: 146 James C. McPherson wrote: > Has this fasttrack timed out and got an automatic approval yet? Yes, at 10:10am PDT in PSARC this morning. -John From mws@zion.sfbay.sun.com Wed Mar 26 15:51:09 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2QMp8tQ017907 for ; Wed, 26 Mar 2008 15:51:08 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m2QMohv7021285; Wed, 26 Mar 2008 22:51:02 GMT 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 <0JYD00I050T29Y00@nwk-avmta-1.sfbay.Sun.COM>; Wed, 26 Mar 2008 15:51:02 -0700 (PDT) Received: from zion.sfbay.sun.com ([129.146.17.75]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JYD00LVX0T0AFB0@nwk-avmta-1.sfbay.Sun.COM>; Wed, 26 Mar 2008 15:51:01 -0700 (PDT) Received: from zion.sfbay.sun.com (localhost [127.0.0.1]) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2) with ESMTP id m2QMp0Xx758034; Wed, 26 Mar 2008 22:51:00 +0000 (GMT) Received: (from mws@localhost) by zion.sfbay.sun.com (8.14.2+Sun/8.14.2/Submit) id m2QMoxwO758033; Wed, 26 Mar 2008 15:50:59 -0700 (PDT) Date: Wed, 26 Mar 2008 15:50:59 -0700 From: Mike Shapiro Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47EAD17B.4030700@sun.com> To: Alan Coopersmith Cc: James.McPherson@sun.com, Eric.Schrock@sun.com, Darren.Moffat@sun.com, psarc-ext@sun.com, Keith.Wesolowski@sun.com Message-id: <20080326225059.GC757491@sun.com> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii Content-transfer-encoding: 7BIT Content-disposition: inline X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> <47EA90D3.7000701@Sun.COM> <47eace26.BOWAUf9WyweLreUc%Joerg.Schilling@fokus.fraunhofer.de> <47EAD002.1040501@Sun.COM> <47EAD17B.4030700@sun.com> User-Agent: Mutt/1.4.2.1i Status: RO Content-Length: 359 On Wed, Mar 26, 2008 at 03:43:07PM -0700, Alan Coopersmith wrote: > James C. McPherson wrote: > > Has this fasttrack timed out and got an automatic approval yet? > > It was approved during ARC business at today's PSARC meeting. > The case owner needs to update the case status. Done. -Mike -- Mike Shapiro, Sun Microsystems Fishworks. blogs.sun.com/mws/ From Andrew.Gabriel@sun.com Wed Mar 26 16:27:09 2008 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 m2QNR9vg019739 for ; Wed, 26 Mar 2008 16:27:09 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m2QNR7uJ024705 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Wed, 26 Mar 2008 16:27:09 -0700 (PDT) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JYD00K1V2H86100@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed, 26 Mar 2008 16:27:08 -0700 (PDT) Received: from gmp-eb-inf-2.sun.com ([192.18.6.24]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JYD00HPW2H72T20@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed, 26 Mar 2008 16:27:07 -0700 (PDT) Received: from fe-emea-09.sun.com (gmp-eb-lb-2-fe2.eu.sun.com [192.18.6.11]) by gmp-eb-inf-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m2QNR61e010662 for ; Wed, 26 Mar 2008 23:27:06 +0000 (GMT) Received: from conversion-daemon.fe-emea-09.sun.com by fe-emea-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0JYD0010129E2S00@fe-emea-09.sun.com> (original mail from Andrew.Gabriel@Sun.COM) for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Wed, 26 Mar 2008 23:27:06 +0000 (GMT) Received: from [192.9.200.17] ([81.187.162.106]) by fe-emea-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0JYD001RA2GZ3900@fe-emea-09.sun.com>; Wed, 26 Mar 2008 23:27:06 +0000 (GMT) Date: Wed, 26 Mar 2008 23:28:24 +0000 From: Andrew Gabriel Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47eace26.BOWAUf9WyweLreUc%Joerg.Schilling@fokus.fraunhofer.de> Sender: Andrew.Gabriel@sun.com To: Joerg Schilling Cc: Darren.Moffat@sun.com, PSARC-EXT@sun.com, mws@sun.com, Keith.Wesolowski@sun.com, James.McPherson@sun.com, Eric.Schrock@sun.com Message-id: <47EADC18.8090901@sun.com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> <47EA90D3.7000701@Sun.COM> <47eace26.BOWAUf9WyweLreUc%Joerg.Schilling@fokus.fraunhofer.de> User-Agent: Thunderbird 2.0.0.6 (X11/20071105) Status: RO Content-Length: 682 Joerg Schilling wrote: > Darren J Moffat wrote: > >> Joerg Schilling wrote: >>> Is "libscsi" intended to be a project private lib that is undocumented and >>> not available as shared library? > >> Summary of Exported Interfaces, all Contracted Consolidation Private: >> >> ... >> SCSI libraries and private commands >> >> /usr/lib/scsi/libscsi.so.1 >> /usr/lib/scsi/{amd64,sparcv9}/libscsi.so.1 >> >> >> Note the file location and the explicit mention twice that this is private. > > Then avoid name space pollution and do not use a generic name for this lib. There is no clash. /usr/lib is for bundled Solaris software. See filesystem(5). -- Andrew From Joerg.Schilling@fokus.fraunhofer.de Thu Mar 27 02:40:14 2008 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2R9eENs008155 for ; Thu, 27 Mar 2008 02:40:14 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m2R9e3i7037473; Thu, 27 Mar 2008 03:40:10 -0600 (MDT) 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 <0JYD00K27UUWZL00@nwk-avmta-1.sfbay.Sun.COM>; Thu, 27 Mar 2008 02:40:09 -0700 (PDT) Received: from brmea-mail-4.sun.com ([192.18.98.36]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JYD00DBFUUV7QC0@nwk-avmta-1.sfbay.Sun.COM>; Thu, 27 Mar 2008 02:40:08 -0700 (PDT) Received: from relay11i.sun.com (ip121.net129179-4.block1.us.syntegra.com [129.179.4.121]) by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m2R9e6RM015543; Thu, 27 Mar 2008 09:40:07 +0000 (GMT) Received: from mmp11es.sun.com ([160.41.209.21] [160.41.209.21]) by relay11i.sun.com with ESMTP id BT-MMP-25620; Thu, 27 Mar 2008 09:40:06 +0000 (Z) Received: from relay14i.sun.com (relay14i.sun.com [129.179.4.124]) by mmp11es.sun.com with ESMTP id BT-MMP-2239359; Thu, 27 Mar 2008 09:40:05 +0000 (Z) Received: from mailgw2-out.fraunhofer.de ([153.96.1.28] [153.96.1.28]) by relay1i.sun.com with ESMTP id BT-MMP-297539; Thu, 27 Mar 2008 09:40:04 +0000 (Z) Received: from mailgw22.noc.fraunhofer.de (localhost [127.0.0.1]) by mailgw2-out.fraunhofer.de[host mailgw22] (8.14.2+/8.14.2) with ESMTP id m2R9dauQ009201; Thu, 27 Mar 2008 10:39:36 +0100 (CET) Received: from pluto.fokus.fraunhofer.de (pluto.fokus.fraunhofer.de [195.37.77.164]) by mailgw22.noc.fraunhofer.de (8.14.2+/8.14.2) with ESMTP id m2R9dSkI009083 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 27 Mar 2008 10:39:36 +0100 (CET) Received: from EXCHSRV.fokus.fraunhofer.de (bohr [10.147.9.231]) by pluto.fokus.fraunhofer.de (8.13.7/8.13.7) with SMTP id m2R9dSvU006415; Thu, 27 Mar 2008 10:39:28 +0100 (MET) Received: from rigel ([10.147.65.195]) by EXCHSRV.fokus.fraunhofer.de with Microsoft SMTPSVC(6.0.3790.3959); Thu, 27 Mar 2008 10:39:29 +0100 Date: Thu, 27 Mar 2008 10:39:28 +0100 From: Joerg.Schilling@fokus.fraunhofer.de (Joerg Schilling) Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47EADC18.8090901@sun.com> To: Andrew.Gabriel@sun.com Cc: PSARC-ext@sun.com, mws@sun.com, Keith.Wesolowski@sun.com, James.McPherson@sun.com, Eric.Schrock@sun.com, Darren.Moffat@sun.com Message-id: <47eb6b50.WI2lmc+FylPDsNb5%Joerg.Schilling@fokus.fraunhofer.de> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1 Content-transfer-encoding: 8BIT X-PMX-Version: 5.4.1.325704 X-Brightmail-Tracker: AAAAAA== X-Fraunhofer-Email-Policy: accepted X-Antispam: No, score=-2.6/5.0, scanned in 1.134sec at (localhost [127.0.0.1]) by smf-spamd v1.3.1 - http://smfs.sf.net/ References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> <47EA90D3.7000701@Sun.COM> <47eace26.BOWAUf9WyweLreUc%Joerg.Schilling@fokus.fraunhofer.de> <47EADC18.8090901@sun.com> X-Authentication-warning: mailgw22.noc.fraunhofer.de: Host localhost [127.0.0.1] claimed to be mailgw22.noc.fraunhofer.de User-Agent: nail 11.22 3/20/05 X-OriginalArrivalTime: 27 Mar 2008 09:39:29.0253 (UTC) FILETIME=[74143950:01C88FEE] Status: RO Content-Length: 1111 Andrew Gabriel wrote: > > Then avoid name space pollution and do not use a generic name for this lib. > > There is no clash. > /usr/lib is for bundled Solaris software. See filesystem(5). It is not the first time that I have objections because the ARC happily ignores possible future clashes without a "good reason". It is a bad idea to burn names just for fun. If the lib is a private lib, then avoid name space pollution. This is typically done by using statical linking. If you like to create a dynamic library anyhow, do not use a generic name for a private object. An important difference between Solaris and Linux in former times was that Solaris was planned in advance for a longer time. Do not give up this advantage...unless you like to lose your paying customers. Jörg -- EMail:joerg@schily.isdn.cs.tu-berlin.de (home) Jörg Schilling D-13353 Berlin js@cs.tu-berlin.de (uni) schilling@fokus.fraunhofer.de (work) Blog: http://schily.blogspot.com/ URL: http://cdrecord.berlios.de/old/private/ ftp://ftp.berlios.de/pub/schily From Darren.Moffat@sun.com Thu Mar 27 04:09:59 2008 Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m2RB9xEK010265 for ; Thu, 27 Mar 2008 04:09:59 -0700 (PDT) Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74]) by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id m2RB9wdI006915 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Thu, 27 Mar 2008 05:09:59 -0600 (MDT) 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 <0JYD00605Z0MKG00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 27 Mar 2008 04:09:58 -0700 (PDT) Received: from gmp-eb-inf-1.sun.com ([192.18.6.21]) by nwk-avmta-1.sfbay.Sun.COM (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JYD0000ZZ0LVL60@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 27 Mar 2008 04:09:58 -0700 (PDT) Received: from fe-emea-09.sun.com (gmp-eb-lb-2-fe1.eu.sun.com [192.18.6.10]) by gmp-eb-inf-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m2RB9vGF026225 for ; Thu, 27 Mar 2008 11:09:57 +0000 (GMT) Received: from conversion-daemon.fe-emea-09.sun.com by fe-emea-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0JYD00F01WIPHM00@fe-emea-09.sun.com> (original mail from Darren.Moffat@Sun.COM) for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu, 27 Mar 2008 11:09:57 +0000 (GMT) Received: from [129.156.173.199] by fe-emea-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0JYD00MCCZ0H1E00@fe-emea-09.sun.com>; Thu, 27 Mar 2008 11:09:54 +0000 (GMT) Date: Thu, 27 Mar 2008 11:09:53 +0000 From: Darren J Moffat Subject: Re: PSARC 2008/196 libscsi and libses In-reply-to: <47eace26.BOWAUf9WyweLreUc%Joerg.Schilling@fokus.fraunhofer.de> Sender: Darren.Moffat@sun.com To: Joerg Schilling Cc: PSARC-ext@sun.com, mws@sun.com, Keith.Wesolowski@sun.com, James.McPherson@sun.com, Eric.Schrock@sun.com Message-id: <47EB8081.8080807@Sun.COM> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 References: <20080313223414.GA558351@sun.com> <47d9b3a5.Uo7NLgfnr8NXA0sY%Joerg.Schilling@fokus.fraunhofer.de> <20080313231946.GA559252@sun.com> <47d9b8a2.SWlfdBLiZtU6SSC5%Joerg.Schilling@fokus.fraunhofer.de> <47D9BCD8.4030708@Sun.COM> <47ea8bbf.IlDCkdDAKH/K+ULf%Joerg.Schilling@fokus.fraunhofer.de> <47EA90D3.7000701@Sun.COM> <47eace26.BOWAUf9WyweLreUc%Joerg.Schilling@fokus.fraunhofer.de> User-Agent: Thunderbird 2.0.0.9 (X11/20080225) Status: RO Content-Length: 877 Joerg Schilling wrote: > Darren J Moffat wrote: > >> Joerg Schilling wrote: >>> Is "libscsi" intended to be a project private lib that is undocumented and >>> not available as shared library? > >> Summary of Exported Interfaces, all Contracted Consolidation Private: >> >> ... >> SCSI libraries and private commands >> >> /usr/lib/scsi/libscsi.so.1 >> /usr/lib/scsi/{amd64,sparcv9}/libscsi.so.1 >> >> >> Note the file location and the explicit mention twice that this is private. > > Then avoid name space pollution and do not use a generic name for this lib. That is exactly why it is in /usr/lib/scsi which is off the default linker search path at compile and run time. It is also why it has no .so symlink so it can't accidentally be linked with "-L/usr/lib/scsi -lscsi". Either way the case is approved as specified. -- Darren J Moffat