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)

NAME | SYNOPSIS | DESCRIPTION | INPUT FILE SPECIFICATIONS | OPTIONS | EXIT STATUS | COPYRIGHT | MAINTAINER

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

home | help