copy_boot_tape.1m (2012 03)

c
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
,or copy_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 dev-
ice 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 com-
mand 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.
-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
environment 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
required if the tape contains variable size records, however if the records within a file in the tape are
fixed or are in decreasing order, then the option may be safely ignored to take advantage of the improved
performance. This option is not required to copy tapes created by Ignite-UX.
HP-UX 11i Version 3: March 2012 − 1 − Hewlett-Packard Company 1