1srec_cmp(1)                 General Commands Manual                srec_cmp(1)
2
3
4

NAME

6       srec_cmp - compare two EPROM load files for equality
7

SYNOPSIS

9       srec_cmp [ option...  ] filename...
10       srec_cmp -Help
11       srec_cmp -VERSion
12

DESCRIPTION

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

INPUT FILE SPECIFICATIONS

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
25   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
32   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
39   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

OPTIONS

45       The following options are understood:
46
47       @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
54       -Help
55               Provide some help with using the srec_cmp program.
56
57       -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
66       -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
73       -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
78       -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
84       -VERSion
85               Print the version of the srec_cmp program being executed.
86
87       -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
92       All other options will produce a diagnostic error.
93
94       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
98       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
101       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
105       Options  and  other  command line arguments may be mixed arbitrarily on
106       the command line.
107
108       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

EXIT STATUS

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

EXAMPLE

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
134       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

AUTHOR

140       Peter Miller   E‐Mail:   pmiller@opensource.org.au
141       /\/\*             WWW:   http://miller.emu.id.au/pmiller/
142
143
144
145Reference Manual                    SRecord                        srec_cmp(1)
Impressum