From sacadmin Wed Feb 11 12:59:48 2009
Received: from tethys.sfbay.sun.com (tethys.SFBay.Sun.COM [129.146.226.92])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n1BKxmQE014286;
	Wed, 11 Feb 2009 12:59:48 -0800 (PST)
Received: from tethys.sfbay.sun.com (localhost [127.0.0.1])
	by tethys.sfbay.sun.com (8.14.3+Sun/8.14.3) with ESMTP id n1BKsLGD010377;
	Wed, 11 Feb 2009 12:54:21 -0800 (PST)
Received: (from jg@localhost)
	by tethys.sfbay.sun.com (8.14.3+Sun/8.14.3/Submit) id n1BKsL3m010374;
	Wed, 11 Feb 2009 12:54:21 -0800 (PST)
Date: Wed, 11 Feb 2009 12:54:21 -0800 (PST)
From: Jerry Gilliam <jg@tethys.sfbay.sun.com>
Message-Id: <200902112054.n1BKsL3m010374@tethys.sfbay.sun.com>
To: PSARC-record@sac.sfbay.sun.com
Cc: Konstantin.Ananyev@Sun.Com, Sherry.Moore@Sun.Com
Subject: libgrubmgmt - library for GRUB menu management [PSARC/2009/092 FastTrack timeout 02/18/2009]
Status: RO
Content-Length: 583


