inucp Command

Purpose

Performs simple copy operations for the installp command. This command is used by the installp command and the install scripts.

Syntax

inucp -s StartDirectory [ -e FinalDirectory ] ListFile ProductName

Description

The inucp command copies the files in a file tree with its root at StartDirectory to the appropriate place on the FinalDirectory root.

Before replacing files that may already exist in the FinalDirectory file tree, the inusave command should be called to save the files until needed by the inurecv command.

The ListFile parameter specifies a list, one per line, of all the files for ProductName. ListFile is the full path name of the file that contains the relative path names of files that the product needs to have copied.

The ProductName parameter specifies the name of the software product to be copied.

Flags

Item	Description
-e FinalDirectory	Indicates the root of the file tree that the files are to be copied to. The FinalDirectory should be the base of the file tree. The default directory is the / (root) directory when this flag is not specified.
-s StartDirectory	Indicates the root of the file tree that the files are to be copied from.

Environment Variables

Item	Description
INUEXPAND	This flag is set to 1 by the installp command if file systems are to be expanded if necessary to do the copy (that is, the -X flag was passed). It is set to 0 if file systems are not to be expanded. If this environment variable is not set, the default is not to expand file systems.
INUTEMPDIR	This flag is set by the installp command to the path of the current temporary directory. If this flag is not set the default is /tmp.

Error Codes

The inucp command returns the following error codes, which are defined in inuerr.h.

Item	Description
INUACCS	One or both of StartDirectory and FinalDirectory are not directories.
INUBADAR	Could not archive files in lpp.acf file.
INUBADC1	The copy operation failed.
INUBADMN	Unrecognizable flag specified.
INUGOOD	No error conditions occurred.
INUNOAP2	Could not access the ListFile.
INUNODIR	No write access to FinalDirectory.
INUNOLPP	One or both of StartDirectory and FinalDirectory do not have the necessary permissions.
INUNOMK	Could not create a needed directory.
INUNOSPC	Insufficient space for the copy and INUEXPAND was not set.
INUTOOFW	One or more parameters were missing.
INUTOOMN	Too many parameters were specified.

Security

Privilege Control: You must be the root user to run this command.

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in AIX® Version 7.1 Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

To copy all the files listed in the /usr/lpp/X11/inst_root/al list from the /usr/lpp/X11/inst_root file tree to the root directory, enter:

inucp -s /usr/lpp/X11/inst_root /usr/lpp/X11/inst_root/al X11