1srec_cmp(1) General Commands Manual srec_cmp(1)
2
6 srec_cmp - compare two EPROM load files for equality
7
9 srec_cmp [ option... ] filename...
10 srec_cmp -Help
11 srec_cmp -VERSion
12
14 The srec_cmp program is used to compare two EPROM load files for equal‐
15 ity. This comparison is performed irrespective of the load order of
16 the data in each of the files.
17
19 Input may be qualified in two ways: you may specify a data file or a
20 data generator. format and you may specify filters to apply to them.
21 An input file specification looks like this:
22 data‐file [ filter ... ]
23 data‐generator [ filter ... ]
24 Data Files
26 Input from data files is specified by file name and format name. An
27 input file specification looks like this:
28 filename [ format ][ -ignore‐checksums ]
29 The default format is Motorola S‐Record format, but many others are
30 also understood.
31 Data Generators
33 It is also possible to generate data, rather than read it from a file.
34 You may use a generator anywhere you could use a file. An input gener‐
35 ator specification looks like this:
36 -GENerate address‐range -data‐source
37 Generators include random data and various forms of constant data.
38 Common Manual Page
40 See srec_input(1) for complete details of input specifiers. This
41 description in a separate manual page because it is common to more than
42 one SRecord command.
43
45 The following options are understood:
46 @filename
48 The named text file is read for additional command line argu‐
49 ments. Arguments are separated by white space (space, tab,
50 newline, etc). There is no wildcard mechanism. There is no
51 quoting mechanism. Comments, which start with '#' and extend
52 to the end of the line, are ignored. Blank lines are ignored.
53 -Help
55 Provide some help with using the srec_cmp program.
56 -IGnore_Checksums
58 The -ignore‐checksums option may be used to disable checksum
59 validation of input files, for those formats which have check‐
60 sums at all. Note that the checksum values are still read in
61 and parsed (so it is still an error if they are missing) but
62 their values are not checked. Used after an input file name,
63 the option affects that file alone; used anywhere else on the
64 command line, it applies to all following files.
65 -Enable_Sequence_Warnings
67 This option may be used to enable warnings about input files
68 where the data records are not in strictly ascending address
69 order. Only one warning is issued per input. This is the
70 default. Note: the output of srec_cat(1) is always in this
71 order.
72 -Disable_Sequence_Warnings
74 This option may be used to disable warnings about input files
75 where the data records are not in stricyly ascending address
76 order.
77 -MULTiple
79 Use this option to permit a file to contain multiple (contra‐
80 dictory) values for some memory locations. A warning will be
81 printed. The last value in the file will be used. The default
82 is for this condition to be a fatal error.
83 -VERSion
85 Print the version of the srec_cmp program being executed.
86 -Verbose
88 This option may be used to obtain more information about how
89 and where the two files differ. Please note that this takes
90 longer, and the output can be voluminous.
91 All other options will produce a diagnostic error.
93 All options may be abbreviated; the abbreviation is documented as the
95 upper case letters, all lower case letters and underscores (_) are
96 optional. You must use consecutive sequences of optional letters.
97 All options are case insensitive, you may type them in upper case or
99 lower case or a combination of both, case is not important.
100 For example: the arguments “-help”, “-HEL” and “-h” are all interpreted
102 to mean the -Help option. The argument “-hlp” will not be understood,
103 because consecutive optional characters were not supplied.
104 Options and other command line arguments may be mixed arbitrarily on
106 the command line.
107 The GNU long option names are understood. Since all option names for
109 srec_cmp are long, this means ignoring the extra leading “-”. The
110 “--option=value” convention is also understood.
111
113 The srec_cmp command will exit with a status of 1 on any error. The
114 srec_cmp command will only exit with a status of 0 if there are no
115 errors.
116
118 A common use for the srec_cmp command is to verify that a particular
119 signature is present in the code. In this example, the signature is in
120 a file called“signature[rq], and the EPROM image is in a file called
121 “image[rq]. We assume they are both Motorola S‐Record format, although
122 this will work for all formats:
123 srec_cmp signature image -crop -within signature
124 The signature need not be at the start of memory, nor need it be one
125 single contiguous piece of memory. In the above example, the portions
126 of the image which have the same address range as the signature are
127 compared with the signature.
128
130 srec_cmp version 1.55
131 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
132 2007, 2008, 2009, 2010 Peter Miller
133 The srec_cmp program comes with ABSOLUTELY NO WARRANTY; for details use
135 the 'srec_cmp -VERSion License' command. This is free software and you
136 are welcome to redistribute it under certain conditions; for details
137 use the 'srec_cmp -VERSion License' command.
138
140 Peter Miller E‐Mail: pmiller@opensource.org.au
141 /\/\* WWW: http://miller.emu.id.au/pmiller/
142Reference Manual SRecord srec_cmp(1)