Template Version: @(#)sac_nextcase %I% %G% SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 libgrubmgmt - library for GRUB menu management
    1.2. Name of Document Author/Supplier:
	 Author:  Konstantin Ananyev
    1.3  Date of This Document:
	11 February, 2009
4. Technical Description
    See the case directory for more detail

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


From jg@jurassic.sfbay.Sun.COM Wed Feb 11 13:16:23 2009
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 n1BLGMoO015626
	for <psarc-ext@sac.sfbay.sun.com>; Wed, 11 Feb 2009 13:16:23 -0800 (PST)
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 n1BLGKSL006997;
	Wed, 11 Feb 2009 13:16:20 -0800 (PST)
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 <0KEX0000D737FW00@nwk-avmta-2.sfbay.sun.com>; Wed,
 11 Feb 2009 13:16:19 -0800 (PST)
Received: from jurassic.eng.sun.com ([129.146.228.50])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KEX00HTP735J2A0@nwk-avmta-2.sfbay.sun.com>; Wed,
 11 Feb 2009 13:16:17 -0800 (PST)
Received: from tethys (tethys.SFBay.Sun.COM [129.146.226.92])
	by jurassic.eng.sun.com (8.13.8+Sun/8.13.8) with SMTP id n1BLGEWY527589; Wed,
 11 Feb 2009 13:16:14 -0800 (PST)
Date: Wed, 11 Feb 2009 13:10:46 -0800 (PST)
From: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Subject: libgrubmgmt - library for GRUB menu management [PSARC/2009/092
 02/18/2009]
To: PSARC-ext@sun.com
Cc: Konstantin.Ananyev@sun.com, sherry.moore@sun.com, Evan.Layton@sun.com,
        ethan.quach@sun.com
Reply-to: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Message-id: <200902112116.n1BLGEWY527589@jurassic.eng.sun.com>
MIME-version: 1.0
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.7_98 SunOS 5.11 sun4u sparc
Content-type: TEXT/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-MD5: rzaMvdyLq0/K3CfCv9kNbA==
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 5963



I am submitting the following fast-track on behalf of Konstanin Ananyev
and Sherry Moore.  Minor release binding is requested.  The timeout is
set for 02-18-2009.

-jg

1. Introduction
   1.1. Project/Component Working Name:
	Introducing libgrubmgmt library for GRUB menu management.

   1.2. Name of Document Author/Supplier:
	Konstantin Ananyev

   1.3. Date of This Document:
	01/07/2009
	
	1.3.1. Date this project was conceived:
	    06/01/2008

2. Project Summary

    2.1. Project Description:

    This project will provide a library to process the GRUB menu.  The
    library libgrubmgmt provides APIs to locate the active menu.lst,
    parse it and interpret GRUB menu entries.

    2.2 Risks and Assumptions:

    This project has dependencies on stable GRUB menu format for
    Solaris.

4. Technical Description:

    4.1. Details:

	The library libgrubmgmt provides APIs to locate the active
	menu.lst, parse the menu and interpret GRUB menu entries.  It
	will interpret the following GRUB menu entry commands:
	findroot, bootfs, kernel, kernel$, module, module$.

	When Fast Reboot is enabled either by setting the
	"config/fastreboot_default" property in "system/boot-config"
	service to "true", or by invoking reboot(1M) with the "-f"
	option directly, the library will be used by commands
	reboot(1M) or init(1M) 6 to extract boot arguments associated
	with the default or specified menu entry from menu.lst.  If
	libgrubmgmt fails to interpret the GRUB menu entry, reboot(1M)
	and init(1M) would fall back to the regular reboot behavior.

    4.1.1 APIs and Consumers

	With initial integration, the consumers of the library are
	reboot(1M) and init(1M) on x86.  They are only using the 
	two of the interfaces listed in section 4.5 Interfaces

	    grub_get_boot_args()
	    grub_cleanup_boot_args()

	Other utilities that manipulate GRUB menus, such as
	bootadm(1M), can be modified to leverage this library, at
	which point additional interfaces can be ARC'ed.

    4.1.2 Examples

	On systems with "config/fastreboot_default" set to "true":

	    # reboot
	    # init 6
		Fast reboot with bootargs from the default GRUB menu
		entry.

	    # reboot 3
		Fast reboot with bootargs from the 3rd GRUB menu entry.

	For example for the following default GRUB menu entry:

		title benew1
		findroot (BE_benew1,0,a)
		bootfs rpool/ROOT/benew1
		kernel$ /platform/i86pc/kernel/$ISADIR/unix -B $ZFS-BOOTFS
		module$ /platform/i86pc/$ISADIR/boot_archive

	    # reboot

	is equivalent to:

	    # reboot -f -- rpool/ROOT/benew1 \
		/platform/i86pc/kernel/amd64/unix  \
		-B zfs-bootfs=rpool/ROOT/benew1,\
		bootpath="/pci@0,0/pci10de,5c@9/pci108e,4131@1/sd@0,0:a"

    4.2. Bug/RFE Number(s):

	6768468 Introducing svc:/system/boot-config service
	6775160 reboot -f ignores active BE and resets zfs pool bootfs property
    
    4.5. Interfaces:

	Minor binding only.
	
	INTERFACE           	    	COMMITMENT LEVEL
	=====================================================	
	/lib/libgrubmgmt.so.1		consolidation private
	/lib/libgrubmgmt.so		consolidation private
	/usr/include/libgrubmgmt.h	consolidation private
	SUNWgrubu			consolidation private

	grub_get_boot_args()		consolidation private
	grub_cleanup_boot_args()	consolidation private
	grub_strerror()			consolidation private

    4.6. Doc Impact:

	Man pages for reboot(1M) needs to be modified.

	4.6.1 Man pages for reboot(1M) 

	 Example 3 Fast Rebooting

	 The following examples use the  f  option  to  perform  fast
	 reboots.

	 The following command reboots to the default entry in the grub   |
	 menu file menu.lst.						  |

	   example# reboot -f

	4.6.2 New man pages for libgrubmgmt

	 See appendix A.
	 
    4.7. Admin/Config Impact

	The System Administration Guide needs to be updated to reflect
	the change in the behavior when no command line arguments are
	provided to reboot(1M).

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


Appendix A

GRUB Menu Management Library Functions
                                               grubmgmt(3GRUBMGMT)

NAME
     grub_get_boot_args - collect boot argument from the specified GRUB
     menu entry.  If entrynum == -1, default GRUB menu entry will be used.

     grub_cleanup_boot_args - clean up and releases all the resources
     allocated by grub_get_boot_args.

SYNOPSIS
     cc [ flag... ] file... -lgrubmgmt  [ library... ]

     #include <libgrubmgmt.h>

     int grub_get_boot_args(grub_boot_args_t *bargs, int entrynum);
     void grub_cleanup_boot_args(grub_boot_args_t *bargs);


PARAMETERS
    
     entrynum		Integer representing the entry or line number
			in the menu.

     bargs		Pointer to boot argument data structure.

DESCRIPTION
     The grub_get_boot_args() function returns the boot arguments from
     the specified GRUB menu entry in the first argument.  If entrynum
     is -1, default GRUB menu entry will be used.  Caller must allocate
     grub_boot_args_t and call the function with a pointer to it as its
     first argument.

     The grub_cleanup_boot_args() function clean up and releases all the
     resources allocated by grub_get_boot_args().

RETURN VALUES
     grub_get_boot_args() returns zero on success and an error value on
     failrue.  See errno.h for details.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Evolving                    |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe			|
    |_____________________________|_____________________________|


SEE ALSO

    errno.h(3HEAD)


From ro@techfak.uni-bielefeld.de Thu Feb 12 03:48:57 2009
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 n1CBmuoY028276
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 12 Feb 2009 03:48:56 -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 n1CBmnNW020870;
	Thu, 12 Feb 2009 11:48:52 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 <0KEY00E0LBHD5400@nwk-avmta-1.sfbay.Sun.COM>; Thu,
 12 Feb 2009 03:48:49 -0800 (PST)
Received: from sca-ea-mail-3.sun.com ([192.18.43.21])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KEY002WSBHCPNA0@nwk-avmta-1.sfbay.Sun.COM>; Thu,
 12 Feb 2009 03:48:48 -0800 (PST)
Received: from relay42i.sun.com ([192.5.209.72])
	by sca-ea-mail-3.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n1CBb2F0025242;
 Thu, 12 Feb 2009 11:48:48 +0000 (GMT)
Received: from mms49es.mms.us.syntegra.com ([160.41.221.232] [160.41.221.232])
 by relay42i.sun.com with ESMTP id BT-MMP-1275496; Thu,
 12 Feb 2009 11:48:47 +0000 (Z)
Received: from relay44i.sun.com (relay44i.sun.com [192.5.209.118])
 by mms49es.mms.us.syntegra.com with ESMTP id BT-MMP-18489517; Thu,
 12 Feb 2009 11:48:46 +0000 (Z)
Received: from smarthost.TechFak.Uni-Bielefeld.DE
 ([129.70.137.17] [129.70.137.17]) by relay4i.sun.com with ESMTP id
 BT-MMP-9615422; Thu, 12 Feb 2009 11:48:46 +0000 (Z)
Received: from manam.TechFak.Uni-Bielefeld.DE
 (manam.TechFak.Uni-Bielefeld.DE [129.70.137.47])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)	by smarthost.TechFak.Uni-Bielefeld.DE
 (Postfix) with ESMTP id BE651481CA; Thu, 12 Feb 2009 12:48:45 +0100 (CET)
