On 01/27/10 11:23 AM, Sherry Moore wrote:
> Thank you guys for the great work!
>
> When I filed 2008/382 I requested minor binding only. This case is
> requesting patch/micro release binding. Will the binding difference
> need to be reflected in case 2008/382? Will there be compatibility
> concerns as 2008/382 added devo_quiesce to dev_ops?
>
Oh, I didn't see Patch binding.
I'd like to retract my +1 if this is Patch. If its *Minor* binding,
then I'm very happy.
- Garrett
> Sherry
>
> On Tue, Jan 26, 2010 at 04:52:48PM -0800, Huay-Yong Wang wrote:
>
>> I am sponsoring this fasttrack for Chris Kiick.
>>
>> This project implements fast reboot support
>> for SPARC. Specifically, the -f and -p options
>> in reboot(1M) is now supported on SPARC.
>> Previously these options are only available
>> for x86 platforms (See PSARC 2008/382 Fast Reboot)
>> Note that the -e option (boot environments) is not yet
>> supported on SPARC. This project introduces no
>> new interface and I believe this qualify as self-review.
>> I will be marking the case closed approved automatic.
>> If anyone feels that this need to be promoted to a fast track
>> please let me know.
>>
>> The project team is requesting a patch/micro release binding.
>> An updated reboot(1M) manpage is included here.
>>
>>
>> --- cut here ---
>>
>> System Administration Commands reboot(1M)
>>
>>
>>
>> NAME
>> reboot - restart the operating system
>>
>> SYNOPSIS
>> /usr/sbin/reboot [-dlnq] [-f | -p] [boot_arguments]
>>
>>
>> /usr/sbin/reboot [-f [-e environment] | -p] [-dlnq] [boot_arguments]
>>
>>
>> DESCRIPTION
>> The reboot utility restarts the kernel. The kernel is loaded
>> into memory by the PROM monitor, which transfers control to
>> the loaded kernel.
>>
>>
>> On x86 systems, when the -f flag is specified, the running
>> kernel will load the next kernel into memory, then transfer
>> control to the newly loaded kernel. This form of reboot is
>> shown in the second synopsis, above.
>>
>>
>> Although reboot can be run by the super-user at any time,
>> shutdown(1M) is normally used first to warn all users logged
>> in of the impending loss of service. See shutdown(1M) for
>> details.
>>
>>
>> The reboot utility performs a sync(1M) operation on the
>> disks, and then a multi-user reboot is initiated. See
>> init(1M) for details. On x86 systems, reboot may also update
>> the boot archive as needed to ensure a successful reboot.
>>
>>
>> The reboot utility normally logs the reboot to the system
>> log daemon, syslogd(1M), and places a shutdown record in the
>> login accounting file /var/adm/wtmpx. These actions are
>> inhibited if the -n or -q options are present.
>>
>>
>> Normally, the system reboots itself at power-up or after
>> crashes.
>>
>> OPTIONS
>> The following options are supported:
>>
>> -d
>>
>> Force a system crash dump before rebooting. See
>> dumpadm(1M) for information on configuring system crash
>> dumps.
>>
>>
>>
>>
>> SunOS 5.11 Last change: 26 Jan 2010 1
>>
>>
>>
>>
>>
>>
>> System Administration Commands reboot(1M)
>>
>>
>>
>> -e
>>
>> If -f is present, reboot to the specified boot environ-
>> ment.
>>
>> This option is currently available only on x86 systems.
>>
>>
>> -f
>>
>> For x86 systems:
>>
>> 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.
>>
>> For SPARC systems:
>>
>> Speeds up rebooting by skipping some POST tests.
>>
>> The service svc:/system/boot-config:default is enabled
>> by default. It requires solaris.system.shutdown as
>> action_authorization and value_authorization. When the
>> config/fastreboot_default property is set to true,
>> reboot will behave as reboot -f. The value of this pro-
>> perty can be changed using svccfg(1M) and svcadm(1M), to
>> control the default reboot behavior.
>>
>> See EXAMPLES for details.
>>
>>
>> -l
>>
>> Suppress sending a message to the system log daemon,
>> syslogd(1M) about who executed reboot.
>>
>>
>> -n
>>
>> Avoid calling sync(2) and do not log the reboot to
>> syslogd(1M) or to /var/adm/wtmpx. The kernel still
>> attempts to sync filesystems prior to reboot, except if
>> the -d option is also present. If -d is used with -n,
>> the kernel does not attempt to sync file systems.
>>
>>
>> -p
>>
>> Reboot to prom. This flag can be used to reboot the sys-
>> tem through firmware without changing the default reboot
>>
>>
>>
>> SunOS 5.11 Last change: 26 Jan 2010 2
>>
>>
>>
>>
>>
>>
>> System Administration Commands reboot(1M)
>>
>>
>>
>> behavior as denoted by the config/fastreboot_default
>> property setting in system/boot-config service.
>>
>> The -p and -f options are mutually exclusive.
>>
>>
>> -q
>>
>> Quick. Reboot quickly and ungracefully, without shutting
>> down running processes first.
>>
>>
>> OPERANDS
>> The following operands are supported:
>>
>> boot_arguments
>>
>> An optional boot_arguments specifies arguments to the
>> uadmin(2) function that are passed to the boot program
>> and kernel upon restart. The form and list of arguments
>> is described in the boot(1M) and kernel(1M) man pages..
>> If the arguments are specified, whitespace between them
>> is replaced by single spaces unless the whitespace is
>> quoted for the shell. If the boot_arguments begin with a
>> hyphen, they must be preceded by the -- delimiter (two
>> hyphens) to denote the end of the reboot argument list.
>>
>>
>> EXAMPLES
>> Example 1 Passing the -r and -v Arguments to boot
>>
>>
>> In the following example, the delimiter -- (two hyphens)
>> must be used to separate the options of reboot from the
>> arguments of boot(1M).
>>
>>
>> example# reboot -dl -- -rv
>>
>>
>>
>> Example 2 Rebooting Using a Specific Disk and Kernel
>>
>>
>> The following example reboots using a specific disk and ker-
>> nel.
>>
>>
>> example# reboot disk1 kernel.test/unix
>>
>>
>>
>>
>>
>>
>> SunOS 5.11 Last change: 26 Jan 2010 3
>>
>>
>>
>>
>>
>>
>> System Administration Commands reboot(1M)
>>
>>
>>
>> Example 3 Fast Rebooting
>>
>>
>> The following examples use the -f option to perform fast
>> reboots.
>>
>>
>>
>> If the service svc:/system/boot-config:default is enabled
>> and property config/fastreboot_default is set to true, the
>> -f option can be omitted.
>>
>>
>>
>> On an x86 system, the following command reboots to the
>> default entry in the GRUB (see grub(5)) menu file menu.lst.
>>
>>
>> example# reboot -f
>>
>>
>>
>>
>> The following command reboots to another UFS root disk.
>>
>>
>> example# reboot -f -- '/dev/dsk/c1d0s0'
>>
>>
>>
>>
>> The following command reboots to another ZFS root pool.
>>
>>
>> example# reboot -f -- 'rpool/ROOT/root2'
>>
>>
>>
>>
>> The following command reboots to mykernel on the same disk
>> with -k option.
>>
>>
>> example# reboot -f -- '/platform/i86pc/mykernel/amd64/unix -k'
>>
>>
>>
>>
>> The following command reboots to mykernel off another root
>> disk mounted on /mnt.
>>
>>
>>
>>
>>
>> SunOS 5.11 Last change: 26 Jan 2010 4
>>
>>
>>
>>
>>
>>
>> System Administration Commands reboot(1M)
>>
>>
>>
>> example# reboot -f -- '/mnt/platform/i86pc/mykernel/amd64/unix -k'
>>
>>
>>
>>
>> The following command reboots to
>> /platform/i86pc/kernel/$ISADIR/unix on another boot environ-
>> ment named second_root.
>>
>>
>> example# reboot -f -e second_root
>>
>>
>>
>>
>> The following command reboots to the same kernel with -kv
>> options.
>>
>>
>> example# reboot -f -- '-kv'
>>
>>
>>
>>
>> The following commands disable the fast-reboot-by-default
>> behavior.
>>
>>
>> example# svccfg -s "system/boot-config:default" \
>> setprop config/fastreboot_default=false
>> example# svcadm refresh svc:/system/boot-config:default
>>
>>
>>
>>
>> The following commands re-enable the fast-reboot-by-default
>> behavior.
>>
>>
>> example# svccfg -s "system/boot-config:default" \
>> setprop config/fastreboot_default=true
>> example# svcadm refresh svc:/system/boot-config:default
>>
>>
>>
>> Example 4 Rebooting to a Particular GRUB Menu
>>
>>
>> The following commands will reboot to entry 2 in the GRUB
>> menu.
>>
>>
>>
>>
>>
>> SunOS 5.11 Last change: 26 Jan 2010 5
>>
>>
>>
>>
>>
>>
>> System Administration Commands reboot(1M)
>>
>>
>>
>> example# bootadm list-menu
>> the location for the active GRUB menu is: /rpool/boot/grub/menu.lst
>> default 0
>> timeout 10
>> 0 zfsbe1
>> 1 zfsbe1 failsafe
>> 2 zfsbe2
>> 3 zfsbe2 Solaris xVM
>> 4 zfsbe2 failsafe
>> example# reboot 2
>>
>>
>>
>> FILES
>> /var/adm/wtmpx
>>
>> login accounting file
>>
>>
>> ATTRIBUTES
>> See attributes(5) for descriptions of the following attri-
>> butes:
>>
>>
>>
>> ____________________________________________________________
>> | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
>> |_____________________________|_____________________________|
>> | Availability | SUNWcsu |
>> |_____________________________|_____________________________|
>>
>>
>> SEE ALSO
>> mdb(1), boot(1M), dumpadm(1M), fsck(1M), halt(1M), init(1M),
>> kernel(1M), shutdown(1M), svcadm(1M), svccfg(1M), sync(1M),
>> syslogd(1M), sync(2), uadmin(2), reboot(3C), attributes(5),
>> grub(5)
>>
>> NOTES
>> The reboot utility does not execute the scripts in
>> /etc/rcnum.d or execute shutdown actions in inittab(4). To
>> ensure a complete shutdown of system services, use
>> shutdown(1M) or init(1M) to reboot a Solaris system.
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>> SunOS 5.11 Last change: 26 Jan 2010 6
>>
>
