NAME

       mst_init - Initializing and freeing MSTrace and MSTraceGroup structures

SYNOPSIS

       #include <libmseed.h>

       MSTrace      *mst_init ( MSTrace *mst );

       void        mst_free ( MSTrace **ppmst );

       MSTraceGroup *mst_initgroup ( MSTraceGroup *mstg );

       void        mst_freegroup ( MSTraceGroup **ppmstg );

DESCRIPTION

       mst_init  will  initialize  a  MSTrace  structure.   If the mst parameter is NULL a new structure will be
       allocated.  If the mst parameter is not NULL the structure will be cleared and any memory  allocated  for
       the MSTrace.datasamples and MSTrace.prvtptr members will be freed.

       mst_free  will free all memory associated with a MSTrace structure and set the structure pointer (*ppmst)
       to 0.  This includes any memory pointed to by the prvtptr member of the MSTrace structure.

       mst_initgroup will initialize a MSTraceGroup structure.  If the mstg parameter is NULL  a  new  structure
       will  be  allocated.   If  the  mstg  parameter  is  not  NULL  the structure will be cleared and any all
       associated MSTrace structures will be freed.

       mst_freegroup will free all memory associated with a MSTraceGroup structure and set the structure pointer
       (*ppmstg) to 0.

RETURN VALUES

       mst_init returns a pointer to the MSTrace structure initialized on success or NULL on error.

       mst_initgroup returns a pointer to the MSTraceGroup structure initialized on success or NULL on error.

SEE ALSO

       ms_intro(3).

AUTHOR

       Chad Trabant
       IRIS Data Management Center