NAME

spatch − Apply binary patches to an image. 

USAGE

spatch [ -ooutput -ppatchfile ] oldfile

DESCRIPTION

spatch is a utility which reads a binary patchfile file, applying the changes to the oldfile, producing an output file, or replacing the oldfile, if -o is not used. 

A binary patchfile is created using the scomp(1) program.  spatch verifies that the patch file format was one generated by a version of scomp which it understands. 

The scomp generated patch files are created such that spatch can verify a change before applying it, by checking for the existence of expected bytes at the patch offsets.  Also spatch verifies expected checksum values and length of the generated output file. 

OPTIONS

−o specify the name of the output file.  If -o is not used, the name of the output file will be the same as the input file with a suffix of .new appended. 

−p specify the name of the patchfile.  If -p is not used, the name of the patchfile will be the oldfile name with a suffix of .pch appended. 

EXAMPLE

spatch -onewfile -pmypatch oldfile
The patch mypatch will be read, and compared with the file oldfile.  Changes will be applied, producing the new file newfile. 

FILES

spatch      SAS/C Cross Platform Patch applyer
scomp       SAS/C Cross Platform Patch generator

RELATED INFORMATION

scomp(1)

NOTES

If the version of the file is not understandable by spatch an error will be generated; however, the patch could be partially applied. 

The output file should not be the same as the input file, because spatch does not retain the entire input file in memory before writing the output. 

COMMENT

The spatch utility is normally used to update the SAS/C Cross Platform software to newer revisions.  In this instance, the patchfiles are supplied by SAS/C Technical Support. 

5.50  —  Last change: SAS/C