root_archive(1M) root_archive(1M)
NAME
root_archive - manage bootable miniroot archives
SYNOPSIS
/boot/solaris/bin/root_archive pack archive root
/boot/solaris/bin/root_archive unpack archive root
/boot/solaris/bin/root_archive packmedia solaris_image root
/boot/solaris/bin/root_archive unpackmedia solaris_image root
The root_archive utility is used to manage bootable miniroot archives and is currently only available on platforms. The utility can pack
and unpack boot/root archives in both ufs and hsfs (iso9660) format. It will always generate ufs archives.
root_archive also uses the lofi file driver to export a file as a block device (see lofi(7D)) and mount to mount or unmount file systems
and remote resources (see mount(1M)). root_archive requires the same privileges that are needed to run these commands.
SUBCOMMANDS
The root_archive command has the following subcommands:
pack archive root
Pack from the image found under the root directory to the archive.
unpack archive root
Unpack from the archive to an unpacked image under the root directory.
packmedia solaris_image root
Pack the solaris image to the root directory.
unpackmedia solaris_image root
Unpack the solaris image from the root directory.
For packmedia and unpackmedia, other items that do not go into the ramdisk image are copied or uncopied (see cpio(1)) as well. Specifi-
cally, this includes all the packaging databases needed for pkgadd and the other packaging utilities to succeed which are not used in the
running and hence pruned to conserve memory.
EXAMPLES
Example 1: Unpacking the Solaris x86 install image
The following command unpacks the current Solaris image from the root directory:
# root_archive unpackmedia
/export/nv/solarisdvd.nvx_dvd/latest /export/Boot
Where /export/nv/solarisdvd.nvx_dvd/latest represents a path to a Solaris x86 install image and /export/Boot is a directory that will be
purged or created, as necessary.
Example 2: Packing the Solaris x86 install image
The following command packs the current Solaris image to the root directory:
# root_archive packmedia
/export/nv/solarisdvd.nvx_dvd/latest /export/Boot
The following exit values are returned:
0
The command completed successfully.
1
The command exited due to an error.
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWcsu |
+-----------------------------+-----------------------------+
|Interface Stability |Stable |
+-----------------------------+-----------------------------+
cpio(1), bootadm(1M), mount(1M), attributes(5), lofi(7D)
26 Sep 2005 root_archive(1M)