Introducing non-persistent property group fastreboot_disable_np [PSARC/2009/338 FastTrack timeout 06/10/2009]

[Sherry Moore]

I'm sponsoring this case for myself.  Minor binding only.  Timer
expires on June 10th, 2009.

Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 Introducing non-persistent property group fastreboot_disable_np
    1.2. Name of Document Author/Supplier:
	 Author:  Sherry Moore
    1.3  Date of This Document:
	03 June, 2009

2. Project Summary
   2.1. Project Description:
	To provide a mechanism to disable Fast Reboot for the next
	reboot only.

4. Technical Description:
    4.1. Details:

	With the putback of Fast Reboot by Default (PSARC 2008/760,
	2009/091 and 2009/092), a Fast Reboot capable system will
	bypass firmware when "reboot" or "init 6" is invoked.  For
	those users who wish to reboot through firmware, they can
	invoke "reboot -p" directly, or set config/fastreboot_default
	to false, then reboot.

	However, there are cases where a user would like to reboot
	through firmware only for the next reboot.  One of such case is
	to fully reset the hardware based on vendor recommendation for
	newly flashed firmware to take effect on the Hermon cards.
	While "reboot -p" should suffice, it's preferable if user
	doesn't have to type the additional "-p" option directly.

	Another usage model is the "Restart" button from the "Shutdown"
	menu in GNOME desktop, which currently invokes "init 6".  A new
	"Restart through PROM" button could be added to perform the
	equivalent of "reboot -p", but with all the clean shutdown
	currently performed by "init 6".

	To enable the above usage models, a new non-persistent property
	group "fastreboot_disable_np" will be introduced to
	svc:/system/boot-config:default disable the Fast Reboot by
	Default feature for the next reboot only.

	4.1.1. Library Interface

	A new interface scf_fastreboot_disable_np() will be added
	to disable Fast Reboot by Default for the next reboot only.
	The _np suffix signifies that the disable is non-persistent.


    4.2. Bug/RFE Number(s):

	6846870 Need to add non-persistent Fast Reboot disable support
    
    4.5. Interfaces:
	
	Minor binding only.

	INTERFACE           	COMMITMENT LEVEL	COMMENT

	Property group
	"fastreboot_disable_np"		committed	Requires
							solaris.system.shutdown
							authorization.

	scf_fastreboot_disable_np()	committed

    4.6. Doc Impact:

	4.6.1 Man pages for scf_fastreboot_disable_np(3SCF)

	int scf_fastreboot_disable_np(void);                           |
	                                                               |
	The scf_fastreboot_disable_np() function disables Fast Reboot  |
	by Default temporarily, so that next reboot only will go       |
	through firmware.	      				       | 


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

-- 
Sherry Moore, Solaris Core Kernel	http://blogs.sun.com/sherrym