[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Commands Reference, Volume 3

inurecv Command

Purpose

Recovers files saved by the inusave command.

Syntax

inurecv ProductName [ OptionList ]

Description

The inurecv command recovers files and archive constituent files saved from a previous inusave command. It uses the update.list and archive.list files from the directory specified by the INUSAVEDIR environment variable. The inurecv command recovers files saved by program-provided installation or update procedures.

The inurecv command is primarily called by the installp -r command and the installp -C command to recover the files for a rejected program or a program that needs to be cleaned up.

The inurecv command is used to recover all the files for an installable program by separate calls to inurecv for the root, /usr and /usr/share file trees. The save directories for the root, /usr, and /usr/share parts of an installation are:

respectively, when set up by the installp command. Level refers to the level of the software product and has the format of vv.rr.mmmm.ffff.ppppppppp, where vv = version, rr = release, mmmm = modification, ffff = fix, and ppppppppp = fix ID (only for 3.2 images).

Parameters

OptionList Specifies the full path name of a stanza file that contains the names of the separately installable options, for example bosnet.tcp.obj, that are to be recovered for the ProductName software product. The option names in the OptionList file must be specified one per line. If OptionList is not specified all options are recovered. The OptionList parameter is only used with AIX Version 3.2 formatted installation or update packages. See the inusave command for a description of the format of OptionList.
ProductName Specifies the installable software product, for example bosnet, whose files are to be recovered.

Environment Variables

INUEXPAND This flag is set to 1 by the installp command if file systems are to be expanded if necessary to do the recover (that is, the -X flag was passed to installp). 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.
INUSAVE This flag is set to 1 by the installp command if files are to be saved (that is, the -N flag was not passed), and otherwise set to 0. The inurecv command attempts to recover files if INUSAVE is set to 1. If INUSAVE is set to 0, inurecv performs no recovery and exits with a return code of INUGOOD. If this environment variable is not set, the default is to attempt to recover files.
INUSAVEDIR The full path name to the directory where files are saved. If this environment variable is not set, then the directory used is /usr/lpp/ProductName/inst_updt.save.
ODMDIR The Object Data Manager object repository where the software vital product data is saved. If this environment variable is not set, the default directory used is /etc/objrepos.

Error Codes

INUBADC1 A copy of a file from one directory to another was unsuccessful.
INUGOOD No error conditions occurred.
INUNORP1 Unsuccessful replacement of a file in an archive file during program recovery.
INUNOSAV The save directory does not exist.
INUNOSVF A file that was saved in the save directory was not found.

Security

Privilege Control: Only the root user can run this command.

Examples

To recover all files previously saved for the snaserv program, enter:

inurecv snaserv

Files

/lpp/PackageName/FilesetName/V.R.M.F.save Files saved for the root file tree.
/usr/lpp/PackageName/FilesetName/V.R.M.F.save Files saved for the /usr file tree.
/usr/share/lpp/PackageName/FilesetName/V.R.M.F.save Files saved for the /usr/share file tree.

Related Information

The installp command, inusave command.


[ Previous | Next | Contents | Glossary | Home | Search ]