Home Page The Club Computers News Links Glossary EYAWTK
Before Amiga Background ICS OCS ECS AGA ??? PPC
U-Boot SLB Linux Amiga OS Dual Boot Motherboards Peripherals Other
Initialisation Installation OS4 Updates About OS4 File Systems Networking Printing Other
Introduction File System Workbench Preferences Commands Error Msgs Miscellaneous

AmigaOS 4.0 - About OS4 - Commands

SETPATCH AmigaDOS
Purpose: Makes patches to the system software.
Format: SETPATCH
Template: QUIET/S, NOAGA/S, NONSD/S, PCF=PATCHCONFIGFILE/K, PCL=PATCHCONFIGLINE/K, PI=PATCHINFO/S, WAITFORVALIDATE/S
Path: C:SETPATCH
SETPATCH installs temporary modifications to the operating system. It must be run at the beginning of the Startup-sequence file. Updated versions of SETPATCH are made available when necessary as AmigaDOS development continues.

When run from a Shell with no parameters, the current SetPatch status is displayed.

By default, SETPATCH displays the operating system version and copyright as well as the list of applied patches. But if the QUIET option is specified or the local shell variable _Verbosity has a negative value, no output will be produced.

By default SETPATCH enables the AGA video modes on the Amiga Classic. If you don't want to enable them specify the NOAGA option on the command line. Note: AGA modes are always disabled on the AmigaOne platform.

SETPATCH can patch devices that don't follow the NewStyleDevice (NSD) specification released by Amiga Inc. Patches will be applied according to the list in the Devs:NSDPatch.cfg file. Use the NONSD option if you don't want to install patches for devices that are not NSD compliant.

To use a device list other than Devs:NSDPatch.cfg, use the PATCHCONFIGFILE argument and specify the full name of your alternate file.

It is also possible to apply a patch giving it as argument to SETPATCH after the PATCHCONFIGLINE keyword. Just specify a line with the same syntax as in the NSDpatch file. Note that a complete description of the patch format is located into the Devs:NSDPatch.cfg file.

To display the patches applied by SETPATCH, use the PATCHINFO argument.

When a disk is validating (after a system crash for example), it can be annoying to boot the operating system while the filesystem is busy to fix the damaged partition. In this case, the boot process may be very slow. Use the WAITFORVALIDATE option to ask SETPATCH to wait for the end of the validation process before proceeding. Doing so you are sure that you start the system with sane partitions.

Example 1:

3.OS4:> SETPATCH
AMIGA ROM Operating System and Libraries
Copyright (C) 1985-2005 Hyperion Entertainment VOF and Amiga, Inc.
All Rights Reserved.

SetPatch (V51.4) has already been installed.  Patch list:
        None.
SetPatch is mapping serial.device/0 to a1serial.device/0
SetPatch is mapping serial.device/1 to a1serial.device/1
Example 2:

3.OS4:> SETPATCH NONSD WAITFORVALIDATE QUIET Doesn't apply NSD patches and waits until the end of the validation process.

Example 3:

3.OS4:> SETPATCH PATCHCONFIGLINE="DEVICE audio.device DEVICETYPE NSDEVTYPE_AUDIO VERSION 50 REVISION 5 ISNSD QUIET" Applies only the patch on audio.device.


Return to Commands Selection

Disclaimer: Amiga Auckland have prepared the above information for the use of its members based on our experiences and as such is subject to revision at any time. Amiga Auckland cannot guarantee any of the information and cannot be held accountable for any issues that may result from using it.


Copyright 2006 Amiga Auckland Inc. All rights reserved.
Revised: February 9, 2006.