libmseed 3.1.6
The miniSEED data format library
Loading...
Searching...
No Matches
libmseed.h
Go to the documentation of this file.
1/**********************************************************************/
23
24#ifndef LIBMSEED_H
25#define LIBMSEED_H 1
26
27#ifdef __cplusplus
28extern "C" {
29#endif
30
31#define LIBMSEED_VERSION "3.1.6"
32#define LIBMSEED_RELEASE "2025.207"
33
45
58
59/* C99 standard headers */
60#include <stdlib.h>
61#include <stdio.h>
62#include <stdarg.h>
63#include <time.h>
64#include <string.h>
65#include <ctype.h>
66#include <math.h>
67
70#define PRIsize_t "zu"
71
72#if defined(WIN32) || defined(_WIN32) || defined(WIN64) || defined(_WIN64)
73 #define LMP_WIN 1
74#endif
75
76/* Set platform specific features, Windows versus everything else */
77#if defined(LMP_WIN)
78 #include <windows.h>
79 #include <sys/types.h>
80 #include <sys/timeb.h>
81
82 /* Re-define print conversion for size_t values */
83 #undef PRIsize_t
84 #if defined(WIN64) || defined(_WIN64)
85 #define PRIsize_t "I64u"
86 #else
87 #define PRIsize_t "I32u"
88 #endif
89
90 /* For MSVC 2012 and earlier define standard int types, otherwise use inttypes.h */
91 #if defined(_MSC_VER) && _MSC_VER <= 1700
92 typedef signed char int8_t;
93 typedef unsigned char uint8_t;
94 typedef signed short int int16_t;
95 typedef unsigned short int uint16_t;
96 typedef signed int int32_t;
97 typedef unsigned int uint32_t;
98 typedef signed __int64 int64_t;
99 typedef unsigned __int64 uint64_t;
100 #else
101 #include <inttypes.h>
102 #endif
103
104 /* For MSVC define PRId64 and SCNd64 and alternate functions */
105 #if defined(_MSC_VER)
106 #if !defined(PRId64)
107 #define PRId64 "I64d"
108 #endif
109 #if !defined(SCNd64)
110 #define SCNd64 "I64d"
111 #endif
112
113 #define snprintf _snprintf
114 #define vsnprintf _vsnprintf
115 #define strcasecmp _stricmp
116 #define strncasecmp _strnicmp
117 #define strtoull _strtoui64
118 #define fileno _fileno
119 #define fdopen _fdopen
120 #endif
121
122 /* Extras needed for MinGW */
123 #if defined(__MINGW32__) || defined(__MINGW64__)
124 #include <fcntl.h>
125
126 #define _fseeki64 fseeko64
127 #define _ftelli64 ftello64
128
129 #define fstat _fstat
130 #define stat _stat
131 #endif
132#else
133 /* All other platforms */
134 #include <inttypes.h>
135 #include <sys/time.h>
136#endif
137
138#define MINRECLEN 40
139#define MAXRECLEN 10485760
140#define MAXRECLENv2 131172
141
142#define LM_SIDLEN 64
143
146#define MS_ISRATETOLERABLE(A,B) (fabs (1.0 - ((A) / (B))) < 0.0001)
147
150#define MS2_ISDATAINDICATOR(X) ((X)=='D' || (X)=='R' || (X)=='Q' || (X)=='M')
151
168#define MS3_ISVALIDHEADER(X) ( \
169 *(X) == 'M' && *((X) + 1) == 'S' && *((X) + 2) == 3 && \
170 (uint8_t) (*((X) + 12)) >= 0 && (uint8_t) (*((X) + 12)) <= 23 && \
171 (uint8_t) (*((X) + 13)) >= 0 && (uint8_t) (*((X) + 13)) <= 59 && \
172 (uint8_t) (*((X) + 14)) >= 0 && (uint8_t) (*((X) + 14)) <= 60)
173
190#define MS2_ISVALIDHEADER(X) ( \
191 (isdigit ((uint8_t) * (X)) || *(X) == ' ' || !*(X)) && \
192 (isdigit ((uint8_t) * ((X) + 1)) || *((X) + 1) == ' ' || !*((X) + 1)) && \
193 (isdigit ((uint8_t) * ((X) + 2)) || *((X) + 2) == ' ' || !*((X) + 2)) && \
194 (isdigit ((uint8_t) * ((X) + 3)) || *((X) + 3) == ' ' || !*((X) + 3)) && \
195 (isdigit ((uint8_t) * ((X) + 4)) || *((X) + 4) == ' ' || !*((X) + 4)) && \
196 (isdigit ((uint8_t) * ((X) + 5)) || *((X) + 5) == ' ' || !*((X) + 5)) && \
197 MS2_ISDATAINDICATOR (*((X) + 6)) && \
198 (*((X) + 7) == ' ' || *((X) + 7) == '\0') && \
199 (uint8_t) (*((X) + 24)) >= 0 && (uint8_t) (*((X) + 24)) <= 23 && \
200 (uint8_t) (*((X) + 25)) >= 0 && (uint8_t) (*((X) + 25)) <= 59 && \
201 (uint8_t) (*((X) + 26)) >= 0 && (uint8_t) (*((X) + 26)) <= 60)
202
204#define bit(x,y) ((x)&(y)) ? 1 : 0
205
207#ifdef _MSC_VER
208#define DEPRECATED __declspec(deprecated)
209#elif defined(__GNUC__) | defined(__clang__)
210#define DEPRECATED __attribute__((__deprecated__))
211#else
212#define DEPRECATED
213#endif
214
222
227typedef int64_t nstime_t;
228
232#define NSTMODULUS 1000000000
233
237#define NSTERROR -2145916800000000000LL
238
242#define NSTUNSET -2145916799999999999LL
243
246#define MS_EPOCH2NSTIME(X) (X) * (nstime_t) NSTMODULUS
247
250#define MS_NSTIME2EPOCH(X) (X) / NSTMODULUS
251
259#define MS_HPTIME2NSTIME(X) (X) * (nstime_t) 1000
260
268#define MS_NSTIME2HPTIME(X) (X) / 1000
269
284typedef enum
285{
286 ISOMONTHDAY = 0,
287 ISOMONTHDAY_Z = 1,
288 ISOMONTHDAY_DOY = 2,
289 ISOMONTHDAY_DOY_Z = 3,
290 ISOMONTHDAY_SPACE = 4,
291 ISOMONTHDAY_SPACE_Z = 5,
292 SEEDORDINAL = 6,
293 UNIXEPOCH = 7,
294 NANOSECONDEPOCH = 8
295} ms_timeformat_t;
296
309typedef enum
310{
311 NONE = 0,
312 MICRO = 1,
313 NANO = 2,
314 MICRO_NONE = 3,
315 NANO_NONE = 4,
316 NANO_MICRO = 5,
317 NANO_MICRO_NONE = 6
318} ms_subseconds_t;
319
320extern int ms_nstime2time (nstime_t nstime, uint16_t *year, uint16_t *yday,
321 uint8_t *hour, uint8_t *min, uint8_t *sec, uint32_t *nsec);
322extern char* ms_nstime2timestr (nstime_t nstime, char *timestr,
323 ms_timeformat_t timeformat, ms_subseconds_t subsecond);
324DEPRECATED extern char* ms_nstime2timestrz (nstime_t nstime, char *timestr,
325 ms_timeformat_t timeformat, ms_subseconds_t subsecond);
326extern nstime_t ms_time2nstime (int year, int yday, int hour, int min, int sec, uint32_t nsec);
327extern nstime_t ms_timestr2nstime (const char *timestr);
328extern nstime_t ms_mdtimestr2nstime (const char *timestr);
329extern nstime_t ms_seedtimestr2nstime (const char *seedtimestr);
330extern int ms_doy2md (int year, int yday, int *month, int *mday);
331extern int ms_md2doy (int year, int month, int mday, int *yday);
332
334
344
348#define MS_PACK_DEFAULT_RECLEN 4096
349
353#define MS_PACK_DEFAULT_ENCODING DE_STEIM2
354
358
360typedef struct MS3Record {
361 const char *record;
362 int32_t reclen;
363 uint8_t swapflag;
364
365 /* Common header fields in accessible form */
366 char sid[LM_SIDLEN];
367 uint8_t formatversion;
368 uint8_t flags;
369 nstime_t starttime;
370 double samprate;
371 int16_t encoding;
372 uint8_t pubversion;
373 int64_t samplecnt;
374 uint32_t crc;
375 uint16_t extralength;
376 uint32_t datalength;
377 char *extra;
378
379 /* Data sample fields */
380 void *datasamples;
381 uint64_t datasize;
382 int64_t numsamples;
383 char sampletype;
384} MS3Record;
385
388#define MS3Record_INITIALIZER \
389{ \
390 .record = NULL, \
391 .reclen = -1, \
392 .swapflag = 0, \
393 .sid = {0}, \
394 .formatversion = 0, \
395 .flags = 0, \
396 .starttime = NSTUNSET, \
397 .samprate = 0.0, \
398 .encoding = -1, \
399 .pubversion = 0, \
400 .samplecnt = -1, \
401 .crc = 0, \
402 .extralength = 0, \
403 .datalength = 0, \
404 .extra = NULL, \
405 .datasamples = NULL, \
406 .datasize = 0, \
407 .numsamples = 0, \
408 .sampletype = 0 \
409}
410
411extern int msr3_parse (const char *record, uint64_t recbuflen, MS3Record **ppmsr,
412 uint32_t flags, int8_t verbose);
413
414extern int msr3_pack (const MS3Record *msr,
415 void (*record_handler) (char *, int, void *),
416 void *handlerdata, int64_t *packedsamples,
417 uint32_t flags, int8_t verbose);
418
419extern int msr3_repack_mseed3 (const MS3Record *msr, char *record, uint32_t recbuflen, int8_t verbose);
420
421extern int msr3_repack_mseed2 (const MS3Record *msr, char *record, uint32_t recbuflen, int8_t verbose);
422
423extern int msr3_pack_header3 (const MS3Record *msr, char *record, uint32_t recbuflen, int8_t verbose);
424
425extern int msr3_pack_header2 (const MS3Record *msr, char *record, uint32_t recbuflen, int8_t verbose);
426
427extern int64_t msr3_unpack_data (MS3Record *msr, int8_t verbose);
428
429extern int msr3_data_bounds (const MS3Record *msr, uint32_t *dataoffset, uint32_t *datasize);
430
431extern int64_t ms_decode_data (const void *input, uint64_t inputsize, uint8_t encoding,
432 uint64_t samplecount, void *output, uint64_t outputsize,
433 char *sampletype, int8_t swapflag, const char *sid, int8_t verbose);
434
435extern MS3Record* msr3_init (MS3Record *msr);
436extern void msr3_free (MS3Record **ppmsr);
437extern MS3Record* msr3_duplicate (const MS3Record *msr, int8_t datadup);
438extern nstime_t msr3_endtime (const MS3Record *msr);
439extern void msr3_print (const MS3Record *msr, int8_t details);
440extern int msr3_resize_buffer (MS3Record *msr);
441extern double msr3_sampratehz (const MS3Record *msr);
442extern nstime_t msr3_nsperiod (const MS3Record *msr);
443extern double msr3_host_latency (const MS3Record *msr);
444
445extern int64_t ms3_detect (const char *record, uint64_t recbuflen, uint8_t *formatversion);
446extern int ms_parse_raw3 (const char *record, int maxreclen, int8_t details);
447extern int ms_parse_raw2 (const char *record, int maxreclen, int8_t details, int8_t swapflag);
449
465
472
480
481extern const MS3Selections* ms3_matchselect (const MS3Selections *selections, const char *sid,
482 nstime_t starttime, nstime_t endtime,
483 int pubversion, const MS3SelectTime **ppselecttime);
484extern const MS3Selections* msr3_matchselect (const MS3Selections *selections, const MS3Record *msr,
485 const MS3SelectTime **ppselecttime);
486extern int ms3_addselect (MS3Selections **ppselections, const char *sidpattern,
487 nstime_t starttime, nstime_t endtime, uint8_t pubversion);
488extern int ms3_addselect_comp (MS3Selections **ppselections,
489 char *network, char* station, char *location, char *channel,
490 nstime_t starttime, nstime_t endtime, uint8_t pubversion);
491extern int ms3_readselectionsfile (MS3Selections **ppselections, const char *filename);
492extern void ms3_freeselections (MS3Selections *selections);
493extern void ms3_printselections (const MS3Selections *selections);
495
498
521typedef struct MS3RecordPtr
522{
523 const char *bufferptr;
524 FILE *fileptr;
525 const char *filename;
526 int64_t fileoffset;
527 MS3Record *msr;
528 nstime_t endtime;
529 uint32_t dataoffset;
530 void *prvtptr;
531 struct MS3RecordPtr *next;
532} MS3RecordPtr;
533
541
543
574
576#define MSTRACEID_SKIPLIST_HEIGHT 8
577
593
607
609typedef struct MS3TraceList {
610 uint32_t numtraceids;
611 struct MS3TraceID traces;
612 uint64_t prngstate;
613} MS3TraceList;
614
640typedef struct MS3Tolerance
641{
642 double (*time) (const MS3Record *msr);
643 double (*samprate) (const MS3Record *msr);
644} MS3Tolerance;
645
648#define MS3Tolerance_INITIALIZER \
649 { \
650 .time = NULL, .samprate = NULL \
651 }
652
653extern MS3TraceList* mstl3_init (MS3TraceList *mstl);
654extern void mstl3_free (MS3TraceList **ppmstl, int8_t freeprvtptr);
655extern MS3TraceID* mstl3_findID (MS3TraceList *mstl, const char *sid, uint8_t pubversion, MS3TraceID **prev);
656
659#define mstl3_addmsr(mstl, msr, splitversion, autoheal, flags, tolerance) \
660 mstl3_addmsr_recordptr (mstl, msr, NULL, splitversion, autoheal, flags, tolerance)
661
662extern MS3TraceSeg* mstl3_addmsr_recordptr (MS3TraceList *mstl, const MS3Record *msr, MS3RecordPtr **pprecptr,
663 int8_t splitversion, int8_t autoheal, uint32_t flags,
664 const MS3Tolerance *tolerance);
665extern int64_t mstl3_readbuffer (MS3TraceList **ppmstl, const char *buffer, uint64_t bufferlength,
666 int8_t splitversion, uint32_t flags,
667 const MS3Tolerance *tolerance, int8_t verbose);
668extern int64_t mstl3_readbuffer_selection (MS3TraceList **ppmstl, const char *buffer, uint64_t bufferlength,
669 int8_t splitversion, uint32_t flags,
670 const MS3Tolerance *tolerance, const MS3Selections *selections,
671 int8_t verbose);
672extern int64_t mstl3_unpack_recordlist (MS3TraceID *id, MS3TraceSeg *seg, void *output,
673 uint64_t outputsize, int8_t verbose);
674extern int mstl3_convertsamples (MS3TraceSeg *seg, char type, int8_t truncate);
675extern int mstl3_resize_buffers (MS3TraceList *mstl);
676extern int64_t mstl3_pack (MS3TraceList *mstl, void (*record_handler) (char *, int, void *),
677 void *handlerdata, int reclen, int8_t encoding,
678 int64_t *packedsamples, uint32_t flags, int8_t verbose, char *extra);
679extern int64_t mstraceseg3_pack (MS3TraceID *id, MS3TraceSeg *seg,
680 void (*record_handler) (char *, int, void *),
681 void *handlerdata, int reclen, int8_t encoding,
682 int64_t *packedsamples, uint32_t flags, int8_t verbose,
683 char *extra);
684extern void mstl3_printtracelist (const MS3TraceList *mstl, ms_timeformat_t timeformat,
685 int8_t details, int8_t gaps, int8_t versions);
686extern void mstl3_printsynclist (const MS3TraceList *mstl, const char *dccid, ms_subseconds_t subseconds);
687extern void mstl3_printgaplist (const MS3TraceList *mstl, ms_timeformat_t timeformat,
688 double *mingap, double *maxgap);
690
723
725typedef struct LMIO
726{
727 enum
728 {
729 LMIO_NULL = 0,
730 LMIO_FILE = 1,
731 LMIO_URL = 2,
732 LMIO_FD = 3
733 } type;
734 void *handle;
735 void *handle2;
736 int still_running;
737} LMIO;
738
741#define LMIO_INITIALIZER \
742 { \
743 .type = LMIO_NULL, .handle = NULL, .handle2 = NULL, .still_running = 0 \
744 }
745
753typedef struct MS3FileParam
754{
755 char path[512];
756 int64_t startoffset;
757 int64_t endoffset;
758 int64_t streampos;
759 int64_t recordcount;
760
761 char *readbuffer;
762 int readlength;
763 int readoffset;
764 uint32_t flags;
765 LMIO input;
766} MS3FileParam;
767
770#define MS3FileParam_INITIALIZER \
771 { \
772 .path = "", .startoffset = 0, .endoffset = 0, .streampos = 0, \
773 .recordcount = 0, .readbuffer = NULL, .readlength = 0, \
774 .readoffset = 0, .flags = 0, .input = LMIO_INITIALIZER \
775 }
776
777extern int ms3_readmsr (MS3Record **ppmsr, const char *mspath, uint32_t flags, int8_t verbose);
778extern int ms3_readmsr_r (MS3FileParam **ppmsfp, MS3Record **ppmsr, const char *mspath,
779 uint32_t flags, int8_t verbose);
780extern int ms3_readmsr_selection (MS3FileParam **ppmsfp, MS3Record **ppmsr, const char *mspath,
781 uint32_t flags, const MS3Selections *selections, int8_t verbose);
782extern int ms3_readtracelist (MS3TraceList **ppmstl, const char *mspath, const MS3Tolerance *tolerance,
783 int8_t splitversion, uint32_t flags, int8_t verbose);
784extern int ms3_readtracelist_timewin (MS3TraceList **ppmstl, const char *mspath, const MS3Tolerance *tolerance,
785 nstime_t starttime, nstime_t endtime, int8_t splitversion, uint32_t flags,
786 int8_t verbose);
787extern int ms3_readtracelist_selection (MS3TraceList **ppmstl, const char *mspath, const MS3Tolerance *tolerance,
788 const MS3Selections *selections, int8_t splitversion, uint32_t flags, int8_t verbose);
789extern int ms3_url_useragent (const char *program, const char *version);
790extern int ms3_url_userpassword (const char *userpassword);
791extern int ms3_url_addheader (const char *header);
792extern void ms3_url_freeheaders (void);
793extern int64_t msr3_writemseed (MS3Record *msr, const char *mspath, int8_t overwrite,
794 uint32_t flags, int8_t verbose);
795extern int64_t mstl3_writemseed (MS3TraceList *mst, const char *mspath, int8_t overwrite,
796 int maxreclen, int8_t encoding, uint32_t flags, int8_t verbose);
797extern int libmseed_url_support (void);
798extern MS3FileParam *ms3_mstl_init_fd (int fd);
800
810extern int ms_sid2nslc_n (const char *sid,
811 char *net, size_t netsize, char *sta, size_t stasize,
812 char *loc, size_t locsize, char *chan, size_t chansize);
813DEPRECATED extern int ms_sid2nslc (const char *sid, char *net, char *sta, char *loc, char *chan);
814extern int ms_nslc2sid (char *sid, int sidlen, uint16_t flags,
815 const char *net, const char *sta, const char *loc, const char *chan);
816extern int ms_seedchan2xchan (char *xchan, const char *seedchan);
817extern int ms_xchan2seedchan (char *seedchan, const char *xchan);
818extern int ms_strncpclean (char *dest, const char *source, int length);
819extern int ms_strncpcleantail (char *dest, const char *source, int length);
820extern int ms_strncpopen (char *dest, const char *source, int length);
822
851
875
907
926
942
943
949typedef struct LM_PARSED_JSON_s LM_PARSED_JSON;
950
953#define mseh_get(msr, ptr, valueptr, type, maxlength) \
954 mseh_get_ptr_r (msr, ptr, valueptr, type, maxlength, NULL)
955
958#define mseh_get_number(msr, ptr, valueptr) \
959 mseh_get_ptr_r (msr, ptr, valueptr, 'n', 0, NULL)
960
963#define mseh_get_int64(msr, ptr, valueptr) \
964 mseh_get_ptr_r (msr, ptr, valueptr, 'i', 0, NULL)
965
968#define mseh_get_string(msr, ptr, buffer, maxlength) \
969 mseh_get_ptr_r (msr, ptr, buffer, 's', maxlength, NULL)
970
973#define mseh_get_boolean(msr, ptr, valueptr) \
974 mseh_get_ptr_r (msr, ptr, valueptr, 'b', 0, NULL)
975
978#define mseh_exists(msr, ptr) \
979 (!mseh_get_ptr_r (msr, ptr, NULL, 0, 0, NULL))
980
981extern int mseh_get_ptr_r (const MS3Record *msr, const char *ptr,
982 void *value, char type, uint32_t maxlength,
983 LM_PARSED_JSON **parsestate);
984
987#define mseh_set(msr, ptr, valueptr, type) \
988 mseh_set_ptr_r (msr, ptr, valueptr, type, NULL)
989
992#define mseh_set_number(msr, ptr, valueptr) \
993 mseh_set_ptr_r (msr, ptr, valueptr, 'n', NULL)
994
997#define mseh_set_int64(msr, ptr, valueptr) \
998 mseh_set_ptr_r (msr, ptr, valueptr, 'i', NULL)
999
1002#define mseh_set_string(msr, ptr, valueptr) \
1003 mseh_set_ptr_r (msr, ptr, valueptr, 's', NULL)
1004
1007#define mseh_set_boolean(msr, ptr, valueptr) \
1008 mseh_set_ptr_r (msr, ptr, valueptr, 'b', NULL)
1009
1010extern int mseh_set_ptr_r (MS3Record *msr, const char *ptr,
1011 void *value, char type,
1012 LM_PARSED_JSON **parsestate);
1013
1014extern int mseh_add_event_detection_r (MS3Record *msr, const char *ptr,
1015 MSEHEventDetection *eventdetection,
1016 LM_PARSED_JSON **parsestate);
1017
1018extern int mseh_add_calibration_r (MS3Record *msr, const char *ptr,
1019 MSEHCalibration *calibration,
1020 LM_PARSED_JSON **parsestate);
1021
1022extern int mseh_add_timing_exception_r (MS3Record *msr, const char *ptr,
1023 MSEHTimingException *exception,
1024 LM_PARSED_JSON **parsestate);
1025
1026extern int mseh_add_recenter_r (MS3Record *msr, const char *ptr,
1027 MSEHRecenter *recenter,
1028 LM_PARSED_JSON **parsestate);
1029
1030extern int mseh_serialize (MS3Record *msr, LM_PARSED_JSON **parsestate);
1031extern void mseh_free_parsestate (LM_PARSED_JSON **parsestate);
1032extern int mseh_replace (MS3Record *msr, char *jsonstring);
1033
1034extern int mseh_print (const MS3Record *msr, int indent);
1036
1063
1141
1143#define MAX_LOG_MSG_LENGTH 200
1144
1148typedef struct MSLogEntry
1149{
1150 int level;
1151 char function[30];
1152 char message[MAX_LOG_MSG_LENGTH];
1153 struct MSLogEntry *next;
1154} MSLogEntry;
1155
1159typedef struct MSLogRegistry
1160{
1161 int maxmessages;
1162 int messagecnt;
1163 MSLogEntry *messages;
1164} MSLogRegistry;
1165
1168#define MSLogRegistry_INITIALIZER \
1169 { \
1170 .maxmessages = 0, .messagecnt = 0, .messages = NULL \
1171 }
1172
1178typedef struct MSLogParam
1179{
1180 void (*log_print)(const char*);
1181 const char *logprefix;
1182 void (*diag_print)(const char*);
1183 const char *errprefix;
1184 MSLogRegistry registry;
1185} MSLogParam;
1186
1189#define MSLogParam_INITIALIZER \
1190 { \
1191 .log_print = NULL, .logprefix = NULL, \
1192 .diag_print = NULL, .errprefix = NULL, \
1193 .registry = MSLogRegistry_INITIALIZER \
1194 }
1195
1199#define ms_log(level, ...) \
1200 ms_rlog(__func__, level, __VA_ARGS__)
1201
1205#define ms_log_l(logp, level, ...) \
1206 ms_rlog_l(logp, __func__, level, __VA_ARGS__)
1207
1208#if defined(__GNUC__) || defined(__clang__)
1209__attribute__((__format__ (__printf__, 3, 4)))
1210#endif
1211extern int ms_rlog (const char *function, int level, const char *format, ...);
1212#if defined(__GNUC__) || defined(__clang__)
1213__attribute__ ((__format__ (__printf__, 4, 5)))
1214#endif
1215extern int ms_rlog_l (MSLogParam *logp, const char *function, int level, const char *format, ...);
1216
1219#define ms_loginit(log_print, logprefix, diag_print, errprefix) \
1220 ms_rloginit(log_print, logprefix, diag_print, errprefix, 0)
1221
1224#define ms_loginit_l(logp, log_print, logprefix, diag_print, errprefix) \
1225 ms_rloginit_l(logp, log_print, logprefix, diag_print, errprefix, 0)
1226
1227extern void ms_rloginit (void (*log_print)(const char*), const char *logprefix,
1228 void (*diag_print)(const char*), const char *errprefix,
1229 int maxmessages);
1230extern MSLogParam *ms_rloginit_l (MSLogParam *logp,
1231 void (*log_print)(const char*), const char *logprefix,
1232 void (*diag_print)(const char*), const char *errprefix,
1233 int maxmessages);
1234extern int ms_rlog_emit (MSLogParam *logp, int count, int context);
1235extern int ms_rlog_free (MSLogParam *logp);
1236
1238
1271typedef struct LeapSecond
1272{
1273 nstime_t leapsecond;
1274 int32_t TAIdelta;
1275 struct LeapSecond *next;
1276} LeapSecond;
1277
1279extern LeapSecond *leapsecondlist;
1280extern int ms_readleapseconds (const char *envvarname);
1281extern int ms_readleapsecondfile (const char *filename);
1283
1287
1288extern uint8_t ms_samplesize (char sampletype);
1289extern int ms_encoding_sizetype (uint8_t encoding, uint8_t *samplesize, char *sampletype);
1290extern const char *ms_encodingstr (uint8_t encoding);
1291extern const char *ms_errorstr (int errorcode);
1292
1293extern nstime_t ms_sampletime (nstime_t time, int64_t offset, double samprate);
1294extern int ms_bigendianhost (void);
1295
1297#define ms_dabs(val) fabs(val)
1298
1300extern int64_t lmp_ftell64 (FILE *stream);
1302extern int lmp_fseek64 (FILE *stream, int64_t offset, int whence);
1304extern uint64_t lmp_nanosleep (uint64_t nanoseconds);
1306extern nstime_t lmp_systemtime (void);
1307
1309extern uint32_t ms_crc32c (const uint8_t *input, int length, uint32_t previousCRC32C);
1310
1312static inline void
1313ms_gswap2 (void *data2)
1314{
1315 uint16_t dat;
1316
1317 memcpy (&dat, data2, 2);
1318
1319 dat = ((dat & 0xff00) >> 8) | ((dat & 0x00ff) << 8);
1320
1321 memcpy (data2, &dat, 2);
1322}
1323
1325static inline void
1326ms_gswap4 (void *data4)
1327{
1328 uint32_t dat;
1329
1330 memcpy (&dat, data4, 4);
1331
1332 dat = ((dat & 0xff000000) >> 24) | ((dat & 0x000000ff) << 24) |
1333 ((dat & 0x00ff0000) >> 8) | ((dat & 0x0000ff00) << 8);
1334
1335 memcpy (data4, &dat, 4);
1336}
1337
1339static inline void
1340ms_gswap8 (void *data8)
1341{
1342 uint64_t dat;
1343
1344 memcpy (&dat, data8, sizeof(uint64_t));
1345
1346 dat = ((dat & 0xff00000000000000) >> 56) | ((dat & 0x00000000000000ff) << 56) |
1347 ((dat & 0x00ff000000000000) >> 40) | ((dat & 0x000000000000ff00) << 40) |
1348 ((dat & 0x0000ff0000000000) >> 24) | ((dat & 0x0000000000ff0000) << 24) |
1349 ((dat & 0x000000ff00000000) >> 8) | ((dat & 0x00000000ff000000) << 8);
1350
1351 memcpy (data8, &dat, sizeof(uint64_t));
1352}
1353
1354#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5) || defined (__clang__)
1356__attribute__ ((deprecated("Use ms_gswap2 instead.")))
1357static inline void ms_gswap2a (void *data2) { ms_gswap2 (data2); }
1359__attribute__ ((deprecated("Use ms_gswap4 instead.")))
1360static inline void ms_gswap4a (void *data4) { ms_gswap4 (data4); }
1362__attribute__ ((deprecated("Use ms_gswap8 instead.")))
1363static inline void ms_gswap8a (void *data8) { ms_gswap8 (data8); }
1364#elif defined(_MSC_FULL_VER) && (_MSC_FULL_VER > 140050320)
1366__declspec(deprecated("Use ms_gswap2 instead."))
1367static inline void ms_gswap2a (void *data2) { ms_gswap2 (data2); }
1369__declspec(deprecated("Use ms_gswap4 instead."))
1370static inline void ms_gswap4a (void *data4) { ms_gswap4 (data4); }
1372__declspec(deprecated("Use ms_gswap8 instead."))
1373static inline void ms_gswap8a (void *data8) { ms_gswap8 (data8); }
1374#else
1376static inline void ms_gswap2a (void *data2) { ms_gswap2 (data2); }
1378static inline void ms_gswap4a (void *data4) { ms_gswap4 (data4); }
1380static inline void ms_gswap8a (void *data8) { ms_gswap8 (data8); }
1381#endif
1382
1384
1386typedef int8_t flag;
1387
1410
1412typedef struct LIBMSEED_MEMORY
1413{
1414 void *(*malloc) (size_t);
1415 void *(*realloc) (void *, size_t);
1416 void (*free) (void *);
1417} LIBMSEED_MEMORY;
1418
1420extern LIBMSEED_MEMORY libmseed_memory;
1421
1435extern size_t libmseed_prealloc_block_size;
1436
1441extern void *libmseed_memory_prealloc (void *ptr, size_t size, size_t *currentsize);
1442
1444
1445#define DE_ASCII DE_TEXT
1446
1455#define DE_TEXT 0
1456#define DE_INT16 1
1457#define DE_INT32 3
1458#define DE_FLOAT32 4
1459#define DE_FLOAT64 5
1460#define DE_STEIM1 10
1461#define DE_STEIM2 11
1462#define DE_GEOSCOPE24 12
1463#define DE_GEOSCOPE163 13
1464#define DE_GEOSCOPE164 14
1465#define DE_CDSN 16
1466#define DE_SRO 30
1467#define DE_DWWSSN 32
1469
1476#define MSSWAP_HEADER 0x01
1477#define MSSWAP_PAYLOAD 0x02
1479
1485#define MS_ENDOFFILE 1
1486#define MS_NOERROR 0
1487#define MS_GENERROR -1
1488#define MS_NOTSEED -2
1489#define MS_WRONGLENGTH -3
1490#define MS_OUTOFRANGE -4
1491#define MS_UNKNOWNFORMAT -5
1492#define MS_STBADCOMPFLAG -6
1493#define MS_INVALIDCRC -7
1495
1503#define MSF_UNPACKDATA 0x0001
1504#define MSF_SKIPNOTDATA 0x0002
1505#define MSF_VALIDATECRC 0x0004
1506#define MSF_PNAMERANGE 0x0008
1507#define MSF_ATENDOFFILE 0x0010
1508#define MSF_SEQUENCE 0x0020
1509#define MSF_FLUSHDATA 0x0040
1510#define MSF_PACKVER2 0x0080
1511#define MSF_RECORDLIST 0x0100
1512#define MSF_MAINTAINMSTL 0x0200
1513#define MSF_PPUPDATETIME 0x0400
1515
1516#ifdef __cplusplus
1517}
1518#endif
1519
1520#endif /* LIBMSEED_H */
MS3SelectTime::next
struct MS3SelectTime * next
Pointer to next selection time, NULL if the last.
Definition libmseed.h:470
MS3SelectTime::endtime
nstime_t endtime
Latest data for matching channels, use NSTUNSET for open.
Definition libmseed.h:469
MS3Selections::pubversion
uint8_t pubversion
Selected publication version, use 0 for any.
Definition libmseed.h:478
MS3Selections::sidpattern
char sidpattern[100]
Matching (globbing) pattern for source ID.
Definition libmseed.h:475
MS3Selections::next
struct MS3Selections * next
Pointer to next selection, NULL if the last.
Definition libmseed.h:477
MS3SelectTime::starttime
nstime_t starttime
Earliest data for matching channels, use NSTUNSET for open.
Definition libmseed.h:468
MS3Selections::timewindows
struct MS3SelectTime * timewindows
Pointer to time window list for this source ID.
Definition libmseed.h:476
ms3_addselect
int ms3_addselect(MS3Selections **ppselections, const char *sidpattern, nstime_t starttime, nstime_t endtime, uint8_t pubversion)
Add selection parameters to selection list.
Definition selection.c:181
ms3_readselectionsfile
int ms3_readselectionsfile(MS3Selections **ppselections, const char *filename)
Read data selections from a file.
Definition selection.c:428
ms3_printselections
void ms3_printselections(const MS3Selections *selections)
Print the selections list using the ms_log() facility.
Definition selection.c:707
ms3_freeselections
void ms3_freeselections(MS3Selections *selections)
Free all memory associated with a MS3Selections.
Definition selection.c:665
ms3_matchselect
const MS3Selections * ms3_matchselect(const MS3Selections *selections, const char *sid, nstime_t starttime, nstime_t endtime, int pubversion, const MS3SelectTime **ppselecttime)
Test the specified parameters for a matching selection entry.
Definition selection.c:58
ms3_addselect_comp
int ms3_addselect_comp(MS3Selections **ppselections, char *network, char *station, char *location, char *channel, nstime_t starttime, nstime_t endtime, uint8_t pubversion)
Add selection parameters to a selection list based on separate source name codes.
Definition selection.c:305
msr3_matchselect
const MS3Selections * msr3_matchselect(const MS3Selections *selections, const MS3Record *msr, const MS3SelectTime **ppselecttime)
Test the MS3Record for a matching selection entry.
Definition selection.c:145
MS3SelectTime
Data selection structure time window definition containers.
Definition libmseed.h:467
MS3Selections
Data selection structure definition containers.
Definition libmseed.h:474
MSEHEventDetection::type
char type[30]
Definition libmseed.h:862
MSEHCalibration::duration
double duration
Definition libmseed.h:897
MSEHEventDetection::wave
char wave[30]
Definition libmseed.h:867
MSEHCalibration::inputchannel
char inputchannel[30]
Definition libmseed.h:900
MSEHEventDetection::next
struct MSEHEventDetection * next
Definition libmseed.h:873
MSEHEventDetection::signalperiod
double signalperiod
Definition libmseed.h:865
MSEHCalibration::amplituderange
char amplituderange[30]
Definition libmseed.h:896
MSEHCalibration::firstpulsepositive
int firstpulsepositive
Definition libmseed.h:890
MSEHEventDetection::onsettime
nstime_t onsettime
Definition libmseed.h:869
MSEHEventDetection::medlookback
int medlookback
Definition libmseed.h:871
MSEHTimingException::vcocorrection
float vcocorrection
Definition libmseed.h:919
MSEHCalibration::endtime
nstime_t endtime
Definition libmseed.h:888
MSEHCalibration::type
char type[30]
Definition libmseed.h:886
MSEHCalibration::next
struct MSEHCalibration * next
Definition libmseed.h:905
MSEHCalibration::continued
int continued
Definition libmseed.h:893
MSEHTimingException::clockstatus
char clockstatus[128]
Definition libmseed.h:924
MSEHEventDetection::signalamplitude
double signalamplitude
Definition libmseed.h:864
MSEHCalibration::stepbetween
double stepbetween
Definition libmseed.h:899
MSEHTimingException::count
uint32_t count
Definition libmseed.h:922
MSEHEventDetection::units
char units[30]
Definition libmseed.h:868
MSEHCalibration::alternatesign
int alternatesign
Definition libmseed.h:891
MSEHRecenter::type
char type[30]
Definition libmseed.h:937
MSEHEventDetection::backgroundestimate
double backgroundestimate
Definition libmseed.h:866
MSEHTimingException::time
nstime_t time
Definition libmseed.h:918
MSEHCalibration::amplitude
double amplitude
Definition libmseed.h:894
MSEHCalibration::rolloff
char rolloff[30]
Definition libmseed.h:903
MSEHCalibration::trigger
char trigger[30]
Definition libmseed.h:892
MSEHCalibration::coupling
char coupling[30]
Definition libmseed.h:902
MSEHCalibration::steps
int steps
Definition libmseed.h:889
MSEHCalibration::noise
char noise[30]
Definition libmseed.h:904
MSEHRecenter::trigger
char trigger[30]
Definition libmseed.h:940
MSEHCalibration::inputunits
char inputunits[30]
Definition libmseed.h:895
MSEHCalibration::sineperiod
double sineperiod
Definition libmseed.h:898
MSEHTimingException::usec
int usec
Definition libmseed.h:920
MSEHEventDetection::medsnr
uint8_t medsnr[6]
Definition libmseed.h:870
MSEHEventDetection::medpickalgorithm
int medpickalgorithm
Definition libmseed.h:872
MSEHTimingException::type
char type[16]
Definition libmseed.h:923
MSEHRecenter::begintime
nstime_t begintime
Definition libmseed.h:938
MSEHCalibration::refamplitude
double refamplitude
Definition libmseed.h:901
MSEHEventDetection::detector
char detector[30]
Definition libmseed.h:863
MSEHRecenter::endtime
nstime_t endtime
Definition libmseed.h:939
MSEHCalibration::begintime
nstime_t begintime
Definition libmseed.h:887
MSEHTimingException::receptionquality
int receptionquality
Definition libmseed.h:921
mseh_add_timing_exception_r
int mseh_add_timing_exception_r(MS3Record *msr, const char *ptr, MSEHTimingException *exception, LM_PARSED_JSON **parsestate)
Add timing exception to the extra headers of the given record.
Definition extraheaders.c:821
mseh_print
int mseh_print(const MS3Record *msr, int indent)
Print the extra header structure for the specified MS3Record.
Definition extraheaders.c:1156
mseh_serialize
int mseh_serialize(MS3Record *msr, LM_PARSED_JSON **parsestate)
Generate extra headers string (serialize) from internal state.
Definition extraheaders.c:997
mseh_add_event_detection_r
int mseh_add_event_detection_r(MS3Record *msr, const char *ptr, MSEHEventDetection *eventdetection, LM_PARSED_JSON **parsestate)
Add event detection to the extra headers of the given record.
Definition extraheaders.c:493
mseh_get_ptr_r
int mseh_get_ptr_r(const MS3Record *msr, const char *ptr, void *value, char type, uint32_t maxlength, LM_PARSED_JSON **parsestate)
Search for and return an extra header value.
Definition extraheaders.c:150
mseh_add_calibration_r
int mseh_add_calibration_r(MS3Record *msr, const char *ptr, MSEHCalibration *calibration, LM_PARSED_JSON **parsestate)
Add calibration to the extra headers of the given record.
Definition extraheaders.c:629
mseh_free_parsestate
void mseh_free_parsestate(LM_PARSED_JSON **parsestate)
Free internally parsed (deserialized) JSON data.
Definition extraheaders.c:1054
mseh_set_ptr_r
int mseh_set_ptr_r(MS3Record *msr, const char *ptr, void *value, char type, LM_PARSED_JSON **parsestate)
Set the value of extra header values.
Definition extraheaders.c:312
LM_PARSED_JSON
struct LM_PARSED_JSON_s LM_PARSED_JSON
Internal structure for holding parsed JSON extra headers.
Definition libmseed.h:949
mseh_add_recenter_r
int mseh_add_recenter_r(MS3Record *msr, const char *ptr, MSEHRecenter *recenter, LM_PARSED_JSON **parsestate)
Add recenter event to the extra headers of the given record.
Definition extraheaders.c:913
mseh_replace
int mseh_replace(MS3Record *msr, char *jsonstring)
Replace extra headers with supplied JSON.
Definition extraheaders.c:1091
MSEHCalibration
Container for calibration parameters for use in extra headers.
Definition libmseed.h:885
MSEHEventDetection
Container for event detection parameters for use in extra headers.
Definition libmseed.h:861
MSEHRecenter
Container for recenter parameters for use in extra headers.
Definition libmseed.h:936
MSEHTimingException
Container for timing exception parameters for use in extra headers.
Definition libmseed.h:917
MS3FileParam::readlength
int readlength
INTERNAL: Length of data in read buffer.
Definition libmseed.h:762
MS3FileParam::streampos
int64_t streampos
OUTPUT: Read position of input stream.
Definition libmseed.h:758
MS3FileParam::endoffset
int64_t endoffset
INPUT: End position in input stream, 0 == unknown (e.g. pipe)
Definition libmseed.h:757
MS3FileParam::recordcount
int64_t recordcount
OUTPUT: Count of records read from this stream/file so far.
Definition libmseed.h:759
MS3FileParam::input
LMIO input
INTERNAL: IO handle, file or URL.
Definition libmseed.h:765
MS3FileParam::flags
uint32_t flags
INTERNAL: Stream reading state flags.
Definition libmseed.h:764
MS3FileParam::path
char path[512]
INPUT: File name or URL.
Definition libmseed.h:755
MS3FileParam::readoffset
int readoffset
INTERNAL: Read offset in read buffer.
Definition libmseed.h:763
MS3FileParam::readbuffer
char * readbuffer
INTERNAL: Read buffer, allocated internally.
Definition libmseed.h:761
MS3FileParam::startoffset
int64_t startoffset
INPUT: Start position in input stream.
Definition libmseed.h:756
ms3_readtracelist
int ms3_readtracelist(MS3TraceList **ppmstl, const char *mspath, const MS3Tolerance *tolerance, int8_t splitversion, uint32_t flags, int8_t verbose)
Read miniSEED from a file into a trace list.
Definition fileutils.c:587
ms3_readtracelist_selection
int ms3_readtracelist_selection(MS3TraceList **ppmstl, const char *mspath, const MS3Tolerance *tolerance, const MS3Selections *selections, int8_t splitversion, uint32_t flags, int8_t verbose)
Read miniSEED from a file into a trace list, with selection filtering.
Definition fileutils.c:676
ms3_url_freeheaders
void ms3_url_freeheaders(void)
Free all set headers for URL-based requests.
Definition fileutils.c:847
ms3_readmsr_r
int ms3_readmsr_r(MS3FileParam **ppmsfp, MS3Record **ppmsr, const char *mspath, uint32_t flags, int8_t verbose)
Read miniSEED records from a file or URL in a thread-safe way.
Definition fileutils.c:144
ms3_url_addheader
int ms3_url_addheader(const char *header)
Add header to any URL-based requests.
Definition fileutils.c:827
libmseed_url_support
int libmseed_url_support(void)
Run-time test for URL support in libmseed.
Definition fileutils.c:49
ms3_readmsr
int ms3_readmsr(MS3Record **ppmsr, const char *mspath, uint32_t flags, int8_t verbose)
Read miniSEED records from a file or URL.
Definition fileutils.c:117
ms3_readtracelist_timewin
int ms3_readtracelist_timewin(MS3TraceList **ppmstl, const char *mspath, const MS3Tolerance *tolerance, nstime_t starttime, nstime_t endtime, int8_t splitversion, uint32_t flags, int8_t verbose)
Read miniSEED from a file into a trace list, with time range selection.
Definition fileutils.c:612
mstl3_writemseed
int64_t mstl3_writemseed(MS3TraceList *mst, const char *mspath, int8_t overwrite, int maxreclen, int8_t encoding, uint32_t flags, int8_t verbose)
Write miniSEED from an MS3TraceList container to a file.
Definition fileutils.c:960
ms3_readmsr_selection
int ms3_readmsr_selection(MS3FileParam **ppmsfp, MS3Record **ppmsr, const char *mspath, uint32_t flags, const MS3Selections *selections, int8_t verbose)
Read miniSEED records from a file or URL with optional selection.
Definition fileutils.c:257
ms3_url_userpassword
int ms3_url_userpassword(const char *userpassword)
Set authentication credentials for URL-based requests.
Definition fileutils.c:798
ms3_mstl_init_fd
MS3FileParam * ms3_mstl_init_fd(int fd)
Initialize MS3FileParam parameters for a file descriptor.
Definition fileutils.c:75
msr3_writemseed
int64_t msr3_writemseed(MS3Record *msr, const char *mspath, int8_t overwrite, uint32_t flags, int8_t verbose)
Write miniSEED from an MS3Record container to a file.
Definition fileutils.c:899
ms3_url_useragent
int ms3_url_useragent(const char *program, const char *version)
Set User-Agent header for URL-based requests.
Definition fileutils.c:768
MS3FileParam
State container for reading miniSEED records from files or URLs.
Definition libmseed.h:754
LeapSecond::TAIdelta
int32_t TAIdelta
TAI-UTC difference in seconds.
Definition libmseed.h:1274
LeapSecond::leapsecond
nstime_t leapsecond
Time of leap second as epoch since 1 January 1900.
Definition libmseed.h:1273
LeapSecond::next
struct LeapSecond * next
Pointer to next entry, NULL if the last.
Definition libmseed.h:1275
leapsecondlist
LeapSecond * leapsecondlist
ms_readleapsecondfile
int ms_readleapsecondfile(const char *filename)
Read leap second from the specified file.
Definition genutils.c:1795
ms_readleapseconds
int ms_readleapseconds(const char *envvarname)
Read leap second file specified by an environment variable.
Definition genutils.c:1765
LeapSecond
Leap second list container.
Definition libmseed.h:1272
MSLogParam::diag_print
void(* diag_print)(const char *)
Function to call for diagnostic and error messages.
Definition libmseed.h:1182
MSLogEntry::message
char message[MAX_LOG_MSG_LENGTH]
Log, warning or error message.
Definition libmseed.h:1152
MSLogEntry::function
char function[30]
Function generating the message.
Definition libmseed.h:1151
MSLogParam::log_print
void(* log_print)(const char *)
Function to call for regular messages.
Definition libmseed.h:1180
MSLogEntry::level
int level
Message level.
Definition libmseed.h:1150
MSLogParam::logprefix
const char * logprefix
Message prefix for regular and diagnostic messages.
Definition libmseed.h:1181
MSLogParam::errprefix
const char * errprefix
Message prefix for error messages.
Definition libmseed.h:1183
MSLogParam::registry
MSLogRegistry registry
Message registry.
Definition libmseed.h:1184
ms_rlog_l
int ms_rlog_l(MSLogParam *logp, const char *function, int level, const char *format,...)
Register log message using specified logging parameters.
Definition logging.c:310
ms_rloginit_l
MSLogParam * ms_rloginit_l(MSLogParam *logp, void(*log_print)(const char *), const char *logprefix, void(*diag_print)(const char *), const char *errprefix, int maxmessages)
Initialize specified MSLogParam logging parameters.
Definition logging.c:134
MAX_LOG_MSG_LENGTH
#define MAX_LOG_MSG_LENGTH
Definition libmseed.h:1143
ms_rlog_free
int ms_rlog_free(MSLogParam *logp)
Free, without emitting, all messages from log registry.
Definition logging.c:637
ms_rloginit
void ms_rloginit(void(*log_print)(const char *), const char *logprefix, void(*diag_print)(const char *), const char *errprefix, int maxmessages)
Initialize the global logging parameters.
Definition logging.c:92
ms_rlog
int ms_rlog(const char *function, int level, const char *format,...)
Register log message using global logging parameters.
Definition logging.c:258
ms_rlog_emit
int ms_rlog_emit(MSLogParam *logp, int count, int context)
Emit, aka send to print functions, messages from log registry.
Definition logging.c:573
MSLogEntry
Log registry entry.
Definition libmseed.h:1149
MSLogParam
Logging parameters. Callers should not modify these values directly and generally should not need to ...
Definition libmseed.h:1179
MSLogRegistry
Log message registry.
Definition libmseed.h:1160
LIBMSEED_MEMORY::free
void(* free)(void *)
Pointer to desired free()
Definition libmseed.h:1416
libmseed_memory
LIBMSEED_MEMORY libmseed_memory
libmseed_memory_prealloc
void * libmseed_memory_prealloc(void *ptr, size_t size, size_t *currentsize)
libmseed_prealloc_block_size
size_t libmseed_prealloc_block_size
LIBMSEED_MEMORY
Definition libmseed.h:1413
MS3Record::swapflag
uint8_t swapflag
Byte swap indicator (bitmask), see Byte swap flags.
Definition libmseed.h:363
MS3Record::datasamples
void * datasamples
Data samples, numsamples of type sampletype.
Definition libmseed.h:380
MS3Record::datalength
uint32_t datalength
Length of data payload in bytes.
Definition libmseed.h:376
MS3Record::crc
uint32_t crc
CRC of entire record.
Definition libmseed.h:374
MS3Record::formatversion
uint8_t formatversion
Format major version.
Definition libmseed.h:367
MS3Record::reclen
int32_t reclen
Length of miniSEED record in bytes.
Definition libmseed.h:362
MS3Record::flags
uint8_t flags
Record-level bit flags.
Definition libmseed.h:368
MS3Record::extralength
uint16_t extralength
Length of extra headers in bytes.
Definition libmseed.h:375
MS3Record::datasize
uint64_t datasize
Size of datasamples buffer in bytes.
Definition libmseed.h:381
MS3Record::record
const char * record
Raw miniSEED record, if available.
Definition libmseed.h:361
MS3Record::samprate
double samprate
Nominal sample rate as samples/second (Hz) or period (s)
Definition libmseed.h:370
MS3Record::numsamples
int64_t numsamples
Number of data samples in datasamples.
Definition libmseed.h:382
MS3Record::samplecnt
int64_t samplecnt
Number of samples in record.
Definition libmseed.h:373
MS3Record::sampletype
char sampletype
Sample type code: t, i, f, d Sample Types.
Definition libmseed.h:383
MS3Record::encoding
int16_t encoding
Data encoding format, see Data Encodings.
Definition libmseed.h:371
MS3Record::starttime
nstime_t starttime
Record start time (first sample)
Definition libmseed.h:369
MS3Record::sid
char sid[LM_SIDLEN]
Source identifier as URN, max length LM_SIDLEN.
Definition libmseed.h:366
MS3Record::pubversion
uint8_t pubversion
Publication version.
Definition libmseed.h:372
MS3Record::extra
char * extra
Pointer to extra headers.
Definition libmseed.h:377
ms3_detect
int64_t ms3_detect(const char *record, uint64_t recbuflen, uint8_t *formatversion)
Detect miniSEED record in buffer.
Definition parseutils.c:179
msr3_repack_mseed3
int msr3_repack_mseed3(const MS3Record *msr, char *record, uint32_t recbuflen, int8_t verbose)
Repack a parsed miniSEED record into a version 3 record.
Definition pack.c:400
msr3_print
void msr3_print(const MS3Record *msr, int8_t details)
Print header values of an MS3Record.
Definition msrutils.c:226
msr3_init
MS3Record * msr3_init(MS3Record *msr)
Initialize and return an MS3Record.
Definition msrutils.c:44
msr3_sampratehz
double msr3_sampratehz(const MS3Record *msr)
Calculate sample rate in samples/second (Hertz) for a given MS3Record.
Definition msrutils.c:345
msr3_unpack_data
int64_t msr3_unpack_data(MS3Record *msr, int8_t verbose)
Unpack data samples for a MS3Record.
Definition unpack.c:1135
msr3_host_latency
double msr3_host_latency(const MS3Record *msr)
Calculate data latency based on the host time.
Definition msrutils.c:395
msr3_pack_header2
int msr3_pack_header2(const MS3Record *msr, char *record, uint32_t recbuflen, int8_t verbose)
Pack a miniSEED version 2 header into the specified buffer.
Definition pack.c:999
msr3_free
void msr3_free(MS3Record **ppmsr)
Free all memory associated with a MS3Record.
Definition msrutils.c:86
ms_parse_raw3
int ms_parse_raw3(const char *record, int maxreclen, int8_t details)
Parse and verify a miniSEED 3.x record header.
Definition parseutils.c:324
msr3_resize_buffer
int msr3_resize_buffer(MS3Record *msr)
Resize data sample buffer of MS3Record to what is needed.
Definition msrutils.c:303
ms_decode_data
int64_t ms_decode_data(const void *input, uint64_t inputsize, uint8_t encoding, uint64_t samplecount, void *output, uint64_t outputsize, char *sampletype, int8_t swapflag, const char *sid, int8_t verbose)
Decode data samples to a supplied buffer.
Definition unpack.c:1290
msr3_parse
int msr3_parse(const char *record, uint64_t recbuflen, MS3Record **ppmsr, uint32_t flags, int8_t verbose)
Parse miniSEED from a buffer.
Definition parseutils.c:61
msr3_repack_mseed2
int msr3_repack_mseed2(const MS3Record *msr, char *record, uint32_t recbuflen, int8_t verbose)
Repack a parsed miniSEED record into a version 2 record.
Definition pack.c:889
msr3_duplicate
MS3Record * msr3_duplicate(const MS3Record *msr, int8_t datadup)
Duplicate a MS3Record.
Definition msrutils.c:118
msr3_endtime
nstime_t msr3_endtime(const MS3Record *msr)
Calculate time of the last sample in a record.
Definition msrutils.c:200
ms_parse_raw2
int ms_parse_raw2(const char *record, int maxreclen, int8_t details, int8_t swapflag)
Parse and verify a miniSEED 2.x record header.
Definition parseutils.c:535
msr3_nsperiod
nstime_t msr3_nsperiod(const MS3Record *msr)
Calculate sample period in nanoseconds/sample for a given MS3Record.
Definition msrutils.c:364
msr3_pack_header3
int msr3_pack_header3(const MS3Record *msr, char *record, uint32_t recbuflen, int8_t verbose)
Pack a miniSEED version 3 header into the specified buffer.
Definition pack.c:495
msr3_data_bounds
int msr3_data_bounds(const MS3Record *msr, uint32_t *dataoffset, uint32_t *datasize)
Determine the data payload bounds for a MS3Record.
Definition unpack.c:1036
msr3_pack
int msr3_pack(const MS3Record *msr, void(*record_handler)(char *, int, void *), void *handlerdata, int64_t *packedsamples, uint32_t flags, int8_t verbose)
Pack data into miniSEED records.
Definition pack.c:112
MS3Record
miniSEED record container
Definition libmseed.h:360
MS3RecordPtr::next
struct MS3RecordPtr * next
Pointer to next entry, NULL if the last.
Definition libmseed.h:531
MS3RecordPtr::prvtptr
void * prvtptr
Private pointer, will not be populated by library but will be free'd.
Definition libmseed.h:530
MS3RecordList::last
MS3RecordPtr * last
Pointer to last entry, NULL if the none.
Definition libmseed.h:539
MS3RecordPtr::fileoffset
int64_t fileoffset
Offset into file to record for fileptr or filename.
Definition libmseed.h:526
MS3RecordPtr::filename
const char * filename
Pointer to file name containing record, NULL if not used.
Definition libmseed.h:525
MS3RecordList::first
MS3RecordPtr * first
Pointer to first entry, NULL if the none.
Definition libmseed.h:538
MS3RecordPtr::msr
MS3Record * msr
Pointer to MS3Record for this record.
Definition libmseed.h:527
MS3RecordPtr::bufferptr
const char * bufferptr
Pointer in buffer to record, NULL if not used.
Definition libmseed.h:523
MS3RecordPtr::fileptr
FILE * fileptr
Pointer to open FILE containing record, NULL if not used.
Definition libmseed.h:524
MS3RecordList::recordcnt
uint64_t recordcnt
Count of records in the list (for convenience)
Definition libmseed.h:537
MS3RecordPtr::endtime
nstime_t endtime
End time of record, time of last sample.
Definition libmseed.h:528
MS3RecordPtr::dataoffset
uint32_t dataoffset
Offset from start of record to encoded data.
Definition libmseed.h:529
MS3RecordList
Record list, holds MS3RecordPtr entries that contribute to a given MS3TraceSeg.
Definition libmseed.h:536
MS3RecordPtr
A miniSEED record pointer and metadata.
Definition libmseed.h:522
ms_sid2nslc_n
int ms_sid2nslc_n(const char *sid, char *net, size_t netsize, char *sta, size_t stasize, char *loc, size_t locsize, char *chan, size_t chansize)
Parse network, station, location and channel codes from an FDSN Source ID.
Definition genutils.c:189
ms_strncpopen
int ms_strncpopen(char *dest, const char *source, int length)
Copy fixed number of characters into unterminated string.
Definition genutils.c:752
ms_sid2nslc
DEPRECATED int ms_sid2nslc(const char *sid, char *net, char *sta, char *loc, char *chan)
Definition genutils.c:307
ms_strncpclean
int ms_strncpclean(char *dest, const char *source, int length)
Copy string, removing spaces, always terminated.
Definition genutils.c:646
ms_xchan2seedchan
int ms_xchan2seedchan(char *seedchan, const char *xchan)
Convert extended channel to SEED 2.x channel.
Definition genutils.c:542
ms_seedchan2xchan
int ms_seedchan2xchan(char *xchan, const char *seedchan)
Convert SEED 2.x channel to extended channel.
Definition genutils.c:484
ms_strncpcleantail
int ms_strncpcleantail(char *dest, const char *source, int length)
Copy string, removing trailing spaces, always terminated.
Definition genutils.c:700
ms_nslc2sid
int ms_nslc2sid(char *sid, int sidlen, uint16_t flags, const char *net, const char *sta, const char *loc, const char *chan)
Convert network, station, location and channel to an FDSN Source ID.
Definition genutils.c:345
ms_nstime2time
int ms_nstime2time(nstime_t nstime, uint16_t *year, uint16_t *yday, uint8_t *hour, uint8_t *min, uint8_t *sec, uint32_t *nsec)
Convert an nstime_t to individual date-time components.
Definition genutils.c:921
ms_timeformat_t
ms_timeformat_t
Time format identifiers.
Definition libmseed.h:285
ms_md2doy
int ms_md2doy(int year, int month, int mday, int *yday)
Compute the day-of-year from a year, month and day-of-month.
Definition genutils.c:857
ms_subseconds_t
ms_subseconds_t
Subsecond format identifiers.
Definition libmseed.h:310
ms_mdtimestr2nstime
nstime_t ms_mdtimestr2nstime(const char *timestr)
Convert a time string (year-month-day) to a high precision epoch time.
Definition genutils.c:1494
ms_timestr2nstime
nstime_t ms_timestr2nstime(const char *timestr)
Convert a time string to a high precision epoch time.
Definition genutils.c:1341
ms_nstime2timestrz
DEPRECATED char * ms_nstime2timestrz(nstime_t nstime, char *timestr, ms_timeformat_t timeformat, ms_subseconds_t subsecond)
Convert an nstime_t to a time string with 'Z' suffix.
Definition genutils.c:1206
ms_seedtimestr2nstime
nstime_t ms_seedtimestr2nstime(const char *seedtimestr)
Convert an SEED-style (ordinate date, i.e. day-of-year) time string to a high precision epoch time.
Definition genutils.c:1602
nstime_t
int64_t nstime_t
libmseed time type, integer nanoseconds since the Unix/POSIX epoch (00:00:00 Thursday,...
Definition libmseed.h:227
ms_time2nstime
nstime_t ms_time2nstime(int year, int yday, int hour, int min, int sec, uint32_t nsec)
Convert specified date-time values to a high precision epoch time.
Definition genutils.c:1267
ms_doy2md
int ms_doy2md(int year, int yday, int *month, int *mday)
Compute the month and day-of-month from a year and day-of-year.
Definition genutils.c:803
ms_nstime2timestr
char * ms_nstime2timestr(nstime_t nstime, char *timestr, ms_timeformat_t timeformat, ms_subseconds_t subsecond)
Convert an nstime_t to a time string.
Definition genutils.c:989
MS3TraceID::next
struct MS3TraceID * next[MSTRACEID_SKIPLIST_HEIGHT]
Next trace ID at first pointer, NULL if the last.
Definition libmseed.h:604
MS3TraceSeg::numsamples
int64_t numsamples
Number of data samples in datasamples.
Definition libmseed.h:586
MS3TraceSeg::recordlist
struct MS3RecordList * recordlist
List of pointers to records that contributed.
Definition libmseed.h:589
MS3TraceList::prngstate
uint64_t prngstate
INTERNAL: State for Pseudo RNG.
Definition libmseed.h:612
MS3TraceSeg::endtime
nstime_t endtime
Time of last sample.
Definition libmseed.h:581
MS3TraceID::first
struct MS3TraceSeg * first
Pointer to first of list of segments.
Definition libmseed.h:602
MS3TraceID::latest
nstime_t latest
Time of latest sample.
Definition libmseed.h:599
MS3TraceList::traces
struct MS3TraceID traces
Head node of trace skip list, first entry at traces.next[0].
Definition libmseed.h:611
MS3TraceID::pubversion
uint8_t pubversion
Largest contributing publication version.
Definition libmseed.h:597
MS3TraceSeg::prvtptr
void * prvtptr
Private pointer for general use, unused by library unless MSF_PPUPDATETIME is set.
Definition libmseed.h:588
MS3TraceID::height
uint8_t height
Height of skip list at next.
Definition libmseed.h:605
MS3TraceSeg::datasize
uint64_t datasize
Size of datasamples buffer in bytes.
Definition libmseed.h:585
MS3TraceID::earliest
nstime_t earliest
Time of earliest sample.
Definition libmseed.h:598
MS3Tolerance::samprate
double(* samprate)(const MS3Record *msr)
Pointer to function that returns sample rate tolerance.
Definition libmseed.h:643
MS3TraceID::prvtptr
void * prvtptr
Private pointer for general use, unused by library.
Definition libmseed.h:600
MS3TraceSeg::datasamples
void * datasamples
Data samples, numsamples of type sampletype.
Definition libmseed.h:584
MS3TraceSeg::sampletype
char sampletype
Sample type code, see Sample Types.
Definition libmseed.h:587
MS3TraceSeg::prev
struct MS3TraceSeg * prev
Pointer to previous segment.
Definition libmseed.h:590
MS3TraceSeg::samplecnt
int64_t samplecnt
Number of samples in trace coverage.
Definition libmseed.h:583
MS3TraceID::sid
char sid[LM_SIDLEN]
Source identifier as URN, max length LM_SIDLEN.
Definition libmseed.h:596
MS3TraceID::last
struct MS3TraceSeg * last
Pointer to last of list of segments.
Definition libmseed.h:603
MS3TraceList::numtraceids
uint32_t numtraceids
Number of traces IDs in list.
Definition libmseed.h:610
MS3Tolerance::time
double(* time)(const MS3Record *msr)
Pointer to function that returns time tolerance.
Definition libmseed.h:642
MS3TraceSeg::samprate
double samprate
Nominal sample rate (Hz)
Definition libmseed.h:582
MS3TraceSeg::next
struct MS3TraceSeg * next
Pointer to next segment, NULL if the last.
Definition libmseed.h:591
MS3TraceSeg::starttime
nstime_t starttime
Time of first sample.
Definition libmseed.h:580
MS3TraceID::numsegments
uint32_t numsegments
Number of segments for this ID.
Definition libmseed.h:601
mstl3_unpack_recordlist
int64_t mstl3_unpack_recordlist(MS3TraceID *id, MS3TraceSeg *seg, void *output, uint64_t outputsize, int8_t verbose)
Unpack data samples in a Record List associated with a MS3TraceList.
Definition tracelist.c:1630
mstl3_printsynclist
void mstl3_printsynclist(const MS3TraceList *mstl, const char *dccid, ms_subseconds_t subseconds)
Print SYNC trace list summary information for a MS3TraceList.
Definition tracelist.c:2356
mstl3_printtracelist
void mstl3_printtracelist(const MS3TraceList *mstl, ms_timeformat_t timeformat, int8_t details, int8_t gaps, int8_t versions)
Print trace list summary information for a MS3TraceList.
Definition tracelist.c:2224
mstl3_pack
int64_t mstl3_pack(MS3TraceList *mstl, void(*record_handler)(char *, int, void *), void *handlerdata, int reclen, int8_t encoding, int64_t *packedsamples, uint32_t flags, int8_t verbose, char *extra)
Pack MS3TraceList data into miniSEED records.
Definition tracelist.c:1955
mstl3_free
void mstl3_free(MS3TraceList **ppmstl, int8_t freeprvtptr)
Free all memory associated with a MS3TraceList.
Definition tracelist.c:89
mstl3_readbuffer
int64_t mstl3_readbuffer(MS3TraceList **ppmstl, const char *buffer, uint64_t bufferlength, int8_t splitversion, uint32_t flags, const MS3Tolerance *tolerance, int8_t verbose)
Parse miniSEED from a buffer and populate a MS3TraceList.
Definition tracelist.c:832
mstl3_printgaplist
void mstl3_printgaplist(const MS3TraceList *mstl, ms_timeformat_t timeformat, double *mingap, double *maxgap)
Print gap/overlap list summary information for a MS3TraceList.
Definition tracelist.c:2430
mstraceseg3_pack
int64_t mstraceseg3_pack(MS3TraceID *id, MS3TraceSeg *seg, void(*record_handler)(char *, int, void *), void *handlerdata, int reclen, int8_t encoding, int64_t *packedsamples, uint32_t flags, int8_t verbose, char *extra)
Pack a MS3TraceSeg data into miniSEED records.
Definition tracelist.c:2067
mstl3_resize_buffers
int mstl3_resize_buffers(MS3TraceList *mstl)
Resize data sample buffers of MS3TraceList to what is needed.
Definition tracelist.c:1539
mstl3_readbuffer_selection
int64_t mstl3_readbuffer_selection(MS3TraceList **ppmstl, const char *buffer, uint64_t bufferlength, int8_t splitversion, uint32_t flags, const MS3Tolerance *tolerance, const MS3Selections *selections, int8_t verbose)
Parse miniSEED from a buffer and populate a MS3TraceList.
Definition tracelist.c:881
mstl3_convertsamples
int mstl3_convertsamples(MS3TraceSeg *seg, char type, int8_t truncate)
Convert the data samples associated with an MS3TraceSeg to another data type.
Definition tracelist.c:1389
mstl3_init
MS3TraceList * mstl3_init(MS3TraceList *mstl)
Initialize a MS3TraceList container.
Definition tracelist.c:54
MSTRACEID_SKIPLIST_HEIGHT
#define MSTRACEID_SKIPLIST_HEIGHT
Maximum skip list height for MSTraceIDs.
Definition libmseed.h:576
mstl3_findID
MS3TraceID * mstl3_findID(MS3TraceList *mstl, const char *sid, uint8_t pubversion, MS3TraceID **prev)
Find matching MS3TraceID in a MS3TraceList.
Definition tracelist.c:180
mstl3_addmsr_recordptr
MS3TraceSeg * mstl3_addmsr_recordptr(MS3TraceList *mstl, const MS3Record *msr, MS3RecordPtr **pprecptr, int8_t splitversion, int8_t autoheal, uint32_t flags, const MS3Tolerance *tolerance)
Add data coverage from an MS3Record to a MS3TraceList.
Definition tracelist.c:364
MS3Tolerance
Callback functions that return time and sample rate tolerances.
Definition libmseed.h:641
MS3TraceID
Container for a trace ID, linkable.
Definition libmseed.h:595
MS3TraceList
Container for a collection of continuous trace segment, linkable.
Definition libmseed.h:609
MS3TraceSeg
Container for a continuous trace segment, linkable.
Definition libmseed.h:579
ms_crc32c
uint32_t ms_crc32c(const uint8_t *input, int length, uint32_t previousCRC32C)
ms_encoding_sizetype
int ms_encoding_sizetype(uint8_t encoding, uint8_t *samplesize, char *sampletype)
Return sample size and/or type for given encoding value.
Definition lookup.c:74
ms_samplesize
uint8_t ms_samplesize(char sampletype)
Determine data sample size for each type.
Definition lookup.c:39
ms_bigendianhost
int ms_bigendianhost(void)
Runtime test for host endianess.
Definition genutils.c:1741
lmp_nanosleep
uint64_t lmp_nanosleep(uint64_t nanoseconds)
Definition genutils.c:1967
ms_sampletime
nstime_t ms_sampletime(nstime_t time, int64_t offset, double samprate)
Calculate the time of a sample in an array.
Definition genutils.c:1700
lmp_fseek64
int lmp_fseek64(FILE *stream, int64_t offset, int whence)
Definition genutils.c:1944
lmp_ftell64
int64_t lmp_ftell64(FILE *stream)
Definition genutils.c:1927
ms_encodingstr
const char * ms_encodingstr(uint8_t encoding)
Descriptive string for data encodings.
Definition lookup.c:126
ms_errorstr
const char * ms_errorstr(int errorcode)
Descriptive string for library Return codes.
Definition lookup.c:205
lmp_systemtime
nstime_t lmp_systemtime(void)
Definition genutils.c:1999
flag
int8_t flag
Definition libmseed.h:1386
LM_SIDLEN
#define LM_SIDLEN
Length of source ID string.
Definition libmseed.h:142
DEPRECATED
#define DEPRECATED
Definition libmseed.h:212
LMIO
Type definition for data source I/O: file-system versus URL.
Definition libmseed.h:726
LMIO::handle
void * handle
Primary IO handle, either file or URL.
Definition libmseed.h:734
LMIO::handle2
void * handle2
Secondary IO handle for URL.
Definition libmseed.h:735
LMIO::still_running
int still_running
Fetch status flag for URL transmissions.
Definition libmseed.h:736
LMIO::type
enum LMIO::@254045037044215310213377126306215005316170340112 type
IO handle type.
LMIO::LMIO_FD
@ LMIO_FD
IO handle is a provided file descriptor.
Definition libmseed.h:732
LMIO::LMIO_URL
@ LMIO_URL
IO handle is URL-type.
Definition libmseed.h:731
LMIO::LMIO_NULL
@ LMIO_NULL
IO handle type is undefined.
Definition libmseed.h:729
LMIO::LMIO_FILE
@ LMIO_FILE
IO handle is FILE-type.
Definition libmseed.h:730