Ignite-UX Reference (March 2010, B3921-90005)

copy_boot_tape(1M) copy_boot_tape(1M)
NAME
copy_boot_tape − replicate a PA-RISC or HP Integrity boot tape
SYNOPSIS
/opt/ignite/bin/copy_boot_tape −u no_rewind_tape_device
−p no_rewind_tape_device [ -M ][-v ][-? ]
/opt/ignite/bin/copy_boot_tape −u no_rewind_tape_device −d directory [ -M ][-v ][-? ]
/opt/ignite/bin/copy_boot_tape −p no_rewind_tape_device −d directory [ -M ][-v ][-? ]
DESCRIPTION
copy_boot_tape may be used to make a copy of a boot tape created with either
make_tape_recovery, make_boot_tape, make_ipf_tape,orcopy_boot_tape itself.
The first form of the command allows a user to copy from a tape drive to another tape drive or extract the
tape into a directory. The second form of the command allows the user to copy the extracted tape from a
directory back to a tape drive.
If the system has two tape devices, the copy may be performed tape to tape. If there is only one tape device
available, the contents of the tape must be extracted first and then copied back to a new tape. There must be
enough space present for all the contents of the tape to be extracted. The copy_boot_tape command does
not perform any checks to ensure that the filesystem being written to has enough space.
The copy_boot_tape command creates a formatfile while extracting a tape to a filesystem. You
can view the formatfile to verify the contents that have been extracted from a boot tape. When a PA-RISC
tape contents are extracted to disk, the boot area is extracted into a file called file0001 in the target
directory. The archive is extracted into file0002.
When a HP Integrity natively bootable format tape is extracted to disk, there are 23 files extracted (
file0001 through file0023 ) in the target directory. The format for HP Integrity natively bootable
tapes may change in the future however the archive is extracted as file0023.
Options
copy_boot_tape recognizes the following options:
-u no_rewind_tape_device from which to read the recovery tape.
-p no_rewind_tape_device to which to write the recovery tape.
-d Directory to be used for unpacking the contents of the boot tape. There is no default
value for the directory. The user must supply a valid directory with enough free space to
extract the tape successfully.
-M Perform copy_boot_tape operation using the maximum IO block size of 256K. See the
WARNINGS section for additional information about this option.
-v Verbose mode
-? Display the help screen.
International Code Set Support
Ignite-UX uses a variety of system commands to accomplish its functionality. Because the output of many
of these commands is parsed, Ignite-UX ensures that the POSIX locale is normally used by modifying envi-
ronment variables. Help text and some command output not parsed by Ignite-UX will be left in the user’s
specified locale.
RETURN VALUE
copy_boot_tape will exit with a value of 0 (zero) if contents of the tape are successfully extracted and
copied to either another tape or file system, and will exit with a non-zero value if any problem occurred.
WARNINGS
When specifying the directory to extract the tape contents to disk, ensure that the destination directory has
enough space to hold the tape contents.
When the -M option is specified, the performance of copy_boot_tape is impacted. The -M option is
1