1srec_info(1) General Commands Manual srec_info(1)
2
3
4
6 srec_info - information about EPROM load files
7
9 srec_info [ option... ] filename...
10 srec_info -Help
11 srec_info -VERSion
12
14 The srec_info program is used to obtain input about EPROM load files.
15 It reads the files specified, and then presents statistics about them.
16 These statistics include: the file header if any, the execution start
17 address if any, and the address ranges covered by the data if any.
18
19 If there is binary data the header, it will be presented using the URL
20 encoding that uses % followed by two hexadeimal characters. For exam‐
21 ple a backspace would be encoded as “%08”. (This is symmetric with the
22 srec_cat ‐‐header opion).
23
25 Input may be qualified in two ways: you may specify a data file or a
26 data generator. format and you may specify filters to apply to them.
27 An input file specification looks like this:
28 data‐file [ filter ... ]
29 data‐generator [ filter ... ]
30
31 Data Files
32 Input from data files is specified by file name and format name. An
33 input file specification looks like this:
34 filename [ format ][ -ignore‐checksums ]
35 The default format is Motorola S‐Record format, but many others are
36 also understood.
37
38 Data Generators
39 It is also possible to generate data, rather than read it from a file.
40 You may use a generator anywhere you could use a file. An input gener‐
41 ator specification looks like this:
42 -GENerate address‐range -data‐source
43 Generators include random data and various forms of constant data.
44
45 Common Manual Page
46 See srec_input(1) for complete details of input specifiers. This
47 description is in a separate manual page because it is common to more
48 than one SRecord command.
49
51 The following options are understood:
52
53 @filename
54 The named text file is read for additional command line argu‐
55 ments. Arguments are separated by white space (space, tab,
56 newline, etc). There is no wildcard mechanism. There is no
57 quoting mechanism. Comments, which start with '#' and extend
58 to the end of the line, are ignored. Blank lines are ignored.
59
60 -Help
61 Provide some help with using the srec_info program.
62
63 -IGnore_Checksums
64 The -IGnore‐Checksums option may be used to disable checksum
65 validation of input files, for those formats which have check‐
66 sums at all. Note that the checksum values are still read in
67 and parsed (so it is still an error if they are missing) but
68 their values are not checked. Used after an input file name,
69 the option affects that file alone; used anywhere else on the
70 command line, it applies to all following files.
71
72 -Enable_Sequence_Warnings
73 This option may be used to enable warnings about input files
74 where the data records are not in strictly ascending address
75 order. Only one warning is issued per input file. This is the
76 default.
77
78 Note: the output of srec_cat(1) is always in this order.
79
80 Note: This option must be used before the input file. This is
81 because if there are several files on the command line, each
82 may need different settings. The setting remains in force
83 until the next -Disable_Sequence_Warnings option.
84
85 -Disable_Sequence_Warnings
86 This option may be used to disable warnings about input files
87 where the data records are not in strictly ascending address
88 order.
89
90 Note: This option must be used before the offending input file.
91 This is because if there are several files on the command line,
92 each may need different settings. The setting remains in force
93 until the next -Ensable_Sequence_Warnings option.
94
95 -redundant‐bytes=value
96 Use this option to permit a file to contain redundant values
97 for some memory locations. The default is for this condition
98 to be a warning.
99
100 ignore
101 No warning or error is issued whena redundant settings are
102 detected.
103
104 warning
105 A warning is issued when a redundant settings are observed,
106 the warning includes the problematic address.
107
108 error
109 A fatal error is issued when a redundant settings are
110 observed, the fatal error message includes the problematic
111 address and byte value.
112
113 -contradictory‐bytes=value
114 Use this option to permit a file to contain contradictory val‐
115 ues for some memory locations. The last value in the input(s)
116 will be used. The default is for this condition to be a fatal
117 error.
118
119 ignore
120 No warning or error is issued when contradictory setting is
121 detected.
122
123 warning
124 A warning is issued when a vontradictory settings are
125 observed, the warning includes the problematic address, and
126 values.
127
128 error
129 A fatal error is issued when contradictory settings are
130 observed, the fatal error message includes the problematic
131 address and byte values.
132
133 -VERSion
134 Print the version of the srec_info program being executed.
135
136 All other options will produce a diagnostic error.
137
138 All options may be abbreviated; the abbreviation is documented as the
139 upper case letters, all lower case letters and underscores (_) are
140 optional. You must use consecutive sequences of optional letters.
141
142 All options are case insensitive, you may type them in upper case or
143 lower case or a combination of both, case is not important.
144
145 For example: the arguments “-help”, “-HEL” and “-h” are all interpreted
146 to mean the -Help option. The argument “-hlp” will not be understood,
147 because consecutive optional characters were not supplied.
148
149 Options and other command line arguments may be mixed arbitrarily on
150 the command line.
151
152 The GNU long option names are understood. Since all option names for
153 srec_info are long, this means ignoring the extra leading “-”. The
154 “--option=value” convention is also understood.
155
157 The srec_info command will exit with a status of 1 on any error. The
158 srec_info command will only exit with a status of 0 if there are no
159 errors.
160
162 srec_info version 1.64
163 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
164 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 Peter Miller
165
166 The srec_info program comes with ABSOLUTELY NO WARRANTY; for details
167 use the 'srec_info -VERSion License' command. This is free software
168 and you are welcome to redistribute it under certain conditions; for
169 details use the 'srec_info -VERSion License' command.
170
172 Scott Finneran E‐Mail: scottfinneran@yahoo.com.au
173 Peter Miller E‐Mail: pmiller@opensource.org.au
174
175
176
177Reference Manual SRecord srec_info(1)