Date: Thu, 12 Feb 2009 12:48:45 +0100
From: Rainer Orth <ro@techfak.uni-bielefeld.de>
Subject: Re: libgrubmgmt - library for GRUB menu management [PSARC/2009/092
	02/18/2009]
In-reply-to: Jerry Gilliam's message of "Wed, 11 Feb 2009 13:10:46 -0800 (PST)"
Sender: ro@techfak.uni-bielefeld.de
To: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Cc: PSARC-ext@sun.com, ethan.quach@sun.com, Konstantin.Ananyev@sun.com,
        Evan.Layton@sun.com, sherry.moore@sun.com
Message-id: <ydd4oyz7u5e.fsf@manam.TechFak.Uni-Bielefeld.DE>
MIME-version: 1.0
X-Mailer: Gnus v5.6.44/Emacs 19.34
Content-type: text/plain; charset=US-ASCII
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
X-Brightmail-Tracker: AAAAAA==
X-Antispam: No, score=0.0/5.0, scanned in 1.042sec at (localhost [127.0.0.1])
	by smf-spamd v1.3.1 - http://smfs.sf.net/
Lines: 42
References: <200902112116.n1BLGEWY527589@jurassic.eng.sun.com>
Status: RO
Content-Length: 1333

Jerry Gilliam <jg@jurassic.sfbay.Sun.COM> writes:

>     4.5. Interfaces:
> 
> 	Minor binding only.
> 	
> 	INTERFACE           	    	COMMITMENT LEVEL
> 	=====================================================	
> 	/lib/libgrubmgmt.so.1		consolidation private
> 	/lib/libgrubmgmt.so		consolidation private
> 	/usr/include/libgrubmgmt.h	consolidation private
> 	SUNWgrubu			consolidation private

Should the .so symlink and the include file be delivered at all while this
is still consolidation private?

