手册页部分 1M: 系统管理命令

退出打印视图

更新时间: 2014 年 7 月
 
 

bootadm(1M)

名称

bootadm - 管理引导配置

用法概要

/usr/sbin/bootadm update-archive [-vn] [-R altroot [-p platform]]
/usr/sbin/bootadm list-archive [-vn] [-R altroot [-p platform]]
/usr/sbin/bootadm install-bootloader [-Mfv] [-P pool] [-R path]
     [device1 ...deviceN]
x86 only
/usr/sbin/bootadm set-menu [-P pool] [-R altroot [-p platform]]
     {key=value [key=value ...]}
/usr/sbin/bootadm list-menu [-P pool] [-R altroot [-p platform]]
     [[-i entry_number] | entry_title]
/usr/sbin/bootadm generate-menu [-P pool] [-f]
/usr/sbin/bootadm add-entry [-P pool] [-i entry_number] entry_title
/usr/sbin/bootadm change-entry [-P pool] {[entry_title[,entry_title...]
| -i entry_number[,entry_number]...]} {key=value [key=value ...]
| set-default }

/usr/sbin/bootadm remove-entry [-P pool] {[entry_title[,entry_title...]
| -i entry_number[,entry_number]...]}

描述

bootadm 命令用于管理引导归档文件以及 x86 引导环境中的 GRUB (GRand Unified Bootloader) 菜单。对于 x86,传统 GRUB 和 GRUB2 都受支持(但不是同时支持)。

update–archive 选项提供了一种用于用户更新引导归档文件的方法,作为恢复过程的一种预防措施或一部分。

set-menu 子命令可用于切换 GRUB 菜单中的 auto-boot 超时以及缺省的引导项。

list-menu 子命令显示当前 GRUB 菜单项,或者选择性地显示由索引(如果使用了 –i)或标题字符串(如果省略了 –i)标识的特定条目的详细信息。

install-bootloader 子命令安装系统引导装载程序。它取代了 x86 上的 installgrub(1M) 的功能和 SPARC 上的 installboot(1M),并且支持在 x86 上安装 GRUB2 引导装载程序。

generate-menu 子命令提供了一种为 Solaris 条目创建新菜单配置文件的方法。如果引导装载程序配置文件已存在,则必须传递 –f 以强制该子命令覆盖这些文件。

add-entrychange-entryremove-entry 子命令提供了一些选项,用于在 GRUB 菜单中添加、更改或删除条目。

请注意,基于 OpenBoot PROM (OBP) 的计算机(如 SPARC 系统),不使用 GRUB,也不存在可由 bootadm 管理的引导菜单。

bootadm 命令动态确定要管理的映像支持的选项。这样,平台上调用的 bootadm 命令可用于管理其他平台类型的无盘客户机。

子命令

子命令

对于支持对 entry_title 进行指定的子命令,entry_title 是括在双引号或单引号内的一个字符串。

entry_number 是一个非负整数,表示 GRUB 菜单中的菜单条目的索引。

bootadm 命令包含以下子命令:

update-archive [–vn] [–R altroot [–p platform]]

根据需要更新当前引导归档文件。适用于 SPARC 和 x86 平台。

list-archive [–vn] [–R altroot [–p platform]]

列出引导归档文件中包含的文件以及目录。适用于 SPARC 和 x86 平台。

set-menu [–vn] [–R altroot [–p platform]] {key=value [key=value]...}

维护 GRUB 菜单。可以指定以空格分隔的键-值对列表。

key=value

可能的值为:

default=entry_number

GRUB 菜单中的条目编号(例如,012),用于指定当计时器结束时要引导的操作系统。

timeout=seconds

由缺省的菜单项编号指定的操作系统进行引导之前等待的时间(以秒为单位)。如果值为 -1,则会禁用自动引导。

console=GRUB_console_type

设置用于 GRUB 的控制台的类型。

可能的值为:

'text'

选择一个高分辨率控制台。

'graphics'

