Table of Contents

Name

rsf - read a structured file

Synopsis

rsf in=file out=file

Description

rsf reads the ascii representation of a structured binary file (ASF) as generated, for example, by tsf(1NEMO) , and writes a binary version.

In this fashion tsf/rsf can be used to port data between machines of a totally different binary data type (e.g. Cray’s, Sun’s, Convex, DECs, IBMs)

Parameters

The following parameters are recognized; they may be given in any order if the keyword is also given. Use --help to confirm this man page is up to date.
in=file
Input data is read from file, which must be an ascii file.
out=file
Output data is written to file in binary form.

See Also

tsf(1NEMO) , csf(1NEMO) , filestruct(3NEMO) .

Debug

debug=2 reports values of MaxTagLen and MaxVecDim as defined in "filestruct.h". For MaxSetLen see tsf(1NEMO) .

Bugs

rsf does not recognize items which have been truncated by tsf (using the maxlines= keyword). If tsf and rsf are used together, set maxlines to a value large enough to print all the data, or use alllines=t.

Although rsf can now read multiline strings, it can complain on long strings that go accross a line if the line break occured just before a white space in the string. This can be solved by running tsf with a different or long enough linelength (using the margin= keyword).

Bugs

rsf does not recognize decimal numbers, it assumes they are always octal, and does not pay attention to a leading 0 to distinguish. Thereforce, since tsf(1NEMO) now defaults decimal integers by default, it has to be forced to output octal if rsf is part of the pipe to transfer information, e.g.:
    % mkplummer - 3 | tsf - | grep Coord
    int CoordSystem 66306 (good)
    % mkplummer - 3 | tsf - octal=t | grep Coord
    int CoordSystem 0201402 (good)
    % mkplummer - 3 | tsf - | rsf - - | tsf - | grep Coord
    int CoordSystem 27846 (bad)
    % mkplummer - 3 | tsf - octal=t | rsf - - | tsf - | grep Coord
    int CoordSystem 66306 (good)
    

Authors

Joshua E. Barnes, Panayotis Skordos.

History


xx-jun-87    V1.0 first implementation    PS
xx-apr-88    V2.0 new filestruct package    JB
12-sep-90    V2.1 helpvec    PJT
9-dec-90    V2.2 multiline string bug removed    PJT
14-jun-2002    added comment on new tsf behavior for integer output    PJT


Table of Contents