>     4.6. Doc Impact:
[...]
> 	4.6.2 New man pages for libgrubmgmt
> 
> 	 See appendix A.

Same here: in particular, the proposed man pages conflicts with the
commitment level proposed above:

> ATTRIBUTES
>      See attributes(5) for descriptions of the  following  attri-
>      butes:
> 
>      ____________________________________________________________
>     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
>     |_____________________________|_____________________________|
>     | Interface Stability         | Evolving                    |
>     |_____________________________|_____________________________|

So what is it?  Evolving or Consolidation Private?

	Rainer

-- 
-----------------------------------------------------------------------------
Rainer Orth, Faculty of Technology, Bielefeld University

From jg@jurassic.sfbay.Sun.COM Thu Feb 12 10:24:19 2009
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 n1CIOITN023120
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 12 Feb 2009 10:24:18 -0800 (PST)
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 n1CIO3k8027258;
	Thu, 12 Feb 2009 18:24: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 <0KEY00K2JTSCIF00@brm-avmta-1.central.sun.com>; Thu,
 12 Feb 2009 11:24:12 -0700 (MST)
Received: from jurassic.eng.sun.com ([129.146.106.31])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KEY005FATS0H1D0@brm-avmta-1.central.sun.com>; Thu,
 12 Feb 2009 11:24:00 -0700 (MST)
Received: from tethys (tethys.SFBay.Sun.COM [129.146.226.92])
	by jurassic.eng.sun.com (8.13.8+Sun/8.13.8) with SMTP id n1CINw4j555353; Thu,
 12 Feb 2009 10:23:58 -0800 (PST)
Date: Thu, 12 Feb 2009 10:18:30 -0800 (PST)
From: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Subject: Re: libgrubmgmt - library for GRUB menu management [PSARC/2009/092
 02/18/2009]
To: ro@techfak.uni-bielefeld.de
Cc: PSARC-ext@sun.com, ethan.quach@sun.com, Konstantin.Ananyev@sun.com,
        Evan.Layton@sun.com, sherry.moore@sun.com
Reply-to: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Message-id: <200902121823.n1CINw4j555353@jurassic.eng.sun.com>
MIME-version: 1.0
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.7_98 SunOS 5.11 sun4u sparc
Content-type: TEXT/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-MD5: pxHKm1yn6KqBPSOsDCl9Og==
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 734



>
>Same here: in particular, the proposed man pages conflicts with the
>commitment level proposed above:
>
>> ATTRIBUTES
>>      See attributes(5) for descriptions of the  following  attri-
>>      butes:
>> 
>>      ____________________________________________________________
>>     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
>>     |_____________________________|_____________________________|
>>     | Interface Stability         | Evolving                    |
>>     |_____________________________|_____________________________|
>
>So what is it?  Evolving or Consolidation Private?
>
>	Rainer
>


The above is boiler-plate from the man page format and shouldn't
have been included here in the spec.


-jg


From Konstantin.Ananyev@sun.com Thu Feb 12 14:10:30 2009
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 n1CMAT4l025920
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 12 Feb 2009 14:10:30 -0800 (PST)
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 n1CMAQAU026252
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 13 Feb 2009 06:10:28 +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 <0KEZ0010549FNV00@nwk-avmta-1.sfbay.Sun.COM> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 12 Feb 2009 14:10:27 -0800 (PST)
Received: from gmp-eb-inf-2.sun.com ([192.18.6.24])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KEZ009NY49AYU70@nwk-avmta-1.sfbay.Sun.COM> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 12 Feb 2009 14:10:26 -0800 (PST)
Received: from fe-emea-10.sun.com (gmp-eb-lb-2-fe3.eu.sun.com [192.18.6.12])
	by gmp-eb-inf-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n1CMAMmZ008282	for
 <PSARC-ext@sun.com>; Thu, 12 Feb 2009 22:10:22 +0000 (GMT)
Received: from conversion-daemon.fe-emea-10.sun.com by fe-emea-10.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 id <0KEZ005004786Y00@fe-emea-10.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 12 Feb 2009 22:10:21 +0000 (GMT)
Received: from [129.150.120.246] ([unknown] [129.150.120.246])
 by fe-emea-10.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 with ESMTPSA id <0KEZ001JJ499RMB0@fe-emea-10.sun.com>; Thu,
 12 Feb 2009 22:10:21 +0000 (GMT)
