Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
srec_info(1)		    General Commands Manual		  srec_info(1)

NAME
       srec_info - information about EPROM load	files

SYNOPSIS
       srec_info [ option...  ]	filename...
       srec_info -Help
       srec_info -VERSion

DESCRIPTION
       The  srec_info  program is used to obtain input about EPROM load	files.
       It reads	the files specified, and then presents statistics about	 them.
       These  statistics  include: the file header if any, the execution start
       address if any, and the address ranges covered by the data if any.

       If there	is binary data the header, it will be presented	using the  URL
       encoding	 that uses % followed by two hexadeimal	characters.  For exam-
       ple a backspace would be	encoded	as "%08".  (This is symmetric with the
       srec_cat	--header opion).

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	gener-
       ator 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 de-
       scription 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 argu-
	       ments.  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
	       Provide some help with using the	srec_info program.

       -IGnore_Checksums
	       The  -IGnore-Checksums  option  may be used to disable checksum
	       validation of input files, for those formats which have	check-
	       sums  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 un-
	       til 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.

       -redundant-bytes=value
	       Use this	option to permit a file	to  contain  redundant	values
	       for  some  memory locations.  The default is for	this condition
	       to be a warning.

	       ignore
		   No warning or error is issued whena redundant settings  are
		   detected.

	       warning
		   A warning is	issued when a redundant	settings are observed,
		   the warning includes	the problematic	address.

	       error
		   A  fatal  error is issued when a redundant settings are ob-
		   served, the fatal error message  includes  the  problematic
		   address and byte value.

       -contradictory-bytes=value
	       Use  this option	to permit a file to contain contradictory val-
	       ues for some memory locations.  The last	value in the  input(s)
	       will  be	used.  The default is for this condition to be a fatal
	       error.

	       ignore
		   No warning or error is issued when contradictory setting is
		   detected.

	       warning
		   A warning is	issued when a vontradictory settings  are  ob-
		   served,  the	 warning includes the problematic address, and
		   values.

	       error
		   A fatal error is issued when	contradictory settings are ob-
		   served, the fatal error message  includes  the  problematic
		   address and byte values.

       -VERSion
	       Print the version of the	srec_info program being	executed.

       All other options will produce a	diagnostic error.

       All  options  may be abbreviated; the abbreviation is documented	as the
       upper case letters, all lower case letters and underscores (_) are  op-
       tional.	You must use consecutive sequences of optional letters.

       All  options  are  case insensitive, you	may type them in upper case or
       lower case or a combination of both, case is not	important.

       For example: the	arguments "-help", "-HEL" and "-h" are all interpreted
       to mean the -Help option.  The argument "-hlp" will not be  understood,
       because consecutive optional characters were not	supplied.

       Options	and  other  command line arguments may be mixed	arbitrarily on
       the command line.

       The GNU long option names are understood.  Since	all option  names  for
       srec_info  are  long,  this  means ignoring the extra leading "-".  The
       "--option=value"	convention is also understood.

EXIT STATUS
       The srec_info command will exit with a status of	1 on any  error.   The
       srec_info command will only exit	with a status of 0 if there are	no er-
       rors.

COPYRIGHT
       srec_info version 1.64
       Copyright  (C)  1998,  1999,  2000, 2001, 2002, 2003, 2004, 2005, 2006,
       2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 Peter Miller

       The srec_info program comes with	ABSOLUTELY NO  WARRANTY;  for  details
       use  the	 'srec_info  -VERSion License' command.	 This is free software
       and you are welcome to redistribute it under  certain  conditions;  for
       details use the 'srec_info -VERSion License' command.

MAINTAINER
       Scott Finneran	E-Mail:	  scottfinneran@yahoo.com.au
       Peter Miller	E-Mail:	  pmiller@opensource.org.au

Reference Manual		    SRecord			  srec_info(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=srec_info&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help