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

NAME

6       msr_addblockette  -  Add  a  blockette  to  the  blockette  chain of an
7       MSRecord structure
8
9

SYNOPSIS

11       #include <libmseed.h>
12
13       BlktLink  *msr_addblockette ( MSRecord *msr, char *blktdata,
14                                     int length, int blkttype, int chainpos );
15
16

DESCRIPTION

18       msr_addblockette adds a blockette to a blockette chain of  an  MSRecord
19       structure.   The  chainpos  value  controls  which end of the chain the
20       blockette is added to.  If chainpos is 0 the blockette will be added to
21       the  end  of the chain (last blockette), other wise it will be added to
22       the beginning of the chain (first blockette). A blockette chain is com‐
23       posed  of  linked  BlktLink  structures.  A blockette chain for a given
24       MSRecord structure begins at MSRecord.blkts.
25
26       blktdata should be the blockette  body  (no  blockette  type  and  next
27       header) of length bytes and type blkttype.
28
29       Data  structures  for  all SEED 2.4 data blockette types are defined in
30       libmseed.h with these minor exceptions: Blockette 2000 (opaque data) is
31       only partially represented as it has an unknown data structure by defi‐
32       nition and Blockette 405 which depends on full SEED  for  a  full  data
33       description.   It  is  highly  recommended  to  use these provided data
34       structures when adding blockettes as it allows the library  to  manipu‐
35       late the blockette (swap byte order, etc.) and assures SEED 2.4 compat‐
36       ibility.
37
38

RETURN VALUE

40       msr_addblockette returns a pointer to the BlktLink structure  added  to
41       the blockette chain on success or NULL on error.
42
43

SEE ALSO

45       ms_intro(3), msr_pack(3) and msr_unpack(3).
46
47

AUTHOR

49       Chad Trabant
50       IRIS Data Management Center
51
52
53
54Libmseed API                      2006/02/27               MSR_ADDBLOCKETTE(3)
Impressum