Date: Thu, 12 Feb 2009 22:04:06 +0000
From: Konstantin Ananyev <Konstantin.Ananyev@sun.com>
Subject: Re: libgrubmgmt - library for GRUB menu management [PSARC/2009/092
 02/18/2009]
In-reply-to: <ydd4oyz7u5e.fsf@manam.TechFak.Uni-Bielefeld.DE>
Sender: Konstantin.Ananyev@sun.com
To: Rainer Orth <ro@techfak.uni-bielefeld.de>
Cc: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>, PSARC-ext@sun.com,
        ethan.quach@sun.com, Evan.Layton@sun.com, Sherry.Moore@sun.com
Message-id: <49949CD6.2030809@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: <200902112116.n1BLGEWY527589@jurassic.eng.sun.com>
 <ydd4oyz7u5e.fsf@manam.TechFak.Uni-Bielefeld.DE>
User-Agent: Thunderbird 2.0.0.9 (X11/20080128)
Status: RO
Content-Length: 1428

Hi Rainer,

Ok, as there no need to deliver them,
neither the .so nor the .h file will be shipped in the product.
Thanks
Konstantin
> Jerry Gilliam <jg@jurassic.sfbay.Sun.COM> writes:
>
>   
>>     4.5. Interfaces:
>>
>> 	Minor binding only.
>> 	
>> 	INTERFACE           	    	COMMITMENT LEVEL
>> 	=====================================================	
>> 	/lib/libgrubmgmt.so.1		consolidation private
>> 	/lib/libgrubmgmt.so		consolidation private
>> 	/usr/include/libgrubmgmt.h	consolidation private
>> 	SUNWgrubu			consolidation private
>>     
>
> Should the .so symlink and the include file be delivered at all while this
> is still consolidation private?
>
>   
>>     4.6. Doc Impact:
>>     
> [...]
>   
>> 	4.6.2 New man pages for libgrubmgmt
>>
>> 	 See appendix A.
>>     
>
> Same here: in particular, the proposed man pages conflicts with the
> commitment level proposed above:
>
>   
>> ATTRIBUTES
>>      See attributes(5) for descriptions of the  following  attri-
>>      butes:
>>
>>      ____________________________________________________________
>>     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
>>     |_____________________________|_____________________________|
>>     | Interface Stability         | Evolving                    |
>>     |_____________________________|_____________________________|
>>     
>
> So what is it?  Evolving or Consolidation Private?
>
> 	Rainer
>
>   


From ethan.quach@sun.com Thu Feb 12 15:00:39 2009
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 n1CN0dPC027102
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 12 Feb 2009 15:00:39 -0800 (PST)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n1CN0bth013965;
	Thu, 12 Feb 2009 15:00:37 -0800 (PST)
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 <0KEZ0080D6L16200@nwk-avmta-1.sfbay.Sun.COM>; Thu,
 12 Feb 2009 15:00:37 -0800 (PST)
Received: from jurassic-x4600.sfbay.sun.com ([129.146.17.59])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KEZ0092V6L0Z3C0@nwk-avmta-1.sfbay.Sun.COM>; Thu,
 12 Feb 2009 15:00:36 -0800 (PST)
Received: from [129.146.228.176] (ethos.SFBay.Sun.COM [129.146.228.176])
	by jurassic-x4600.sfbay.sun.com (8.14.3+Sun/8.14.3)
 with ESMTP id n1CN0XWd870738; Thu, 12 Feb 2009 15:00:33 -0800 (PST)
Date: Thu, 12 Feb 2009 15:00:06 -0800
From: Ethan Quach <ethan.quach@sun.com>
Subject: Re: libgrubmgmt - library for GRUB menu management [PSARC/2009/092
 02/18/2009]
In-reply-to: <ydd4oyz7u5e.fsf@manam.TechFak.Uni-Bielefeld.DE>
To: Rainer Orth <ro@techfak.uni-bielefeld.de>
Cc: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>, PSARC-ext@sun.com,
        Konstantin.Ananyev@sun.com, Evan.Layton@sun.com, sherry.moore@sun.com
