2008/760 Boot configuration Service

[Liane Praza]

I'm submitting this fasttrack on behalf of Sherry Moore.  It specifies Minor 
release binding.

liane

---
1. Introduction
    1.1. Project/Component Working Name:
	Boot configuration Service

    1.2. Name of Document Author/Supplier:
	Sherry Q. Moore

    1.3. Date of This Document:
	12/02/2008
	
	1.3.1. Date this project was conceived:
		11/01/2007

2. Project Summary
    2.1. Project Description:

	To provide a new service to set/change boot configuration
	parameters.  One application of this service will be to control
	Fast Reboot behavior.

4. Technical Description:
     4.1. Details:

	The boot configuration service will be called

	svc:/system/boot-config:default
	    config/fastreboot_default boolean true
	    config/fastreboot_onpanic boolean true

	4.1.1. Service behavior

	    The svc:/system/boot-config:default service will apply the
	    configuration defined in this case by uploading the
	    configuration to the kernel.  The service will be enabled by
	    default.

	    4.1.1.1 fastreboot_default

	    # svccfg -s boot-config:default setprop \
		config/fastreboot_default="false"
	    # svccfg -s boot-config:default refresh

	    When set to true, reboot(1M) and init(1M) 6 would call
	    uadmin(2) with AD_FASTREBOOT which will bypass firmware.

	    4.1.1.2 fastreboot_onpanic

	    # svccfg -s boot-config:default setprop \
		config/fastreboot_onpanic="false"
	    # svccfg -s boot-config:default refresh

	    When set to true, the system will fast reboot on panic.

	4.1.2. Refresh
	
	    # svcadm refresh svc:/system/boot-config:default

	    will upload all the variables to the kernel.

     4.2. Bug/RFE Number(s):

	6768468 Introducing svc:/system/boot-config service

     4.5. Interfaces:
	
	Minor binding only.

	INTERFACE           	    COMMITMENT LEVEL        COMMENT

	svc:/system/boot-config		committed    This service requires
						     solaris.system.shutdown
						     authorization.

	config/fastreboot_default	committed	 Boolean property
	config/fastreboot_onpanic	committed	 Boolean property

	AD_UPDATE_BOOT_CONFIG		Project private  Macro defined
	                                                 in uadmin.h.

     4.6. Doc Impact:

	4.6.1 Man pages for reboot(1M)

      -f

          Fast reboot, bypassing firmware and boot loader. The new
          kernel will be loaded into memory by the running kernel,
          and control will be transferred to the newly loaded ker-
          nel.  If  disk  or  kernel arguments are specified, they
          must be specified before other boot arguments.

          This option is currently available only on x86 systems.
                                                                        |
	 Service svc:/system/boot-config:default is enabled by         |
	 default.  When fastreboot_default property is set to "true",  |
	 "reboot" will behave as "reboot -f".                          |
                                                                        |
          See EXAMPLES for details.

	4.6.2 Man pages for init(1M)

      6

          Stop the  operating  system  and  reboot  to  the  state
          defined by the initdefault entry in /etc/inittab.

	 On x86 systems, service svc:/system/boot-config:default is    |
	 enabled by default.  When the fastreboot_default property is  |
	 set to "true", "init 6" will bypass the firmware.             |

     4.7. Admin/Config Impact:

         With svc:/system/boot-config:default enabled, and the following
	default property settings:

             config/fastreboot_default boolean true
             config/fastreboot_onpanic boolean true

	"reboot(1M)" and "init(1M) 6" will go through the fast reboot
	path.  System will fast reboot on panic.  If no arguments are
	provided to "reboot", the default entry in menu.lst will be
	used.