This HTML automatically generated with rman for NEMO
Table of Contents

Name

csf - copy structured file

Synopsis

csf in=in-file out=out-file

Description

csf copies a NEMO structured file. By using the item and select keyword items can be selected by name and/or number. Note that items can currently only be selected from the top level, items within a set can not be selected this way; they are copied as a whole. This is likely to be improved at a later stage. Automatic data-conversion can also be done. By default all items are copied, and no data conversion is applied.

An overview of the top level items that are present in a structured file can be obtained with the following Unix pipe:

q
    % tsf in_file | grep "^[a-z,A-Z]" | grep -v "^tes" | awk ’{print $2}’

Although structured files can always be read when they were created on a byte swapped machine, csf can also be used to create a file in which the bytes are not swapped.

As a convenience option, the keyword blocksize= can be used to forced a fixed blocksize to copy a file "as is", but it will bypass the structured file I/O so should be functionally the same as a unix cp(1) .

Parameters

The following parameters are recognized in order; 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=in-file
Input file, must be in filestruct(5NEMO) format [no default].
out=out-file
Output file, will be in filestruct(5NEMO) format [no default].
item=item-list
List of top level items, separated by comma’s or spaces, to be copied. If none are provided, all items are selected. Note that the item-list will be case sensitive. [default: -blank-].
select=select-list
List of numbers (1 being the first) that are select for copying, after the above mentioned item-name selection (from the item= keyword) has been applied. If none are provided, all are copied. [default: -blank-].
convert=convert-list
List of conversions to make, separated by comma’s or spaces. Each conversion is of the format from2to, where both the from and to part are any of: d (double), f (float), h (half precision) , l (long), i (int) or s (short). [Default: -blank-].
blocksize=
If selected, this is the blocksize, in bytes, by which a file gets copied bypassing NEMO’s structured file I/O. A value of 512 is ok. Default: 0 (not used)
headline=
If supplied, add this string of random verbiage to the data stream. [Default: none]

Caveats

Some of the conversions in convert= are not supported or are in danger of loosing more than just precision.

Examples

An image with too much data-history can be cut by only copying the Image items:
   % csf in=map1.ccd out=map2.ccd select=Image

Bugs

Items can only be selected (select=) from the top level.

See Also

cp(1) , tsf(1NEMO) , rsf(1NEMO)

Author

Peter Teuben, Joshua E. Barnes

Files


~/src/kernel/io      csf.c

History


xx-xxx-87    V1.0: created    JEB
9-dec-89    V1.1 added select keyword    PJT
10-oct-90    V1.3 select= is now item=: select= used for counting    PJT
4-mar-91    V1.4 added data conversion option via convert=        PJT
13-feb-92    documentation added    PJT
26-mar-95    V1.5 fixed selection bug and clarified doc    PJT
12-dec-09    V1.6 added support for half precision (halfp) type    PJT
13-aug-2022    V1.7 add headline=    PJT
19-apr-2023    V1.8 add blocksize=    PJT


Table of Contents