mstl_init - Man Page

Initializing and freeing MSTraceList structures

Synopsis

#include <libmseed.h>

MSTrace      *mstl_init ( MSTrace *mstl );

void          mstl_free ( MSTrace **ppmstl, flag freeprvtptr );

Description

mstl_init will initialize a MSTraceList structure.  If the mstl parameter is not NULL the structure will be cleared before being reallocated any memory allocated for associated MSTraceID and relate sub-structures will be freed.

mstl_free will free all memory associated with a MSTraceList structure and set the structure pointer (*ppmstl) to 0.  If the freeprvtptr flag is true any memory pointed to by the prvtptr members of the MSTraceID or MSTraceSeg structures.

Return Values

mstl_init returns a pointer to the MSTraceList structure initialized on success or NULL on error.

See Also

mstl_addmsr(3).

Author

Chad Trabant
IRIS Data Management Center

Referenced By

mstl_addmsr(3).

The man page mstl_free(3) is an alias of mstl_init(3).

2008/11/21 Libmseed API