efi_cp(1M)

NAME

efi_cp — copy to or from EFI file

SYNOPSIS

efi_cp [-d devicefile] [-u] file1 file2

efi_cp [-d devicefile] file1 [file2]... dest-directory

efi_cp [-d devicefile] -r file_or_dir1 [file_or_dir2]... dest-directory

DESCRIPTION

efi_cp copies files between HP-UX and EFI file systems.

The EFI file system is based on the FAT file system and used by the Itanium-based system BIOS to locate an HP-UX bootloader. See efi(4).

Without the -u option, efi_cp copies from an HP-UX file system to the EFI volume specified by devicefile; in this case, the destination should be relative to the root of the EFI volume specified by devicefile. Use the -u option to copy from an EFI file system to an HP-UX file system; with the -u option, only a single regular file may be copied at a time.

With two arguments:

If file2 does not exist, efi_cp creates it and copies the contents of file1 into file2.
If file2 exists and is a regular file, efi_cp deletes the the contents of file2 and copies the contents of file1 into file2.
If file2 exists and is a directory, efi_cp creates a copy of file1 in that directory.

With more than two arguments, the final argument must be an existing directory. If any of the other arguments is a directory, you must use the -r option, which specifies that the source directory and the subtree rooted there are to be copied to the destination directory.

Options

Options can be used singly or combined in any order before the file names. The space between option and argument is optional.

-d devicefile: devicefile is the device special file of the EFI file system to be copied. Without the -d option, efi_cp uses the device file specified in the environment variable EFI_PARTITION if it is defined. The -d option overrides the EFI_PARTITION environment variable.
-r: Recursively copy the subtree rooted at each source directory to the destination directory.
-u: Copy file1 from an EFI volume to file2 in HP-UX file system. file1 should be relative to the root of the EFI volume specified by devicefile, not to an HP-UX file system. With the -u option, only a single regular file may be copied at a time.

RETURN VALUE

efi_cp returns exit code 0 if the copy is successful. Otherwise it prints a diagnostic message and returns nonzero.

0: Successful completion.
>0: Error condition occurred.

EXAMPLES

All the following examples copy to or from the EFI file system on device /dev/rdsk/c1t4d0s1.

Copy bootprogram into directory /abc/def in the EFI file system on the specified device:

efi_cp -d /dev/rdsk/c1t4d0s1 bootprogram /abc/def/

Copy all files in current directory into directory /abc/def/ in the EFI file system on the specified device

efi_cp -d /dev/rdsk/c1t4d0s1 * /abc/def/

Copy bootprogram into directory /abc/def/ in the EFI file system on the specified device and rename it boot1:

efi_cp -d /dev/rdsk/c1t4d0s1 bootprogram /abc/dev/boot1

Copy bootloader into the EFI boot directory of the EFI file system on the specified device:

efi_cp -d /dev/rdsk/c1t4d0s1 bootloader /EFI/HPUX

Copy bootloader into /EFI/HPUX/ of the EFI file system on the device specified in the EFI_PARTITION environment variable and rename it to hpux.efi:

efi_cp bootloader /EFI/HPUX/hpux.efi

Copy /EFI/HPUX/AUTO from the EFI file system on the specified device into the current HP-UX directory:

efi_cp -d /dev/rdsk/c1t4d0s1 -u /EFI/HPUX/AUTO .

Using a persistent device special file (dsf) copy /EFI/HPUX/AUTO from the EFI file system on the specified device into the current HP-UX directory (see intro(7)):

efi_cp -d /dev/rdisk/disk7_p1 -u /EFI/HPUX/AUTO .

AUTHOR

efi_cp was developed by HP.

efi_cp(1M)

Technical documentation

» Table of Contents

» Index