Reply-to: ethan.quach@sun.com
Message-id: <4994A9F6.1050508@sun.com>
Organization: Sun Microsystems
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200902112116.n1BLGEWY527589@jurassic.eng.sun.com>
 <ydd4oyz7u5e.fsf@manam.TechFak.Uni-Bielefeld.DE>
User-Agent: Thunderbird 2.0.0.18 (X11/20081216)
Status: RO
Content-Length: 669



Rainer Orth wrote:
> Jerry Gilliam <jg@jurassic.sfbay.Sun.COM> writes:
> 
>>     4.5. Interfaces:
>>
>> 	Minor binding only.
>> 	
>> 	INTERFACE           	    	COMMITMENT LEVEL
>> 	=====================================================	
>> 	/lib/libgrubmgmt.so.1		consolidation private
>> 	/lib/libgrubmgmt.so		consolidation private
>> 	/usr/include/libgrubmgmt.h	consolidation private
>> 	SUNWgrubu			consolidation private
> 
> Should the .so symlink and the include file be delivered at all while this
> is still consolidation private?

The BE tools in OpenSolaris could make use of this sooner rather
than later, so it'd be nice if the headers were there.


-ethan

From Konstantin.Ananyev@sun.com Thu Feb 12 17:11:45 2009
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 n1D1BiL2023972
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 12 Feb 2009 17:11:45 -0800 (PST)
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 n1D1BgAr004862
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 13 Feb 2009 09:11:43 +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 <0KEZ00D0RCNISE00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Thu, 12 Feb 2009 18:11:42 -0700 (MST)
Received: from gmp-eb-inf-2.sun.com ([192.18.6.24])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KEZ00K7ACNESAD0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Thu,
 12 Feb 2009 18:11:41 -0700 (MST)
Received: from fe-emea-09.sun.com (gmp-eb-lb-1-fe3.eu.sun.com [192.18.6.10])
	by gmp-eb-inf-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n1D1Bc5S012777	for
 <PSARC-ext@sun.com>; Fri, 13 Feb 2009 01:11:38 +0000 (GMT)
Received: from conversion-daemon.fe-emea-09.sun.com by fe-emea-09.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 id <0KEZ00L00CKHXQ00@fe-emea-09.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 13 Feb 2009 01:11:38 +0000 (GMT)
Received: from [129.150.120.246] ([unknown] [129.150.120.246])
 by fe-emea-09.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 with ESMTPSA id <0KEZ00MZ8CNDB970@fe-emea-09.sun.com>; Fri,
 13 Feb 2009 01:11:38 +0000 (GMT)
Date: Fri, 13 Feb 2009 01:05:22 +0000
From: Konstantin Ananyev <Konstantin.Ananyev@sun.com>
Subject: Re: libgrubmgmt - library for GRUB menu management [PSARC/2009/092
 02/18/2009]
In-reply-to: <49949CD6.2030809@sun.com>
Sender: Konstantin.Ananyev@sun.com
To: Rainer Orth <ro@techfak.uni-bielefeld.de>
Cc: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>, PSARC-ext@sun.com,
        Ethan.Quach@sun.com, Evan.Layton@sun.com, Sherry.Moore@sun.com
Message-id: <4994C752.3080207@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: <200902112116.n1BLGEWY527589@jurassic.eng.sun.com>
 <ydd4oyz7u5e.fsf@manam.TechFak.Uni-Bielefeld.DE> <49949CD6.2030809@sun.com>
User-Agent: Thunderbird 2.0.0.9 (X11/20080128)
Status: RO
Content-Length: 1683

