NAME

       mstl_init - 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

Libmseed API                                       2008/11/21                                       MSTL_INIT(3)