DSRW(3)

PACKAGE
dsrw - Routines to read and write a data structure from/to channels

PURPOSE
These routines are meant to provide a mechanism to read and write the recursive, heirarchical data structure supported in Karma from and to open channels. The use of these routines is NOT recommended. The <-dsxfr-> routines are the preferred means of transferring data structures.

LIBRARY
karma

LINK WITH
-lkarma

FUNCTIONS

dsrw_filter_setup
    Set up a Karma data filter.

dsrw_filter_process
    Read in data and write in Karma format.

dsrw_write_multi
    Write a multi_array data structure.

dsrw_write_multi_header
    Write a multi_array data structure header.

dsrw_write_packet_desc
    Write a packet descriptor in binary format.

dsrw_write_element_desc
    Write an element descriptor in binary format.

dsrw_write_array_desc
    Write an array descriptor in binary format.

dsrw_write_dim_desc
    Write a dimension descriptor in binary format.

dsrw_write_history
    Write history information.

dsrw_write_packet
    Write packet data in binary format.

dsrw_write_element
    Write an element in binary format.

dsrw_write_array
    Write an array in binary format.

dsrw_write_list
    Write a linked list in binary format.

dsrw_write_packets
    Write the binary representation of many data packets.

dsrw_write_flag
    Write a boolean value in binary format to a channel object.

dsrw_read_multi
    Read the binary representation of a multi_array structure.

dsrw_read_multi_header
    Read the binary representation of a multi_array header.

dsrw_read_packet_desc
    Read the binary representation of a packet descriptor.

dsrw_read_array_desc
    Read the binary representation of an array descriptor.

dsrw_read_dim_desc
    Read the binary representation of a dimension descriptor.

dsrw_read_packet
    Read the binary representation of a data packet.

dsrw_read_element
    Read the binary representation of an element.

dsrw_read_array
    Read the binary representation of an array.

dsrw_read_list
    Read the binary representation of a linked list.

dsrw_read_packets
    Read the binary representation of many data packets.

dsrw_read_flag
    Read the binary representation of a boolean.

dsrw_read_type
    Read the binary representation of a data type.

dsrw_PROTO_read_func
    Read data and write to a buffer.

AUTHOR
Richard Gooch (rgooch@atnf.csiro.au)

AVAILABLITY
The Karma Distribution is available for anonymous ftp from: ftp://ftp.atnf.csiro.au/pub/software/karma/ ftp://wuarchive.wustl.edu/graphics/graphics/packages/karma/ ftp://ftp.pwr.wroc.pl/pub/karma/ The Karma Home Page is: http://www.atnf.csiro.au/karma/