sdata

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
REFERENCES
EXAMPLES
BUGS
AUTHOR

NAME

sdata - a filter to interpret raw 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 raw 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 1 (Hewlett-Packard). More information can be found in the routines RED41C (0x13F28) and N-STR (0x14BFC) in the HP71 Software Internal Design Specifications Volume 3 (Hewlett-Packard). (Addresses given are for the 1BBBB version of the ROM).

EXAMPLES

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

lifget -r disk1.dat DATA1 | sdata -n

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.demon.co.uk and has been placed under the GNU Public License version 2.0