efi_cp(1M)                                                       efi_cp(1M)
                   Itanium(R)-Based Processor Family Only



 NAME    [Toc]    [Back]
      efi_cp - copy to or from EFI file

 SYNOPSIS    [Toc]    [Back]
      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    [Toc]    [Back]
      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    [Toc]    [Back]
      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.



 Hewlett-Packard Company            - 1 -      HP-UX 11i Version 2: Sep 2004






 efi_cp(1M)                                                       efi_cp(1M)
                   Itanium(R)-Based Processor Family Only



      -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    [Toc]    [Back]
      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    [Toc]    [Back]
      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 .

 AUTHOR    [Toc]    [Back]
      efi_cp was developed by HP.




 Hewlett-Packard Company            - 2 -      HP-UX 11i Version 2: Sep 2004






 efi_cp(1M)                                                       efi_cp(1M)
                   Itanium(R)-Based Processor Family Only



 FILES    [Toc]    [Back]
      None

 SEE ALSO    [Toc]    [Back]
      efi_fsinit(1M), efi_ls(1M), efi_mkdir(1M), efi_rm(1M), efi_rmdir(1M),
      efi(4).


 Hewlett-Packard Company            - 3 -      HP-UX 11i Version 2: Sep 2004