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

ms_intro(3).

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).

2006/10/10 Libmseed API