Content-type: text/html Man page of root_archive

root_archive

Section: System Administration Commands (1M)
Updated: 26 Sep 2005
Index Return to Main Contents
 

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  

DESCRIPTION

The root_archive 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.

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. Specifically, 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

 

EXIT STATUS

The following exit values are returned:

0

The command completed successfully.

1

The command exited due to an error.

 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWcsu
Interface StabilityStable

 

SEE ALSO

cpio(1), bootadm(1M), mount(1M), attributes(5), lofi(7D)


 

Index

NAME
SYNOPSIS
DESCRIPTION
SUBCOMMANDS
EXAMPLES
EXIT STATUS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:07 GMT, October 02, 2010