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