mst_init - Man Page
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
Author
Chad Trabant IRIS Data Management Center
Referenced By
mst_addmsr(3), mst_findmatch(3).
The man pages mst_free(3), mst_freegroup(3) and mst_initgroup(3) are aliases of mst_init(3).