选择还会导致图形化引导的一个高分辨率控制台。如果启用了 BIOS 控制台重定向,切勿使用 graphics 来设置控制台。

'serial'

用于 GRUB 引导装载程序的串行控制台。有关串行参数的具体设置,请参见下面的 serial_params

如果启用了 BIOS 控制台重定向,切勿使用 'serial' 来设置控制台

如果通过串行控制台引导来安装系统,则该串行控制台将成为 Solaris 的内核缺省控制台设备。不过,GRUB 的控制台不会更改为 serial(它将是 'text')。

serial_params='port[,speed[,databits[,parity[,stopbits[,flowcontrol]]]]]'

为串行控制台指定串行参数。

port 是用于指定串行端口号的数字。

speed 是用于指定连接的数据速率的数字(以比特/秒为单位)。

databits 是每个字符中的数据位数。

parity 指定用于检测传输错误的方法。可能的值为:

  • N 表示不进行奇偶校验

  • O 表示进行奇数奇偶校验

  • E 表示进行偶数奇偶校验

parity 的值不区分大小写。

stopbits 指定为字符传输发送的停止位。可能的值为 01

flowcontrol 指定流控制。可能的值为:

  • H 表示进行硬件流控制

  • S,表示软件流控制

  • N,表示没有流控制

如果未设置 serial_params,则缺省值为:

0,9600,8,N,1,N

......这将使以下设置成为缺省设置:第一个串行端口 (COM1)、使用 9600 比特/秒波特率、不进行奇偶校验、每个字符 8 个数据位、1 个停止位、不进行流控制。

quiet

指定是否应当禁止将信息性消息输出到控制台。缺省情况下,其值为 false

可能的值为 truefalse

splashimage

指定要用作引导期间的显示图像的文件的路径。

foreground

设置前景色。它是 RRGGBB 格式的一个十六进制字符串值,其中 RR 代表红色,GG 代表绿色,而 BB 代表蓝色。

background

设置背景色。有关可能值,请参见 foreground

list-menu [–P pool] [–R altroot [–p platform]]

列出当前的 GRUB 菜单项。包括自动引导超时、缺省的菜单项数量以及每个菜单项的标题。仅适用于 x86 平台。如果提供了某个条目标题或条目索引,则会显示该特定条目的详细信息。

generate-menu [–P pool]

创建一个新菜单配置,使其仅包含系统上当前安装的 Solaris 项。

add-entry [-P pool] [-i entry_number] entry_title

使用给定的条目标题在菜单中创建一个新条目。

如果指定了 entry_number,则新条目将插入在给定位置,或添加为最后的条目(如果给定的 entry_number 超出了当前的条目数)。

change-entry [–P pool] {[entry_title[,entry_title...] | –i entry_number[,entry_number]...]} { key=value [ key=value ...] | set-default }

修改一个给定条目或以逗号分隔的一组条目的内容。可以通过条目标题或条目编号指定条目。如果有多个条目具有相同的标题,则会影响所有条目。

特殊属性 set-default 用于设置将成为在计时器结束时要引导的缺省条目的条目。当指定了此属性时,只能在子命令中指定一个条目。

可以指定以空格分隔的键值对列表:key=value

可能的值为:

title=entry_title

条目的新标题。

kernel=path_to_kernel

内核的路径。示例:

/platform/i86pc/kernel/amd64/unix
kargs=kernel_arguments

引导期间传递给内核的参数或参数列表。有关可能的选项,请参阅 kernel(1M)。如果列表中有空格,则键值应该括在单引号或双引号中。

boot_archive=path_to_boot_archive

引导归档文件的路径。

bootfs=bootfs

bootfs 属性值。有关进一步的信息,请参阅 zpool(1M)

