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.

Reply via email to