SDATA Manual Page

     NAME
          sdata - a filter to interpret HP sdata files

     SYNOPSIS
          sdata [-n] [-r] [-b] [-f] [-l] < Input file > Output file

          sdata -?

     DESCRIPTION
          sdata is a filter which displays the contents of an HP sdata
          file (also known as an HP41C data file) in a human-readable
          format. An sdata file consists of a sequence of 8-byte
          records each of which represents an HP41 storage register
          containing either a real number or a 6-character text
          string.  The sdata file is read from standard input and the
          output written to standard output.

          By default, sdata displays numbers with a 10 digit mantissa
          and strings as a sequence of characters surrounded by double
          quotes. See OPTIONS below for other output formats.
          Characters in text strings that are printable ASCII
          characters are output as such, non-printable characters are
          output as \nnn octal escape sequences.

     OPTIONS
          -n   Print the register number at the start of each output
               line.

          -r   Print the register contents as 8 2-digit hexadecimal
               numbers without attempting to interpret them

          -b   Print alpha strings as the sequence of BLDSPEC (an HP41
               printer command) values needed to create them.

          -f   If appropriate, display alpha strings as the settings
               of the first 44 HP41 flags. The string is assumed to
               have been returned by the RCLFLAG command (an extended
               functions command).

          -l   Display 12 digits in the mantissa, not 10, as used on
               the HP71B.

          -?   Print a message giving the program usage to standard
               error.

     REFERENCES
          The sdata file format is documented in sections 11.2.4.2 and
          11.2.7 of the HP71 Software Internal Design Specifications
          Volume More information can be found in the routines RED41C
          (0x13F28) and N-STR (0x14BFC) in the HP71 Software Internal
          Design Specifications Volume (Addresses given are for the
          1BBBB version of the ROM).

     EXAMPLES
          If disk1.lif is a LIF disk image containing an sdata file
          called DATA1 then

          lifget -f disk1.lif DATA1 | sdata

          will produce a register-numbered listing of the data in that
          file to standard output

     BUGS
          The -f flags function has not been fully tested. This
          program may not display non-normalised numbers correctly.
          Some commonly-used HP41C characters are non-printable in
          ASCII, and thus the display of normal HP41C alpha strings
          may look messy

     AUTHOR
          sdata was written by Tony Duell, ard.p850ug1@gmail.com and
          has been placed under the GNU Public License version 2.0