efi_cp(1M)																efi_cp(1M)

NAME

       efi_cp - copy to or from EFI file

SYNOPSIS

       devicefile] file1 file2

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

       devicefile] file_or_dir1 [file_or_dir2]...  dest-directory

DESCRIPTION

       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  option,  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 option to copy from an EFI file system to an  HP-UX  file  system;
       with the option, only a single regular file may be copied at a time.

       With two arguments:

       o If file2 does not exist, creates it and copies the contents of file1 into file2.

       o If file2 exists and is a regular file, deletes the the contents of file2 and copies the contents of file1 into file2.

       o If file2 exists and is a directory, 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 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.

       devicefile     is the device special file of the EFI file system to be copied.  Without the option, uses the device file specified  in  the
		      environment variable if it is defined.  The option overrides the environment variable.

       Recursively copy the subtree rooted at each source directory to
		      the destination directory.

       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 option, only a single regular file may be copied at a time.

RETURN VALUE

       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

       Copy into directory in the EFI file system on the specified device:

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

       Copy into directory in the EFI file system on the specified device and rename it

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

       Copy into of the EFI file system on the device specified in the environment variable and rename it to

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

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

AUTHOR

       was developed by HP.

SEE ALSO

       efi_fsinit(1M), efi_ls(1M), efi_mkdir(1M), efi_rm(1M), efi_rmdir(1M), efi(4), intro(7).

							   Itanium(R)-based Systems Only						efi_cp(1M)