table of contents
srec_cmp(1) | General Commands Manual | srec_cmp(1) |
NAME¶
srec_cmp - compare two EPROM load files for equalitySYNOPSIS¶
srec_cmp [ option... ] filename...DESCRIPTION¶
The srec_cmp program is used to compare two EPROM load files for equality. This comparison is performed irrespective of the load order of the data in each of the files.INPUT FILE SPECIFICATIONS¶
Input may be qualified in two ways: you may specify a data file or a data generator. format and you may specify filters to apply to them. An input file specification looks like this:data‐file [ filter ... ]
data‐generator [ filter ... ]
Data Files¶
Input from data files is specified by file name and format name. An input file specification looks like this:filename [ format ][
-ignore‐checksums ]
The default format is Motorola S‐Record format, but many others
are also understood.
Data Generators¶
It is also possible to generate data, rather than read it from a file. You may use a generator anywhere you could use a file. An input generator specification looks like this:-GENerate address‐range
-data‐source
Generators include random data and various forms of constant data.
Common Manual Page¶
See srec_input(1) for complete details of input specifiers. This description is in a separate manual page because it is common to more than one SRecord command.OPTIONS¶
The following options are understood:- @filename
- The named text file is read for additional command line arguments. Arguments are separated by white space (space, tab, newline, etc). There is no wildcard mechanism. There is no quoting mechanism. Comments, which start with ' #' and extend to the end of the line, are ignored. Blank lines are ignored.
- -Help
-
- -IGnore_Checksums
- The -IGnore‐Checksums option may be used to disable checksum validation of input files, for those formats which have checksums at all. Note that the checksum values are still read in and parsed (so it is still an error if they are missing) but their values are not checked. Used after an input file name, the option affects that file alone; used anywhere else on the command line, it applies to all following files.
- -Enable_Sequence_Warnings
This option may be used to enable warnings about input
files where the data records are not in strictly ascending address order. Only
one warning is issued per input file. This is the default.
Note: the output of srec_cat(1) is always in this order.
Note: This option must be used before the input file. This is
because if there are several files on the command line, each may need
different settings. The setting remains in force until the next
-Disable_Sequence_Warnings option.
- -Disable_Sequence_Warnings
This option may be used to disable warnings about input
files where the data records are not in strictly ascending address order.
Note: This option must be used before the offending input file.
This is because if there are several files on the command line, each may need
different settings. The setting remains in force until the next
-Ensable_Sequence_Warnings option.
- -MULTiple
- Use this option to permit a file to contain multiple (contradictory) values for some memory locations. A warning will be printed. The last value in the file will be used. The default is for this condition to be a fatal error.
- -VERSion
-
- -Verbose
-
EXIT STATUS¶
The srec_cmp command will exit with a status of 1 on any error. The srec_cmp command will only exit with a status of 0 if there are no errors.EXAMPLE¶
A common use for the srec_cmp command is to verify that a particular signature is present in the code. In this example, the signature is in a file called“signature[rq], and the EPROM image is in a file called “image[rq]. We assume they are both Motorola S‐Record format, although this will work for all formats:srec_cmp signature image -crop -within signature
The signature need not be at the start of memory, nor need it be one single
contiguous piece of memory. In the above example, the portions of the image
which have the same address range as the signature are compared with the
signature.
COPYRIGHT¶
srec_cmp version 1.58AUTHOR¶
Peter Miller | E‐Mail: | pmiller@opensource.org.au |
/\/\* | WWW: | http://miller.emu.id.au/pmiller/ |
SRecord | Reference Manual |