After consulting with the SMF team, I have updated the case write-up to
reflect the following changes:

1. Project name has been changed to
    Introducing non-persistent property group config_ovr.

2. Boolean type property config_ovr/fastreboot_default will be used.

3. The library interface will be called
    scf_fastreboot_default_set_transiet()

The updated write-up has been copied to the materials directory.

Thanks,
Sherry

============================================================================
1. Introduction
   1.1. Project/Component Working Name:
        Introducing non-persistent property group config_ovr.

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

   1.3. Date of This Document:
        5/25/2009
        
        1.3.1. Date this project was conceived:
                5/25/2009

2. Project Summary
   2.1. Project Description:

        To provide an override 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 "config_ovr" will be introduced to
        svc:/system/boot-config:default.  The only supported property
        in the "config_ovr" property group is "fastreboot_default".
        The setting of "config_ovr/fastreboot_default" takes
        precendence over "config/fastreboot_default".

        config                  config_ovr              Next Reboot
        fastreboot_default      fastreboot_default      Behavior
        ================================================================
        X                       false                   slow
        X                       true                    fast

    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
        "config_ovr"            committed               Requires
                                                        solaris.system.shutdown
                                                        authorization.

        scf_fastreboot_default_set_transient()  committed

    4.6. Doc Impact:

        4.6.1 Man pages for scf_fastreboot_default_set_transient(3LIB)

        int scf_fastreboot_default_set_transient(boolean_t val);       |
                                                                       |
        The scf_fastreboot_default_set_transient() function sets       |
        the config_ovr/fastreboot_default property in                  |
        svc:/system/boot-config:default to the passed in value,        |
        which overrides the setting of config/fastreboot_default.      |
        If it's FALSE, the next reboot will go through firmware;       |
        if it's TRUE, the next reboot will bypass 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
============================================================================

Reply via email to