Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

applypatch

Install or uninstall a patch (QNX Neutrino)


Note: Since this utility modifies the installation tree, you must run it as a privileged user. It also requires the environment be properly set. On Linux, if you use sudo (as would be the case on Ubuntu), you must also specify the -E option to preserve the environment. In this case, however, the PATH environment variable is set to a safe one for security reasons, so you need to specify the full path to the utility:
sudo -E $QNX_HOST/usr/bin/applypatch patchfile

Syntax:

Install a patch:

applypatch.py [-b] [-c] [-d path] [-F] [-v] patch_file

List the installed patches:

applypatch.py -l

Uninstall a patch:

applypatch.py -U num

Runs on:

QNX Neutrino, Linux, Microsoft Windows

Options:

-b
Don't make a backup.

Caution: If you specify the -b option, you won't be able to uninstall this patch or any patches applied after it. We don't recommend this option for general use.

-c
Extract the patch contents only. No metadata will be recorded, nor will any backup file be generated. This is useful when pulling out individual files for testing, but we don't recommend this option for general use.
-d path
Specify the destination path. This path will be the root directory used for extracting the patch contents as well as for storing the patch metadata. The default is the currently active QNX SDP installation.
-F
Turn off prompting by forcing a “yes” answer to all queries. Normally newer files aren't overwritten by older files from the patch. This option disables that check. This means locally updated files may be silently replaced by an older version from the patch.
-l
List the patches, ordered from newest to oldest (based on installation time).
-v
Be verbose. Display some information on progress and activities.
-U num
Uninstall the patch with the specified ID number, num.

Caution: Due to the nature of the patching process, any patch that was installed after patch ID num will be uninstalled as well. In effect, you'll roll back to the state the system was in just before patch ID num and all subsequent patches were applied.

Description:

The applypatch utility installs and uninstalls QNX patches, and also lists the installed patches. It's installed in $QNX_HOST/usr/bin and supports our current patch tar files.


Note: On Windows, run applypatch in cmd.exe.

This utility first backs up any files which will be overwritten and then extracts the patch files.

If you've applied a sequence of patches, you can uninstall them only in reverse order. If you select a patch (Patch ID X) for uninstallation, then any patches installed since Patch ID X are also marked for uninstallation. A warning and list of affected patches is printed and confirmation requested for this situation.

See also:

tar