System Administration Commands rootarchive(1M)
NAME
rootarchive - manage bootable miniroot archives
SYNOPSIS
/boot/solaris/bin/rootarchive pack archive root
/boot/solaris/bin/rootarchive unpack archive root
/boot/solaris/bin/rootarchive packmedia solarisimage root
/boot/solaris/bin/rootarchive unpackmedia solarisimage root
DESCRIPTION
The rootarchive utility is used to manage bootable miniroot
archives and is currently only available on x86 platforms.
The utility can pack and unpack boot/root archives in both
ufs and hsfs (iso9660) format. It will always generate ufs
archives.
rootarchive 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)).
rootarchive requires the same privileges that are needed to
run these commands.
SUBCOMANDS
The rootarchive 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 solarisimage root
Pack the solaris image to the root directory.
unpackmedia solarisimage root
Unpack the solaris image from the root directory.
SunOS 5.11 Last change: 26 Sep 2005 1
System Administration Commands rootarchive(1M)
For packmedia and unpackmedia, other items that do not go
into the ramdisk image are copied or uncopied (see cpio(1))
as well. Specifically, this includes all the packaging data-
bases 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:
# rootarchive unpackmedia \
/export/nv/solarisdvd.nvxdvd/latest /export/Boot
Where /export/nv/solarisdvd.nvxdvd/latest represents a path
to a Solaris x86 install image and /export/Boot is a direc-
tory 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:
# rootarchive packmedia \
/export/nv/solarisdvd.nvxdvd/latest /export/Boot
EXIT STATUS
The following exit values are returned:
0 The command completed successfully.
1 The command exited due to an error.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 26 Sep 2005 2
System Administration Commands rootarchive(1M)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWcsu
Interface Stability Stable
SEE ALSO
cpio(1), bootadm(1M), mount(1M), attributes(5), lofi(7D)
SunOS 5.11 Last change: 26 Sep 2005 3
|