Actually after extensive discussions with other project teams, we have 
decided to ship the header file too.
Thanks
Konstantin
> Hi Rainer,
>
> Ok, as there no need to deliver them,
> neither the .so nor the .h file will be shipped in the product.
> Thanks
> Konstantin
>> Jerry Gilliam <jg@jurassic.sfbay.Sun.COM> writes:
>>
>>  
>>>     4.5. Interfaces:
>>>
>>>     Minor binding only.
>>>     
>>>     INTERFACE                       COMMITMENT LEVEL
>>>     =====================================================   
>>>     /lib/libgrubmgmt.so.1        consolidation private
>>>     /lib/libgrubmgmt.so        consolidation private
>>>     /usr/include/libgrubmgmt.h    consolidation private
>>>     SUNWgrubu            consolidation private
>>>     
>>
>> Should the .so symlink and the include file be delivered at all while 
>> this
>> is still consolidation private?
>>
>>  
>>>     4.6. Doc Impact:
>>>     
>> [...]
>>  
>>>     4.6.2 New man pages for libgrubmgmt
>>>
>>>      See appendix A.
>>>     
>>
>> Same here: in particular, the proposed man pages conflicts with the
>> commitment level proposed above:
>>
>>  
>>> ATTRIBUTES
>>>      See attributes(5) for descriptions of the  following  attri-
>>>      butes:
>>>
>>>      ____________________________________________________________
>>>     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
>>>     |_____________________________|_____________________________|
>>>     | Interface Stability         | Evolving                    |
>>>     |_____________________________|_____________________________|
>>>     
>>
>> So what is it?  Evolving or Consolidation Private?
>>
>>     Rainer
>>
>>   
>
>


From Richard.Matthews@sun.com Fri Feb 13 10:52:48 2009
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 n1DIqlxG027679
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 13 Feb 2009 10:52:48 -0800 (PST)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n1DIqkYo003540
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 13 Feb 2009 11:52:47 -0700 (MST)
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 <0KF00040BPRXW200@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 13 Feb 2009 11:52:45 -0700 (MST)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KF000EJNPRXRL90@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 13 Feb 2009 11:52:45 -0700 (MST)
Received: from fe-amer-09.sun.com ([192.18.109.79])
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n1DIqjkx028012	for
 <PSARC-ext@sun.com>; Fri, 13 Feb 2009 18:52:45 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 id <0KF000F00OFV9W00@mail-amer.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 13 Feb 2009 11:52:45 -0700 (MST)
Received: from [129.152.9.14] ([unknown] [129.152.9.14])
 by mail-amer.sun.com (Sun Java(tm) System Messaging Server 7.0-3.01 64bit
 (built Dec 23 2008)) with ESMTPSA id <0KF0003U0PRLSGC0@mail-amer.sun.com>; Fri,
 13 Feb 2009 11:52:34 -0700 (MST)
Date: Fri, 13 Feb 2009 12:52:33 -0600
From: Rick Matthews <Richard.Matthews@sun.com>
Subject: Re: libgrubmgmt - library for GRUB menu management [PSARC/2009/092
 02/18/2009]
In-reply-to: <200902112116.n1BLGEWY527589@jurassic.eng.sun.com>
Sender: Richard.Matthews@sun.com
To: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Cc: PSARC-ext@sun.com, Konstantin.Ananyev@sun.com, Sherry.Moore@sun.com,
        Evan.Layton@sun.com, Ethan.Quach@sun.com
Reply-to: Richard.Matthews@sun.com
Message-id: <4995C171.3020605@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: <200902112116.n1BLGEWY527589@jurassic.eng.sun.com>
User-Agent: Thunderbird 2.0.0.16 (X11/20080807)
Status: RO
Content-Length: 718

In your examples (4.1.2), you cite:
    init 6 <fast reboot with bootargs from the default GRUB menu entry>

Would init 6 3, select the 3rd set of bootargs?

Does the nth entry in the Grub menu correspond to that in the
"bootadm list-menu" command?

-- 
---------------------------------------------------------------------
Rick Matthews                           email: Rick.Matthews@sun.com
Sun Microsystems, Inc.                  phone:+1(651) 554-1518
1270 Eagan Industrial Road              phone(internal): 54418
Suite 160                               fax:  +1(651) 554-1540
Eagan, MN 55121-1231 USA                main: +1(651) 554-1500		
---------------------------------------------------------------------


From Konstantin.Ananyev@sun.com Fri Feb 13 12:17:01 2009
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 n1DKH1wu022894
	for <psarc-ext@sac.sfbay.sun.com>; Fri, 13 Feb 2009 12:17:01 -0800 (PST)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n1DKGvjn018998
	for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Fri, 13 Feb 2009 12:17:01 -0800 (PST)
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 <0KF000C11TOAXF00@brm-avmta-1.central.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 13 Feb 2009 13:16:58 -0700 (MST)
Received: from gmp-eb-inf-2.sun.com ([192.18.6.24])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KF000ECOTO7RJF0@brm-avmta-1.central.sun.com> for
 PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Fri,
 13 Feb 2009 13:16:55 -0700 (MST)
