1MST_INIT(3)                Library Functions Manual                MST_INIT(3)
2
3
4

NAME

6       mst_init - Initializing and freeing MSTrace and MSTraceGroup structures
7
8

SYNOPSIS

10       #include <libmseed.h>
11
12       MSTrace      *mst_init ( MSTrace *mst );
13
14       void        mst_free ( MSTrace **ppmst );
15
16       MSTraceGroup *mst_initgroup ( MSTraceGroup *mstg );
17
18       void        mst_freegroup ( MSTraceGroup **ppmstg );
19
20

DESCRIPTION

22       mst_init  will initialize a MSTrace structure.  If the mst parameter is
23       NULL a new structure will be allocated.  If the mst  parameter  is  not
24       NULL  the  structure  will  be cleared and any memory allocated for the
25       MSTrace.datasamples and MSTrace.prvtptr members will be freed.
26
27       mst_free will free all memory associated with a MSTrace  structure  and
28       set  the  structure  pointer  (*ppmst)  to 0.  This includes any memory
29       pointed to by the prvtptr member of the MSTrace structure.
30
31       mst_initgroup will initialize a MSTraceGroup structure.   If  the  mstg
32       parameter  is  NULL  a  new  structure  will be allocated.  If the mstg
33       parameter is not NULL the structure will be cleared and any all associ‐
34       ated MSTrace structures will be freed.
35
36       mst_freegroup  will  free  all  memory  associated  with a MSTraceGroup
37       structure and set the structure pointer (*ppmstg) to 0.
38
39

RETURN VALUES

41       mst_init returns a pointer to the MSTrace structure initialized on suc‐
42       cess or NULL on error.
43
44       mst_initgroup  returns a pointer to the MSTraceGroup structure initial‐
45       ized on success or NULL on error.
46
47

SEE ALSO

49       ms_intro(3).
50
51

AUTHOR

53       Chad Trabant
54       IRIS Data Management Center
55
56
57
58Libmseed API                      2006/10/10                       MST_INIT(3)