remove-entry [–P pool] [{entry_title [,entry_title...] | –i entry_number[,entry_number...]}

删除一个给定条目或以逗号分隔的一组条目。如果有多个条目具有相同的指定标题,则会删除所有条目。

install-bootloader [–Mfv] [–P pool] [–R path] [device1 ... deviceN]

安装系统引导装载程序。如果指定了一组设备,则将只在给定的设备上安装引导装载程序。否则,将在从系统配置中自动提取的一组设备上安装引导装载程序。

设备是根文件系统所在的磁盘上的一个分片或分区的原始字符设备的名称。

选项

bootadm 命令包含以下选项:

–f

install-bootloader 安装中,为了不将系统上的引导装载程序的版本降级,将强制安装引导装载程序并绕过所有的版本检查。

–i

要对其应用指定操作的条目编号或以逗号分隔的一组条目编号。

–M [仅限具有 BIOS 固件的 x86 系统]

在 x86 系统上执行的 install-bootloader 操作中,会将引导装载程序安装到主引导记录 (Master Boot Record, MBR) 中,使其成为系统引导装载程序。缺省设置(在具有 BIOS 固件的系统上)是将引导装载程序安装到分区引导记录 (Partition Boot Record, PBR) 中。

–n

update-archive 操作中,只检查归档文件内容但不更新归档文件内容。

–P pool

与要使用的指定池相关联的引导配置。未使用此选项时,会将从中引导系统的当前池用于引导配置。

–p platform

该客户机的平台或计算机硬件类型。该平台类型只能与 –R 一起指定,并且通常只用于管理与服务器不属于同一平台类型的无盘客户机。平台必须为 i86pcsun4usun4v 之一。

–R altroot

操作将应用于该路径或替代的根路径。


注 - 不得使用 –R 选项引用任何非全局区域的根文件系统。否则,可能会损坏全局区域的文件系统,危及全局区域的安全性,或者损坏非全局区域的文件系统。请参见 zones(5)
–v verbose mode

update-archive 操作中,过时的文件显示在标准错误中。在 install-bootloader 操作中,启用详细模式以输出有关该过程的更多信息。

示例

示例 1 更新当前的引导归档文件

以下命令更新当前的引导归档文件:

# bootadm update-archive
示例 2 更新备用根中的引导归档文件

以下命令更新备用根下的引导归档文件:

# bootadm update-archive -R /a
示例 3 切换缺省的引导项

以下命令指向上一示例中显示的菜单。用户选择 Linux(菜单项 2)。

# bootadm set-menu default=2

# bootadm change-entry -i 2 set-default
示例 4 列出 GRUB 菜单项

以下命令列出 GRUB 菜单项:

# bootadm list-menu
The location for the active GRUB menu is: /stubboot/boot/grub/menu.lst
default 0
timeout 10
0 Solaris10
1 Solaris10 failsafe
2 Linux
示例 5 添加和更改菜单项

以下命令在 GRUB 菜单中的位置 8 添加一个标题为 "New Solaris Entry" 的菜单项。

# bootadm  add-entry -i 8  "New Solaris Entry"

以下命令使用内核参数 –s 更改刚添加的条目以便引导至级别 s

# bootadm  change-entry "New Solaris Entry" kargs="-s"
示例 6 在另一根池上安装引导装载程序

以下命令在池 secondrpool 上安装引导装载程序。

# bootadm install-bootloader -P secondrpool
示例 7 设置前景色和背景色

以下命令将前景色设置为红色,将背景色设置为蓝色。

# bootadm set-menu splashimage=/boot/grub/splash.xpm.gz \
foreground=ff0000 background=0000ff

退出状态

将返回以下退出值:

0

命令执行成功。

1

命令因运行出错而退出。

属性

有关下列属性的说明,请参见 attributes(5)

属性类型
属性值
可用性
system/core-os
接口稳定性
Committed(已确定)

附注

bootadm 缺省情况下在 /var/tmp 中存储临时文件,而不考虑 TMPDIR 的设置。

另请参见

boot(1M)installboot(1M)installgrub(1M)kernel(1M)zpool(1M)attributes(5)grub(5)

登录以下网址查阅 GRUB 主页:

http://www.gnu.org/