From sacadmin Mon Nov 24 22:08:17 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 mAP68HZ6022871; Mon, 24 Nov 2008 22:08:17 -0800 (PST) Received: (from eh146360@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id mAP68H3w022867; Mon, 24 Nov 2008 22:08:17 -0800 (PST) Date: Mon, 24 Nov 2008 22:08:17 -0800 (PST) From: En-Hua Cecilia Hu Message-Id: <200811250608.mAP68H3w022867@sac.sfbay.sun.com> To: PSARC-record@sac.sfbay.sun.com Subject: raidctl hotspare adjustment [PSARC/2008/731 Self Review] Status: RO Content-Length: 555 Template Version: @(#)sac_nextcase %I% %G% SMI This information is Copyright 2008 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: raidctl hotspare adjustment 1.2. Name of Document Author/Supplier: Author: Ryan Wang 1.3 Date of This Document: 24 November, 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: ON 6.5. ARC review type: Automatic 6.6. ARC Exposure: open From Cecilia.Hu@sun.com Mon Nov 24 22:23:50 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 mAP6Nn1O023241 for ; Mon, 24 Nov 2008 22:23:49 -0800 (PST) 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 mAP6Nf32029165 for <@sunmail2sca.sfbay.sun.com:psarc-ext@sun.com>; Tue, 25 Nov 2008 06:23:48 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 <0KAV00001LRM9R00@nwk-avmta-1.sfbay.Sun.COM> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Mon, 24 Nov 2008 22:23:46 -0800 (PST) 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 <0KAV00ARTLRLMLA0@nwk-avmta-1.sfbay.Sun.COM> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Mon, 24 Nov 2008 22:23:46 -0800 (PST) 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 mAP6NiJl023385 for ; Tue, 25 Nov 2008 06:23:44 +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 <0KAV00E01LPH8Q00@mail-apac.sun.com> (original mail from Cecilia.Hu@Sun.COM) for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Tue, 25 Nov 2008 14:23:44 +0800 (SGT) Received: from [129.158.218.98] by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0KAV004M6LRJ46YX@mail-apac.sun.com> for psarc-ext@sun.com (ORCPT psarc-ext@sun.com); Tue, 25 Nov 2008 14:23:44 +0800 (SGT) Date: Tue, 25 Nov 2008 14:22:03 +0800 From: Cecilia Hu Subject: PSARC 2008/731 raidctl hotspare adjustment Sender: Cecilia.Hu@sun.com To: psarc-ext@sun.com Cc: Yu-Bo Ryan Wang Reply-to: Cecilia.Hu@sun.com Message-id: <492B998B.2030909@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 User-Agent: Thunderbird 2.0.0.9 (X11/20080128) Status: RO Content-Length: 3463 I'm sponsoring this case for Ryan Wang. The requested release binding is micro/patch. This case requests to remove an argument from four functions which were defined as project-private interfaces, the stability level will remain unchanged. Because the architectural impact is obvious enough for a self-review case, I'm marking it as "closed approved automatic". -Cecilia ------------------------------------------------------------------ 1. Introduction 1.1. Project/Component Working Name: raidctl hotspare adjustment 1.2. Name of Document Author/Supplier: Author: Ryan Wang 1.3 Date of This Document: November 25th, 2008 4. Technical Description 1. Introduction 1.1. Project/Component Working Name: raidctl hotspare adjustment 1.2. Name of Document Author/Supplier: Author: Ryan.Wang@Sun.COM 1.3 Date of This Document: November 25th, 2008 4. Technical Description 4.1 Summary The raidctl utility is a RAID configuration tool for mpt controllers in Solaris; however, the interface still needs evolving for the hotspare set/unset actions. According to our survey, all the RAID controllers can only deal with one hot spare disk per time. 4.2 Proposal Presently raidctl software use the following API routines: int raidcfg_set_hsp(int num, struct raidcfg_hsp_relations_t *handles, char **err_str); int raidcfg_unset_hsp(int num, struct raidcfg_hsp_relations_t *handles, char **err_str); For the behavior controller can only deal with one hot spare disk per time, the interface needs to be changed by removing the first parameter 'num', which is the redundant parameter. The interface is project private. raidctl is the only consumer, and there will be no effect for other applications. At the same time, the following SPI routines: int rdcfg_hsp_bind(uint32_t controller_id, uint32_t num, hsp_relation_t *hsp_relations, char **err_ptr); int rdcfg_hsp_unbind(uint32_t controller_id, uint32_t num, hsp_relation_t *hsp_relations, char **err_ptr); are also needs to be changed for the same reason. The interface is also a project private interface, too. 4.3 Interface Summary . RaidCfg CLI interface: Un-touched. . RaidCfg API interface: Remains as project-private. The parameter of the hot spare number will be removed, and the following API routines will be changed to int raidcfg_set_hsp(raidcfg_hsp_relation_t *, char **); int raidcfg_unset_hsp(raidcfg_hsp_relation_t *, char **); . RaidCfg SPI interface: Remains as project-private. The parameter of the hot spare number will be removed, and the following SPI routines will be changed to int rdcfg_hsp_bind(uint32_t, hsp_relation_t *, char **); int rdcfg_hsp_unbind(uint32_t, hsp_relation_t *, char **); 4.4 References [1] PSARC/2005/204 RaidCfg project [2] PSARC/2006/663 RaidCfg MPT adjustment [3] PSARC/2007/667 RaidCfg disk_id adjustment [4] PSARC/2008/458 RaidCfg GUID and volume activation support 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: ON 6.5. ARC review type: self-reviews 6.6. ARC Exposure: open