1srec_info(1) General Commands Manual srec_info(1)
2
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
20 Input may be qualified in two ways: you may specify a data file or a
21 data generator. format and you may specify filters to apply to them.
22 An input file specification looks like this:
23 data‐file [ filter ... ]
24 data‐generator [ filter ... ]
25 Data Files
27 Input from data files is specified by file name and format name. An
28 input file specification looks like this:
29 filename [ format ][ -ignore‐checksums ]
30 The default format is Motorola S‐Record format, but many others are
31 also understood.
32 Data Generators
34 It is also possible to generate data, rather than read it from a file.
35 You may use a generator anywhere you could use a file. An input gener‐
36 ator specification looks like this:
37 -GENerate address‐range -data‐source
38 Generators include random data and various forms of constant data.
39 Common Manual Page
41 See srec_input(1) for complete details of input specifiers. This
42 description in a separate manual page because it is common to more than
43 one SRecord command.
44
46 The following options are understood:
47 @filename
49 The named text file is read for additional command line argu‐
50 ments. Arguments are separated by white space (space, tab,
51 newline, etc). There is no wildcard mechanism. There is no
52 quoting mechanism. Comments, which start with '#' and extend
53 to the end of the line, are ignored. Blank lines are ignored.
54 -Help
56 Provide some help with using the srec_info program.
57 -IGnore_Checksums
59 The -ignore‐checksums option may be used to disable checksum
60 validation of input files, for those formats which have check‐
61 sums at all. Note that the checksum values are still read in
62 and parsed (so it is still an error if they are missing) but
63 their values are not checked. Used after an input file name,
64 the option affects that file alone; used anywhere else on the
65 command line, it applies to all following files.
66 -Enable_Sequence_Warnings
68 This option may be used to enable warnings about input files
69 where the data records are not in strictly ascending address
70 order. Only one warning is issued per input. This is the
71 default. Note: the output of srec_cat(1) is always in this
72 order.
73 -Disable_Sequence_Warnings
75 This option may be used to disable warnings about input files
76 where the data records are not in stricyly ascending address
77 order.
78 -MULTiple
80 Use this option to permit a file to contain multiple (contra‐
81 dictory) values for some memory locations. A warning will be
82 printed. The last value in the file will be used. The default
83 is for this condition to be a fatal error.
84 -VERSion
86 Print the version of the srec_info program being executed.
87 All other options will produce a diagnostic error.
89 All options may be abbreviated; the abbreviation is documented as the
91 upper case letters, all lower case letters and underscores (_) are
92 optional. You must use consecutive sequences of optional letters.
93 All options are case insensitive, you may type them in upper case or
95 lower case or a combination of both, case is not important.
96 For example: the arguments “-help”, “-HEL” and “-h” are all interpreted
98 to mean the -Help option. The argument “-hlp” will not be understood,
99 because consecutive optional characters were not supplied.
100 Options and other command line arguments may be mixed arbitrarily on
102 the command line.
103 The GNU long option names are understood. Since all option names for
105 srec_info are long, this means ignoring the extra leading “-”. The
106 “--option=value” convention is also understood.
107
109 The srec_info command will exit with a status of 1 on any error. The
110 srec_info command will only exit with a status of 0 if there are no
111 errors.
112
114 srec_info version 1.55
115 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
116 2007, 2008, 2009, 2010 Peter Miller
117 The srec_info program comes with ABSOLUTELY NO WARRANTY; for details
119 use the 'srec_info -VERSion License' command. This is free software
120 and you are welcome to redistribute it under certain conditions; for
121 details use the 'srec_info -VERSion License' command.
122
124 Peter Miller E‐Mail: pmiller@opensource.org.au
125 /\/\* WWW: http://miller.emu.id.au/pmiller/
126Reference Manual SRecord srec_info(1)