Received: from fe-emea-10.sun.com (gmp-eb-lb-1-fe3.eu.sun.com [192.18.6.10])
	by gmp-eb-inf-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n1DKGsma024960	for
 <PSARC-ext@sun.com>; Fri, 13 Feb 2009 20:16:54 +0000 (GMT)
Received: from conversion-daemon.fe-emea-10.sun.com by fe-emea-10.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 id <0KF000M00T9J1V00@fe-emea-10.sun.com> for PSARC-ext@sun.com
 (ORCPT PSARC-ext@sun.com); Fri, 13 Feb 2009 20:16:54 +0000 (GMT)
Received: from [129.150.120.246] ([unknown] [129.150.120.246])
 by fe-emea-10.sun.com
 (Sun Java(tm) System Messaging Server 7.0-3.01 64bit (built Dec 23 2008))
 with ESMTPSA id <0KF0005RQTO61E00@fe-emea-10.sun.com>; Fri,
 13 Feb 2009 20:16:54 +0000 (GMT)
Date: Fri, 13 Feb 2009 20:10:38 +0000
From: Konstantin Ananyev <Konstantin.Ananyev@sun.com>
Subject: Re: libgrubmgmt - library for GRUB menu management [PSARC/2009/092
 02/18/2009]
In-reply-to: <4995C171.3020605@Sun.COM>
Sender: Konstantin.Ananyev@sun.com
To: Richard.Matthews@sun.com
Cc: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>, PSARC-ext@sun.com,
        Sherry.Moore@sun.com, Evan.Layton@sun.com, Ethan.Quach@sun.com
Message-id: <4995D3BE.3030808@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: <200902112116.n1BLGEWY527589@jurassic.eng.sun.com>
 <4995C171.3020605@Sun.COM>
User-Agent: Thunderbird 2.0.0.9 (X11/20080128)
Status: RO
Content-Length: 444

Hi Rick,
> In your examples (4.1.2), you cite:
>    init 6 <fast reboot with bootargs from the default GRUB menu entry>
>
> Would init 6 3, select the 3rd set of bootargs?
No, "init 6 3" will not select the 3rd set of bootargs, because
init(1M) only takes one argument.

# init 6 3
Usage: init [0123456SsQqabc]
>
>
> Does the nth entry in the Grub menu correspond to that in the
> "bootadm list-menu" command?
That's right.
Thanks
Konstantin



From jg@jurassic.sfbay.Sun.COM Thu Feb 19 15:10:00 2009
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 n1JN9xhM020987
	for <psarc-ext@sac.sfbay.sun.com>; Thu, 19 Feb 2009 15:10:00 -0800 (PST)
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 n1JN9mwH000926;
	Fri, 20 Feb 2009 07:09:53 +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 <0KFC0010F5OFFB00@brm-avmta-1.central.sun.com>; Thu,
 19 Feb 2009 16:09:51 -0700 (MST)
Received: from jurassic.eng.sun.com ([129.146.17.57])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KFC00FMV5OF3A90@brm-avmta-1.central.sun.com>; Thu,
 19 Feb 2009 16:09:51 -0700 (MST)
Received: from tethys (tethys.SFBay.Sun.COM [129.146.226.92])
	by jurassic.eng.sun.com (8.13.8+Sun/8.13.8) with SMTP id n1JN9lbC230635; Thu,
 19 Feb 2009 15:09:47 -0800 (PST)
Date: Thu, 19 Feb 2009 15:04:16 -0800 (PST)
From: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Subject: Re: libgrubmgmt - library for GRUB menu management [PSARC/2009/092
 02/18/2009]
To: PSARC-ext@sun.com
Cc: Konstantin.Ananyev@sun.com, Sherry.Moore@sun.com, Evan.Layton@sun.com,
        ethan.quach@sun.com
Reply-to: Jerry Gilliam <jg@jurassic.sfbay.Sun.COM>
Message-id: <200902192309.n1JN9lbC230635@jurassic.eng.sun.com>
MIME-version: 1.0
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.7_98 SunOS 5.11 sun4u sparc
Content-type: TEXT/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-MD5: QjguZ2DQkeVruFYZKDGswA==
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 87



This fast-track has expired so I am now marking this case
as closed approved.


-jg


