MSR_INIT(3)

NAME
msr_init - Initializing and freeing MSRecord and related structures

SYNOPSIS
#include <libmseed.h>
MSRecord *msr_init ( MSRecord *msr );
void      msr_free ( MSRecord **ppmsr );
void      msr_free_blktchain ( MSRecord *msr );

DESCRIPTION
msr_init will initialize a MSRecord structure. If the msr parameter is NULL a new structure will be allocated. If the msr parameter is not NULL the blockette chain (MSRecord.blkts) will be freed but any memory allocated for MSRecord.fsdh and MSRecord.datasamples will be preserved as it will cleanly be re-used by routines such as msr_unpack(3). msr_free will free all memory associated with a MSRecord structure including the blockette chain and set the structure pointer (*ppmsr) to 0. msr_free_blktchain will free all memory associated with the blockette chain of an MSRecord structure. The shortcut blockette pointers will also be reset.

RETURN VALUES
msr_init returns a pointer to the MSRecord structure initialized on success or NULL on error.

SEE ALSO
ms_intro(3), msr_pack(3) and msr_unpack(3).

AUTHOR
Chad Trabant
IRIS Data Management Center