libmseed 3.4.1
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{
30#endif
31
32#define LIBMSEED_VERSION "3.4.1"
33#define LIBMSEED_RELEASE "2026.167"
34
46
59
60/* C99 standard headers */
61#include <ctype.h>
62#include <math.h>
63#include <stdarg.h>
64#include <stdio.h>
65#include <stdlib.h>
66#include <string.h>
67#include <time.h>
68
71#define PRIsize_t "zu"
72
73#if defined(WIN32) || defined(_WIN32) || defined(WIN64) || defined(_WIN64)
74#define LMP_WIN 1
75#endif
76
77/* Set platform specific features, Windows versus everything else */
78#if defined(LMP_WIN)
79#include <sys/timeb.h>
80#include <sys/types.h>
81#include <windows.h>
82#include <io.h>
83
84/* Re-define print conversion for size_t values */
85#undef PRIsize_t
86#if defined(WIN64) || defined(_WIN64)
87#define PRIsize_t "I64u"
88#else
89#define PRIsize_t "I32u"
90#endif
91
92/* For MSVC 2012 and earlier define standard int types, otherwise use inttypes.h */
93#if defined(_MSC_VER) && _MSC_VER <= 1700
94typedef signed char int8_t;
95typedef unsigned char uint8_t;
96typedef signed short int int16_t;
97typedef unsigned short int uint16_t;
98typedef signed int int32_t;
99typedef unsigned int uint32_t;
100typedef signed __int64 int64_t;
101typedef unsigned __int64 uint64_t;
102#else
103#include <inttypes.h>
104#endif
105
106/* For MSVC define PRId64 and SCNd64 and alternate functions */
107#if defined(_MSC_VER)
108#if !defined(PRId64)
109#define PRId64 "I64d"
110#endif
111#if !defined(SCNd64)
112#define SCNd64 "I64d"
113#endif
114
115#define snprintf _snprintf
116#define vsnprintf _vsnprintf
117#define strtoull _strtoui64
118#define fileno _fileno
119#define dup _dup
120#define dup2 _dup2
121#define close _close
122#define fdopen _fdopen
123#endif
124
125/* Extras needed for MinGW */
126#if defined(__MINGW32__) || defined(__MINGW64__)
127#include <fcntl.h>
128
129#define _fseeki64 fseeko64
130#define _ftelli64 ftello64
131
132#define fstat _fstat
133#define stat _stat
134#endif
135#else
136/* All other platforms */
137#include <inttypes.h>
138#include <sys/time.h>
139#include <unistd.h>
140#endif
141
142#define MINRECLEN 40
143#define MAXRECLEN 10485760
144#define MAXRECLENv2 131172
145
146#define LM_SIDLEN 64
147
150#define MS_ISRATETOLERABLE(A, B) (fabs (1.0 - ((A) / (B))) < 0.0001)
151
154#define MS2_ISDATAINDICATOR(X) ((X) == 'D' || (X) == 'R' || (X) == 'Q' || (X) == 'M')
155
172#define MS3_ISVALIDHEADER(X) \
173 (*(X) == 'M' && *((X) + 1) == 'S' && *((X) + 2) == 3 && (uint8_t)(*((X) + 12)) >= 0 && \
174 (uint8_t)(*((X) + 12)) <= 23 && (uint8_t)(*((X) + 13)) >= 0 && (uint8_t)(*((X) + 13)) <= 59 && \
175 (uint8_t)(*((X) + 14)) >= 0 && (uint8_t)(*((X) + 14)) <= 60)
176
193#define MS2_ISVALIDHEADER(X) \
194 ((isdigit ((uint8_t)*(X)) || *(X) == ' ' || !*(X)) && \
195 (isdigit ((uint8_t)*((X) + 1)) || *((X) + 1) == ' ' || !*((X) + 1)) && \
196 (isdigit ((uint8_t)*((X) + 2)) || *((X) + 2) == ' ' || !*((X) + 2)) && \
197 (isdigit ((uint8_t)*((X) + 3)) || *((X) + 3) == ' ' || !*((X) + 3)) && \
198 (isdigit ((uint8_t)*((X) + 4)) || *((X) + 4) == ' ' || !*((X) + 4)) && \
199 (isdigit ((uint8_t)*((X) + 5)) || *((X) + 5) == ' ' || !*((X) + 5)) && \
200 MS2_ISDATAINDICATOR (*((X) + 6)) && (*((X) + 7) == ' ' || *((X) + 7) == '\0') && \
201 (uint8_t)(*((X) + 24)) >= 0 && (uint8_t)(*((X) + 24)) <= 23 && (uint8_t)(*((X) + 25)) >= 0 && \
202 (uint8_t)(*((X) + 25)) <= 59 && (uint8_t)(*((X) + 26)) >= 0 && (uint8_t)(*((X) + 26)) <= 60)
203
205#define bit(x, y) ((x) & (y)) ? 1 : 0
206
208#ifdef _MSC_VER
209#define DEPRECATED __declspec (deprecated)
210#elif defined(__GNUC__) | defined(__clang__)
211#define DEPRECATED __attribute__ ((__deprecated__))
212#else
213#define DEPRECATED
214#endif
215
223
229typedef int64_t nstime_t;
230
234#define NSTMODULUS 1000000000
235
239#define NSTERROR -2145916800000000000LL
240
244#define NSTUNSET -2145916799999999999LL
245
248#define MS_EPOCH2NSTIME(X) (X) * (nstime_t)NSTMODULUS
249
252#define MS_NSTIME2EPOCH(X) (X) / NSTMODULUS
253
261#define MS_HPTIME2NSTIME(X) (X) * (nstime_t)1000
262
270#define MS_NSTIME2HPTIME(X) (X) / 1000
271
290typedef enum
291{
292 ISOMONTHDAY = 0,
293 ISOMONTHDAY_Z = 1,
294 ISOMONTHDAY_DOY = 2,
295 ISOMONTHDAY_DOY_Z = 3,
296 ISOMONTHDAY_SPACE = 4,
297 ISOMONTHDAY_SPACE_Z = 5,
298 SEEDORDINAL = 6,
299 UNIXEPOCH = 7,
300 NANOSECONDEPOCH = 8
301} ms_timeformat_t;
302
317typedef enum
318{
319 NONE = 0,
320 MICRO = 1,
321 NANO = 2,
322 MICRO_NONE = 3,
323 NANO_NONE = 4,
324 NANO_MICRO = 5,
325 NANO_MICRO_NONE = 6
326} ms_subseconds_t;
327
328extern int ms_nstime2time (nstime_t nstime, uint16_t *year, uint16_t *yday, uint8_t *hour,
329 uint8_t *min, uint8_t *sec, uint32_t *nsec);
330extern char *ms_nstime2timestr_n (nstime_t nstime, char *timestr, size_t timestrsize,
331 ms_timeformat_t timeformat, ms_subseconds_t subsecond);
332DEPRECATED extern char *ms_nstime2timestr (nstime_t nstime, char *timestr,
333 ms_timeformat_t timeformat, ms_subseconds_t subsecond);
334DEPRECATED extern char *ms_nstime2timestrz (nstime_t nstime, char *timestr,
335 ms_timeformat_t timeformat, ms_subseconds_t subsecond);
336extern nstime_t ms_time2nstime (int year, int yday, int hour, int min, int sec, uint32_t nsec);
337extern nstime_t ms_timestr2nstime (const char *timestr);
338extern nstime_t ms_mdtimestr2nstime (const char *timestr);
339extern nstime_t ms_seedtimestr2nstime (const char *seedtimestr);
340extern int ms_doy2md (int year, int yday, int *month, int *mday);
341extern int ms_md2doy (int year, int month, int mday, int *yday);
342
344
354
358#define MS_PACK_DEFAULT_RECLEN 4096
359
363#define MS_PACK_DEFAULT_ENCODING DE_STEIM2
364
368
370typedef struct MS3Record
371{
372 const char *record;
373 int32_t reclen;
374 uint8_t swapflag;
375
376 /* Common header fields in accessible form */
377 char sid[LM_SIDLEN];
378 uint8_t formatversion;
379 uint8_t flags;
380 nstime_t starttime;
381 double samprate;
382 int16_t encoding;
383 uint8_t pubversion;
384 int64_t samplecnt;
385 uint32_t crc;
386 uint16_t extralength;
387 uint32_t datalength;
388 char *extra;
389
390 /* Data sample fields */
391 void *datasamples;
392 uint64_t datasize;
393 int64_t numsamples;
394 char sampletype;
395} MS3Record;
396
400#define MS3Record_INITIALIZER \
401 {.record = NULL, \
402 .reclen = -1, \
403 .swapflag = 0, \
404 .sid = {0}, \
405 .formatversion = 0, \
406 .flags = 0, \
407 .starttime = NSTUNSET, \
408 .samprate = 0.0, \
409 .encoding = -1, \
410 .pubversion = 0, \
411 .samplecnt = -1, \
412 .crc = 0, \
413 .extralength = 0, \
414 .datalength = 0, \
415 .extra = NULL, \
416 .datasamples = NULL, \
417 .datasize = 0, \
418 .numsamples = 0, \
419 .sampletype = 0}
420
421extern int msr3_parse (const char *record, uint64_t recbuflen, MS3Record **ppmsr, uint32_t flags,
422 int8_t verbose);
423
424extern int msr3_pack (const MS3Record *msr, void (*record_handler) (char *, int, void *),
425 void *handlerdata, int64_t *packedsamples, uint32_t flags, int8_t verbose);
426
428typedef struct MS3RecordPacker MS3RecordPacker;
429
430extern MS3RecordPacker *msr3_pack_init (const MS3Record *msr, uint32_t flags, int8_t verbose);
431extern int msr3_pack_next (MS3RecordPacker *packer, char **record, int32_t *reclen);
432extern void msr3_pack_free (MS3RecordPacker **packer, int64_t *packedsamples);
433
434extern int msr3_repack_mseed3 (const MS3Record *msr, char *record, uint32_t recbuflen,
435 int8_t verbose);
436
437extern int msr3_repack_mseed2 (const MS3Record *msr, char *record, uint32_t recbuflen,
438 int8_t verbose);
439
440extern int msr3_pack_header3 (const MS3Record *msr, char *record, uint32_t recbuflen,
441 int8_t verbose);
442
443extern int msr3_pack_header2 (const MS3Record *msr, char *record, uint32_t recbuflen,
444 int8_t verbose);
445
446extern int64_t msr3_unpack_data (MS3Record *msr, int8_t verbose);
447
448extern int msr3_data_bounds (const MS3Record *msr, uint32_t *dataoffset, uint32_t *datasize);
449
450extern int64_t ms_decode_data (const void *input, uint64_t inputsize, uint8_t encoding,
451 uint64_t samplecount, void *output, uint64_t outputsize,
452 char *sampletype, int8_t swapflag, const char *sid, int8_t verbose);
453
454extern MS3Record *msr3_init (MS3Record *msr);
455extern void msr3_free (MS3Record **ppmsr);
456extern MS3Record *msr3_duplicate (const MS3Record *msr, int8_t datadup);
457extern nstime_t msr3_endtime (const MS3Record *msr);
458extern void msr3_print (const MS3Record *msr, int8_t details);
459extern int msr3_resize_buffer (MS3Record *msr);
460extern double msr3_sampratehz (const MS3Record *msr);
461extern nstime_t msr3_nsperiod (const MS3Record *msr);
462extern double msr3_host_latency (const MS3Record *msr);
463
464extern int64_t ms3_detect (const char *record, uint64_t recbuflen, uint8_t *formatversion);
465extern int ms_parse_raw3 (const char *record, int maxreclen, int8_t details);
466extern int ms_parse_raw2 (const char *record, int maxreclen, int8_t details, int8_t swapflag);
468
484
492
494typedef struct MS3Selections
495{
496 char sidpattern[100];
497 struct MS3SelectTime *timewindows;
498 struct MS3Selections *next;
499 uint8_t pubversion;
500} MS3Selections;
501
502extern const MS3Selections *ms3_matchselect (const MS3Selections *selections, const char *sid,
503 nstime_t starttime, nstime_t endtime, int pubversion,
504 const MS3SelectTime **ppselecttime);
505extern const MS3Selections *msr3_matchselect (const MS3Selections *selections, const MS3Record *msr,
506 const MS3SelectTime **ppselecttime);
507extern int ms3_addselect (MS3Selections **ppselections, const char *sidpattern, nstime_t starttime,
508 nstime_t endtime, uint8_t pubversion);
509extern int ms3_addselect_comp (MS3Selections **ppselections, char *network, char *station,
510 char *location, char *channel, nstime_t starttime, nstime_t endtime,
511 uint8_t pubversion);
512extern int ms3_readselectionsfile (MS3Selections **ppselections, const char *filename);
513extern void ms3_freeselections (MS3Selections *selections);
514extern void ms3_printselections (const MS3Selections *selections);
516
519
546typedef struct MS3RecordPtr
547{
548 const char *bufferptr;
549 FILE *fileptr;
550 const char *filename;
551 int64_t fileoffset;
552 MS3Record *msr;
553 nstime_t endtime;
554 uint32_t dataoffset;
555 void *prvtptr;
556 struct MS3RecordPtr *next;
557} MS3RecordPtr;
558
566
568
603
605#define MSTRACEID_SKIPLIST_HEIGHT 8
606
624
640
642typedef struct MS3TraceList
643{
644 uint32_t numtraceids;
645 struct MS3TraceID traces;
646 uint64_t prngstate;
647} MS3TraceList;
648
674typedef struct MS3Tolerance
675{
676 double (*time) (const MS3Record *msr);
677 double (*samprate) (
678 const MS3Record *msr);
679} MS3Tolerance;
680
683#define MS3Tolerance_INITIALIZER {.time = NULL, .samprate = NULL}
684
685extern MS3TraceList *mstl3_init (MS3TraceList *mstl);
686extern void mstl3_free (MS3TraceList **ppmstl, int8_t freeprvtptr);
687extern MS3TraceID *mstl3_findID (MS3TraceList *mstl, const char *sid, uint8_t pubversion,
688 MS3TraceID **prev);
689
690extern MS3TraceSeg *mstl3_addmsr (MS3TraceList *mstl, const MS3Record *msr, int8_t splitversion,
691 int8_t autoheal, uint32_t flags, const MS3Tolerance *tolerance);
692extern MS3TraceSeg *mstl3_addmsr_recordptr (MS3TraceList *mstl, const MS3Record *msr,
693 MS3RecordPtr **pprecptr, int8_t splitversion,
694 int8_t autoheal, uint32_t flags,
695 const MS3Tolerance *tolerance);
696extern int64_t mstl3_readbuffer (MS3TraceList **ppmstl, const char *buffer, uint64_t bufferlength,
697 int8_t splitversion, uint32_t flags, const MS3Tolerance *tolerance,
698 int8_t verbose);
699extern int64_t mstl3_readbuffer_selection (MS3TraceList **ppmstl, const char *buffer,
700 uint64_t bufferlength, int8_t splitversion,
701 uint32_t flags, const MS3Tolerance *tolerance,
702 const MS3Selections *selections, int8_t verbose);
703extern int64_t mstl3_unpack_recordlist (MS3TraceID *id, MS3TraceSeg *seg, void *output,
704 uint64_t outputsize, int8_t verbose);
705extern int mstl3_convertsamples (MS3TraceSeg *seg, char type, int8_t truncate);
706extern int mstl3_resize_buffers (MS3TraceList *mstl);
707extern int64_t mstl3_pack (MS3TraceList *mstl, void (*record_handler) (char *, int, void *),
708 void *handlerdata, int reclen, int8_t encoding, int64_t *packedsamples,
709 uint32_t flags, int8_t verbose, char *extra);
710
712typedef struct MS3TraceListPacker MS3TraceListPacker;
713
714extern MS3TraceListPacker *mstl3_pack_init (MS3TraceList *mstl, int reclen, int8_t encoding,
715 uint32_t flags, int8_t verbose, char *extra,
716 uint32_t flush_idle_seconds);
717extern int mstl3_pack_next (MS3TraceListPacker *packer, uint32_t flags, char **record, int32_t *reclen);
718extern void mstl3_pack_free (MS3TraceListPacker **packer, int64_t *packedsamples);
719
720extern int64_t mstl3_pack_ppupdate_flushidle (MS3TraceList *mstl,
721 void (*record_handler) (char *, int, void *),
722 void *handlerdata, int reclen, int8_t encoding,
723 int64_t *packedsamples, uint32_t flags,
724 int8_t verbose, char *extra,
725 uint32_t flush_idle_seconds);
726
727extern int64_t mstl3_pack_segment (MS3TraceList *mstl, MS3TraceID *id, MS3TraceSeg *seg,
728 void (*record_handler) (char *, int, void *), void *handlerdata,
729 int reclen, int8_t encoding, int64_t *packedsamples,
730 uint32_t flags, int8_t verbose, char *extra);
731DEPRECATED extern int64_t mstraceseg3_pack (MS3TraceID *, MS3TraceSeg *,
732 void (*) (char *, int, void *), void *, int, int8_t,
733 int64_t *, uint32_t, int8_t, char *);
734extern void mstl3_printtracelist (const MS3TraceList *mstl, ms_timeformat_t timeformat,
735 int8_t details, int8_t gaps, int8_t versions);
736extern void mstl3_printsynclist (const MS3TraceList *mstl, const char *dccid,
737 ms_subseconds_t subseconds);
738extern void mstl3_printgaplist (const MS3TraceList *mstl, ms_timeformat_t timeformat,
739 double *mingap, double *maxgap);
741
774
776typedef struct LMIO
777{
778 enum
779 {
780 LMIO_NULL = 0,
781 LMIO_FILE = 1,
782 LMIO_URL = 2,
783 LMIO_FD = 3
784 } type;
785 void *handle;
786 void *handle2;
787 int still_running;
788} LMIO;
789
792#define LMIO_INITIALIZER {.type = LMIO_NULL, .handle = NULL, .handle2 = NULL, .still_running = 0}
793
801typedef struct MS3FileParam
802{
803 char path[512];
804 int64_t startoffset;
805 int64_t endoffset;
806 int64_t streampos;
807 int64_t recordcount;
808
809 char *readbuffer;
810 int readlength;
811 int readoffset;
812 uint32_t flags;
813 LMIO input;
814} MS3FileParam;
815
818#define MS3FileParam_INITIALIZER \
819 {.path = "", \
820 .startoffset = 0, \
821 .endoffset = 0, \
822 .streampos = 0, \
823 .recordcount = 0, \
824 .readbuffer = NULL, \
825 .readlength = 0, \
826 .readoffset = 0, \
827 .flags = 0, \
828 .input = LMIO_INITIALIZER}
829
830extern int ms3_readmsr (MS3Record **ppmsr, const char *mspath, uint32_t flags, int8_t verbose);
831extern int ms3_readmsr_r (MS3FileParam **ppmsfp, MS3Record **ppmsr, const char *mspath,
832 uint32_t flags, int8_t verbose);
833extern int ms3_readmsr_selection (MS3FileParam **ppmsfp, MS3Record **ppmsr, const char *mspath,
834 uint32_t flags, const MS3Selections *selections, int8_t verbose);
835extern int ms3_readtracelist (MS3TraceList **ppmstl, const char *mspath,
836 const MS3Tolerance *tolerance, int8_t splitversion, uint32_t flags,
837 int8_t verbose);
838extern int ms3_readtracelist_timewin (MS3TraceList **ppmstl, const char *mspath,
839 const MS3Tolerance *tolerance, nstime_t starttime,
840 nstime_t endtime, int8_t splitversion, uint32_t flags,
841 int8_t verbose);
842extern int ms3_readtracelist_selection (MS3TraceList **ppmstl, const char *mspath,
843 const MS3Tolerance *tolerance,
844 const MS3Selections *selections, int8_t splitversion,
845 uint32_t flags, int8_t verbose);
846extern int ms3_url_useragent (const char *program, const char *version);
847extern int ms3_url_userpassword (const char *userpassword);
848extern int ms3_url_addheader (const char *header);
849extern void ms3_url_freeheaders (void);
850extern int64_t msr3_writemseed (MS3Record *msr, const char *mspath, int8_t overwrite,
851 uint32_t flags, int8_t verbose);
852extern int64_t mstl3_writemseed (MS3TraceList *mstl, const char *mspath, int8_t overwrite,
853 int maxreclen, int8_t encoding, uint32_t flags, int8_t verbose);
854extern int libmseed_url_support (void);
855extern MS3FileParam *ms3_msfp_init (int64_t startoffset, int64_t endoffset, int fd);
856extern MS3FileParam *ms3_msfp_init_fd (int fd);
858#define ms3_mstl_init_fd(fd) ms3_msfp_init_fd(fd)
860
870extern int ms_sid2nslc_n (const char *sid, char *net, size_t netsize, char *sta, size_t stasize,
871 char *loc, size_t locsize, char *chan, size_t chansize);
872DEPRECATED extern int ms_sid2nslc (const char *sid, char *net, char *sta, char *loc, char *chan);
873extern int ms_nslc2sid (char *sid, int sidlen, uint16_t flags, const char *net, const char *sta,
874 const char *loc, const char *chan);
875extern int ms_seedchan2xchan (char *xchan, const char *seedchan);
876extern int ms_xchan2seedchan (char *seedchan, const char *xchan);
877extern int ms_strncpclean (char *dest, const char *source, int length);
878extern int ms_strncpcleantail (char *dest, const char *source, int length);
879extern int ms_strncpopen (char *dest, const char *source, int length);
881
910
936
970
990
1006
1012typedef struct LM_PARSED_JSON_s LM_PARSED_JSON;
1013
1014extern int mseh_get_ptr_type (const MS3Record *msr, const char *ptr, LM_PARSED_JSON **parsestate);
1015
1018#define mseh_get(msr, ptr, valueptr, type, maxlength) \
1019 mseh_get_ptr_r (msr, ptr, valueptr, type, maxlength, NULL)
1020
1023#define mseh_get_uint64(msr, ptr, valueptr) mseh_get_ptr_r (msr, ptr, valueptr, 'u', 0, NULL)
1024
1027#define mseh_get_int64(msr, ptr, valueptr) mseh_get_ptr_r (msr, ptr, valueptr, 'i', 0, NULL)
1028
1031#define mseh_get_number(msr, ptr, valueptr) mseh_get_ptr_r (msr, ptr, valueptr, 'n', 0, NULL)
1032
1035#define mseh_get_string(msr, ptr, buffer, maxlength) \
1036 mseh_get_ptr_r (msr, ptr, buffer, 's', maxlength, NULL)
1037
1040#define mseh_get_boolean(msr, ptr, valueptr) mseh_get_ptr_r (msr, ptr, valueptr, 'b', 0, NULL)
1041
1044#define mseh_exists(msr, ptr) (!mseh_get_ptr_r (msr, ptr, NULL, 0, 0, NULL))
1045
1046extern int mseh_get_ptr_r (const MS3Record *msr, const char *ptr, void *value, char type,
1047 uint32_t maxlength, LM_PARSED_JSON **parsestate);
1048
1051#define mseh_set(msr, ptr, valueptr, type) mseh_set_ptr_r (msr, ptr, valueptr, type, NULL)
1052
1055#define mseh_set_uint64(msr, ptr, valueptr) mseh_set_ptr_r (msr, ptr, valueptr, 'u', NULL)
1056
1059#define mseh_set_int64(msr, ptr, valueptr) mseh_set_ptr_r (msr, ptr, valueptr, 'i', NULL)
1060
1063#define mseh_set_number(msr, ptr, valueptr) mseh_set_ptr_r (msr, ptr, valueptr, 'n', NULL)
1064
1067#define mseh_set_string(msr, ptr, valueptr) mseh_set_ptr_r (msr, ptr, valueptr, 's', NULL)
1068
1071#define mseh_set_boolean(msr, ptr, valueptr) mseh_set_ptr_r (msr, ptr, valueptr, 'b', NULL)
1072
1073extern int mseh_set_ptr_r (MS3Record *msr, const char *ptr, void *value, char type,
1074 LM_PARSED_JSON **parsestate);
1075
1076extern int mseh_add_event_detection_r (MS3Record *msr, const char *ptr,
1077 MSEHEventDetection *eventdetection,
1078 LM_PARSED_JSON **parsestate);
1079
1080extern int mseh_add_calibration_r (MS3Record *msr, const char *ptr, MSEHCalibration *calibration,
1081 LM_PARSED_JSON **parsestate);
1082
1083extern int mseh_add_timing_exception_r (MS3Record *msr, const char *ptr,
1084 MSEHTimingException *exception,
1085 LM_PARSED_JSON **parsestate);
1086
1087extern int mseh_add_recenter_r (MS3Record *msr, const char *ptr, MSEHRecenter *recenter,
1088 LM_PARSED_JSON **parsestate);
1089
1090extern int mseh_serialize (MS3Record *msr, LM_PARSED_JSON **parsestate);
1091extern void mseh_free_parsestate (LM_PARSED_JSON **parsestate);
1092extern int mseh_replace (MS3Record *msr, char *jsonstring);
1093
1094extern int mseh_print (const MS3Record *msr, int indent);
1096
1123
1201
1203#define MAX_LOG_MSG_LENGTH 200
1204
1208typedef struct MSLogEntry
1209{
1210 int level;
1211 char function[30];
1212 char message[MAX_LOG_MSG_LENGTH];
1213 struct MSLogEntry *next;
1214} MSLogEntry;
1215
1219typedef struct MSLogRegistry
1220{
1221 int maxmessages;
1222 int messagecnt;
1223 MSLogEntry *messages;
1224} MSLogRegistry;
1225
1228#define MSLogRegistry_INITIALIZER {.maxmessages = 0, .messagecnt = 0, .messages = NULL}
1229
1235typedef struct MSLogParam
1236{
1237 void (*log_print) (const char *);
1238 const char *logprefix;
1239 void (*diag_print) (const char *);
1240 const char *errprefix;
1241 MSLogRegistry registry;
1242} MSLogParam;
1243
1246#define MSLogParam_INITIALIZER \
1247 {.log_print = NULL, \
1248 .logprefix = NULL, \
1249 .diag_print = NULL, \
1250 .errprefix = NULL, \
1251 .registry = MSLogRegistry_INITIALIZER}
1252
1256#define ms_log(level, ...) ms_rlog (__func__, level, __VA_ARGS__)
1257
1261#define ms_log_l(logp, level, ...) ms_rlog_l (logp, __func__, level, __VA_ARGS__)
1262
1263#if defined(__GNUC__) || defined(__clang__)
1264__attribute__ ((__format__ (__printf__, 3, 4)))
1265#endif
1266extern int
1267ms_rlog (const char *function, int level, const char *format, ...);
1268#if defined(__GNUC__) || defined(__clang__)
1269__attribute__ ((__format__ (__printf__, 4, 5)))
1270#endif
1271extern int
1272ms_rlog_l (MSLogParam *logp, const char *function, int level, const char *format, ...);
1273
1276#define ms_loginit(log_print, logprefix, diag_print, errprefix) \
1277 ms_rloginit (log_print, logprefix, diag_print, errprefix, 0)
1278
1281#define ms_loginit_l(logp, log_print, logprefix, diag_print, errprefix) \
1282 ms_rloginit_l (logp, log_print, logprefix, diag_print, errprefix, 0)
1283
1284extern void ms_rloginit (void (*log_print) (const char *), const char *logprefix,
1285 void (*diag_print) (const char *), const char *errprefix, int maxmessages);
1286extern MSLogParam *ms_rloginit_l (MSLogParam *logp, void (*log_print) (const char *),
1287 const char *logprefix, void (*diag_print) (const char *),
1288 const char *errprefix, int maxmessages);
1289extern int ms_rlog_emit (MSLogParam *logp, int count, int context);
1290extern int ms_rlog_pop (MSLogParam *logp, char *message, size_t size, int context);
1291extern int ms_rlog_free (MSLogParam *logp);
1292
1294
1327typedef struct LeapSecond
1328{
1329 nstime_t leapsecond;
1330 int32_t TAIdelta;
1331 struct LeapSecond *next;
1332} LeapSecond;
1333
1335extern LeapSecond *leapsecondlist;
1336extern int ms_readleapseconds (const char *envvarname);
1337extern int ms_readleapsecondfile (const char *filename);
1339
1343
1344extern uint8_t ms_samplesize (char sampletype);
1345extern int ms_encoding_sizetype (uint8_t encoding, uint8_t *samplesize, char *sampletype);
1346extern const char *ms_encodingstr (uint8_t encoding);
1347extern const char *ms_errorstr (int errorcode);
1348
1349extern nstime_t ms_sampletime (nstime_t time, int64_t offset, double samprate);
1350extern int ms_bigendianhost (void);
1351
1353#define ms_dabs(val) fabs (val)
1354
1356extern int64_t lmp_ftell64 (FILE *stream);
1358extern int lmp_fseek64 (FILE *stream, int64_t offset, int whence);
1360extern uint64_t lmp_nanosleep (uint64_t nanoseconds);
1362extern nstime_t lmp_systemtime (void);
1364extern int lmp_strncasecmp (const char *s1, const char *s2, size_t n);
1365
1367extern uint32_t ms_crc32c (const uint8_t *input, int length, uint32_t previousCRC32C);
1368
1370static inline void
1371ms_gswap2 (void *data2)
1372{
1373 uint16_t dat;
1374
1375 memcpy (&dat, data2, 2);
1376
1377 dat = (uint16_t)(((dat & 0xff00) >> 8) | ((dat & 0x00ff) << 8));
1378
1379 memcpy (data2, &dat, 2);
1380}
1381
1383static inline void
1384ms_gswap4 (void *data4)
1385{
1386 uint32_t dat;
1387
1388 memcpy (&dat, data4, 4);
1389
1390 dat = ((dat & 0xff000000) >> 24) | ((dat & 0x000000ff) << 24) | ((dat & 0x00ff0000) >> 8) |
1391 ((dat & 0x0000ff00) << 8);
1392
1393 memcpy (data4, &dat, 4);
1394}
1395
1397static inline void
1398ms_gswap8 (void *data8)
1399{
1400 uint64_t dat;
1401
1402 memcpy (&dat, data8, sizeof (uint64_t));
1403
1404 dat = ((dat & 0xff00000000000000) >> 56) | ((dat & 0x00000000000000ff) << 56) |
1405 ((dat & 0x00ff000000000000) >> 40) | ((dat & 0x000000000000ff00) << 40) |
1406 ((dat & 0x0000ff0000000000) >> 24) | ((dat & 0x0000000000ff0000) << 24) |
1407 ((dat & 0x000000ff00000000) >> 8) | ((dat & 0x00000000ff000000) << 8);
1408
1409 memcpy (data8, &dat, sizeof (uint64_t));
1410}
1411
1412#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5) || defined(__clang__)
1414__attribute__ ((deprecated ("Use ms_gswap2 instead."))) static inline void
1415ms_gswap2a (void *data2)
1416{
1417 ms_gswap2 (data2);
1418}
1420__attribute__ ((deprecated ("Use ms_gswap4 instead."))) static inline void
1421ms_gswap4a (void *data4)
1422{
1423 ms_gswap4 (data4);
1424}
1426__attribute__ ((deprecated ("Use ms_gswap8 instead."))) static inline void
1427ms_gswap8a (void *data8)
1428{
1429 ms_gswap8 (data8);
1430}
1431#elif defined(_MSC_FULL_VER) && (_MSC_FULL_VER > 140050320)
1433__declspec (deprecated ("Use ms_gswap2 instead.")) static inline void
1434ms_gswap2a (void *data2)
1435{
1436 ms_gswap2 (data2);
1437}
1439__declspec (deprecated ("Use ms_gswap4 instead.")) static inline void
1440ms_gswap4a (void *data4)
1441{
1442 ms_gswap4 (data4);
1443}
1445__declspec (deprecated ("Use ms_gswap8 instead.")) static inline void
1446ms_gswap8a (void *data8)
1447{
1448 ms_gswap8 (data8);
1449}
1450#else
1452static inline void
1453ms_gswap2a (void *data2)
1454{
1455 ms_gswap2 (data2);
1456}
1458static inline void
1459ms_gswap4a (void *data4)
1460{
1461 ms_gswap4 (data4);
1462}
1464static inline void
1465ms_gswap8a (void *data8)
1466{
1467 ms_gswap8 (data8);
1468}
1469#endif
1470
1472
1474typedef int8_t flag;
1475
1498
1500typedef struct LIBMSEED_MEMORY
1501{
1502 void *(*malloc) (size_t);
1503 void *(*realloc) (void *, size_t);
1504 void (*free) (void *);
1505} LIBMSEED_MEMORY;
1506
1508extern LIBMSEED_MEMORY libmseed_memory;
1509
1523extern size_t libmseed_prealloc_block_size;
1524
1529extern void *libmseed_memory_prealloc (void *ptr, size_t size, size_t *currentsize);
1530
1532
1533#define DE_ASCII DE_TEXT
1534
1543#define DE_TEXT 0
1544#define DE_INT16 1
1545#define DE_INT32 3
1546#define DE_FLOAT32 4
1547#define DE_FLOAT64 5
1548#define DE_STEIM1 10
1549#define DE_STEIM2 11
1550#define DE_GEOSCOPE24 12
1551#define DE_GEOSCOPE163 13
1552#define DE_GEOSCOPE164 14
1553#define DE_CDSN 16
1554#define DE_SRO 30
1555#define DE_DWWSSN 32
1557
1564#define MSSWAP_HEADER 0x01
1565#define MSSWAP_PAYLOAD 0x02
1567
1573#define MS_ENDOFFILE 1
1574#define MS_NOERROR 0
1575#define MS_GENERROR -1
1576#define MS_NOTSEED -2
1577#define MS_WRONGLENGTH -3
1578#define MS_OUTOFRANGE -4
1579#define MS_UNKNOWNFORMAT -5
1580#define MS_STBADCOMPFLAG -6
1581#define MS_INVALIDCRC -7
1583
1591#define MSF_UNPACKDATA 0x0001
1592#define MSF_SKIPNOTDATA 0x0002
1593#define MSF_VALIDATECRC 0x0004
1594#define MSF_PNAMERANGE 0x0008
1595#define MSF_ATENDOFFILE 0x0010
1596#define MSF_SEQUENCE 0x0020
1597#define MSF_FLUSHDATA \
1598 0x0040
1599#define MSF_PACKVER2 0x0080
1600#define MSF_RECORDLIST 0x0100
1601#define MSF_MAINTAINMSTL 0x0200
1602#define MSF_PPUPDATETIME \
1603 0x0400
1604#define MSF_SPLITISVERSION \
1605 0x0800
1606#define MSF_SKIPADJACENTDUPLICATES 0x1000
1608
1609#ifdef __cplusplus
1610}
1611#endif
1612
1613#endif /* LIBMSEED_H */
MS3SelectTime::next
struct MS3SelectTime * next
Pointer to next selection time, NULL if the last.
Definition libmseed.h:490
MS3SelectTime::endtime
nstime_t endtime
Latest data for matching channels, use NSTUNSET for open.
Definition libmseed.h:489
MS3Selections::pubversion
uint8_t pubversion
Selected publication version, use 0 for any.
Definition libmseed.h:499
MS3Selections::sidpattern
char sidpattern[100]
Matching (globbing) pattern for source ID.
Definition libmseed.h:496
MS3Selections::next
struct MS3Selections * next
Pointer to next selection, NULL if the last.
Definition libmseed.h:498
MS3SelectTime::starttime
nstime_t starttime
Earliest data for matching channels, use NSTUNSET for open.
Definition libmseed.h:488
MS3Selections::timewindows
struct MS3SelectTime * timewindows
Pointer to time window list for this source ID.
Definition libmseed.h:497
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:185
ms3_readselectionsfile
int ms3_readselectionsfile(MS3Selections **ppselections, const char *filename)
Read data selections from a file.
Definition selection.c:431
ms3_printselections
void ms3_printselections(const MS3Selections *selections)
Print the selections list using the ms_log() facility.
Definition selection.c:706
ms3_freeselections
void ms3_freeselections(MS3Selections *selections)
Free all memory associated with a MS3Selections.
Definition selection.c:664
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:310
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:149
MS3SelectTime
Data selection structure time window definition containers.
Definition libmseed.h:487
MS3Selections
Data selection structure definition containers.
Definition libmseed.h:495
MSEHEventDetection::type
char type[30]
Definition libmseed.h:921
MSEHCalibration::duration
double duration
Definition libmseed.h:960
MSEHEventDetection::wave
char wave[30]
Definition libmseed.h:926
MSEHCalibration::inputchannel
char inputchannel[30]
Definition libmseed.h:963
MSEHEventDetection::next
struct MSEHEventDetection * next
Definition libmseed.h:934
MSEHEventDetection::signalperiod
double signalperiod
Definition libmseed.h:924
MSEHCalibration::amplituderange
char amplituderange[30]
Definition libmseed.h:958
MSEHCalibration::firstpulsepositive
int firstpulsepositive
Definition libmseed.h:952
MSEHEventDetection::onsettime
nstime_t onsettime
Definition libmseed.h:929
MSEHEventDetection::medlookback
int medlookback
Definition libmseed.h:932
MSEHTimingException::vcocorrection
float vcocorrection
Definition libmseed.h:982
MSEHCalibration::endtime
nstime_t endtime
Definition libmseed.h:950
MSEHCalibration::type
char type[30]
Definition libmseed.h:947
MSEHCalibration::next
struct MSEHCalibration * next
Definition libmseed.h:968
MSEHCalibration::continued
int continued
Definition libmseed.h:955
MSEHTimingException::clockstatus
char clockstatus[128]
Definition libmseed.h:988
MSEHEventDetection::signalamplitude
double signalamplitude
Definition libmseed.h:923
MSEHCalibration::stepbetween
double stepbetween
Definition libmseed.h:962
MSEHTimingException::count
uint32_t count
Definition libmseed.h:985
MSEHEventDetection::units
char units[30]
Definition libmseed.h:927
MSEHCalibration::alternatesign
int alternatesign
Definition libmseed.h:953
MSEHRecenter::type
char type[30]
Definition libmseed.h:1001
MSEHEventDetection::backgroundestimate
double backgroundestimate
Definition libmseed.h:925
MSEHTimingException::time
nstime_t time
Definition libmseed.h:981
MSEHCalibration::amplitude
double amplitude
Definition libmseed.h:956
MSEHCalibration::rolloff
char rolloff[30]
Definition libmseed.h:966
MSEHCalibration::trigger
char trigger[30]
Definition libmseed.h:954
MSEHCalibration::coupling
char coupling[30]
Definition libmseed.h:965
MSEHCalibration::steps
int steps
Definition libmseed.h:951
MSEHCalibration::noise
char noise[30]
Definition libmseed.h:967
MSEHRecenter::trigger
char trigger[30]
Definition libmseed.h:1004
MSEHCalibration::inputunits
char inputunits[30]
Definition libmseed.h:957
MSEHCalibration::sineperiod
double sineperiod
Definition libmseed.h:961
MSEHTimingException::usec
int usec
Definition libmseed.h:983
MSEHEventDetection::medsnr
uint8_t medsnr[6]
Definition libmseed.h:931
MSEHEventDetection::medpickalgorithm
int medpickalgorithm
Definition libmseed.h:933
MSEHTimingException::type
char type[16]
Definition libmseed.h:986
MSEHRecenter::begintime
nstime_t begintime
Definition libmseed.h:1002
MSEHCalibration::refamplitude
double refamplitude
Definition libmseed.h:964
MSEHEventDetection::detector
char detector[30]
Definition libmseed.h:922
MSEHRecenter::endtime
nstime_t endtime
Definition libmseed.h:1003
MSEHCalibration::begintime
nstime_t begintime
Definition libmseed.h:949
MSEHTimingException::receptionquality
int receptionquality
Definition libmseed.h:984
mseh_get_ptr_type
int mseh_get_ptr_type(const MS3Record *msr, const char *ptr, LM_PARSED_JSON **parsestate)
Search for and return the type of an extra header value.
Definition extraheaders.c:152
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:982
mseh_print
int mseh_print(const MS3Record *msr, int indent)
Print the extra header structure for the specified MS3Record.
Definition extraheaders.c:1329
mseh_serialize
int mseh_serialize(MS3Record *msr, LM_PARSED_JSON **parsestate)
Generate extra headers string (serialize) from internal state.
Definition extraheaders.c:1160
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:649
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:307
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:786
mseh_free_parsestate
void mseh_free_parsestate(LM_PARSED_JSON **parsestate)
Free internally parsed (deserialized) JSON data.
Definition extraheaders.c:1221
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:453
LM_PARSED_JSON
struct LM_PARSED_JSON_s LM_PARSED_JSON
Internal structure for holding parsed JSON extra headers.
Definition libmseed.h:1012
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:1074
mseh_replace
int mseh_replace(MS3Record *msr, char *jsonstring)
Replace extra headers with supplied JSON.
Definition extraheaders.c:1261
MSEHCalibration
Container for calibration parameters for use in extra headers.
Definition libmseed.h:946
MSEHEventDetection
Container for event detection parameters for use in extra headers.
Definition libmseed.h:920
MSEHRecenter
Container for recenter parameters for use in extra headers.
Definition libmseed.h:1000
MSEHTimingException
Container for timing exception parameters for use in extra headers.
Definition libmseed.h:980
MS3FileParam::readlength
int readlength
INTERNAL: Length of data in read buffer.
Definition libmseed.h:810
MS3FileParam::streampos
int64_t streampos
OUTPUT: Read position of input stream.
Definition libmseed.h:806
MS3FileParam::endoffset
int64_t endoffset
INPUT: End position in input stream, 0 == unknown (e.g. pipe).
Definition libmseed.h:805
MS3FileParam::recordcount
int64_t recordcount
OUTPUT: Count of records read from this stream/file so far.
Definition libmseed.h:807
MS3FileParam::input
LMIO input
INTERNAL: IO handle, file or URL.
Definition libmseed.h:813
MS3FileParam::flags
uint32_t flags
INTERNAL: Stream reading state flags.
Definition libmseed.h:812
MS3FileParam::path
char path[512]
INPUT: File name or URL.
Definition libmseed.h:803
MS3FileParam::readoffset
int readoffset
INTERNAL: Read offset in read buffer.
Definition libmseed.h:811
MS3FileParam::readbuffer
char * readbuffer
INTERNAL: Read buffer, allocated internally.
Definition libmseed.h:809
MS3FileParam::startoffset
int64_t startoffset
INPUT: Start position in input stream.
Definition libmseed.h:804
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:692
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:784
ms3_url_freeheaders
void ms3_url_freeheaders(void)
Free all set headers for URL-based requests.
Definition fileutils.c:968
ms3_readmsr_r
int ms3_readmsr_r(MS3FileParam **ppmsfp, MS3Record **ppmsr, const char *mspath, uint32_t flags, int8_t verbose)
Definition fileutils.c:650
ms3_url_addheader
int ms3_url_addheader(const char *header)
Add header to any URL-based requests.
Definition fileutils.c:948
libmseed_url_support
int libmseed_url_support(void)
Run-time test for URL support in libmseed.
Definition fileutils.c:49
ms3_msfp_init_fd
MS3FileParam * ms3_msfp_init_fd(int fd)
Initialize MS3FileParam parameters for a file descriptor.
Definition fileutils.c:78
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:628
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:716
ms3_msfp_init
MS3FileParam * ms3_msfp_init(int64_t startoffset, int64_t endoffset, int fd)
Initialize MS3FileParam parameters.
Definition fileutils.c:109
ms3_readmsr_selection
int ms3_readmsr_selection(MS3FileParam **ppmsfp, MS3Record **ppmsr, const char *mspath, uint32_t flags, const MS3Selections *selections, int8_t verbose)
Definition fileutils.c:670
ms3_url_userpassword
int ms3_url_userpassword(const char *userpassword)
Set authentication credentials for URL-based requests.
Definition fileutils.c:919
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:1007
mstl3_writemseed
int64_t mstl3_writemseed(MS3TraceList *mstl, 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:1115
ms3_url_useragent
int ms3_url_useragent(const char *program, const char *version)
Set User-Agent header for URL-based requests.
Definition fileutils.c:889
MS3FileParam
State container for reading miniSEED records from files or URLs.
Definition libmseed.h:802
LeapSecond::TAIdelta
int32_t TAIdelta
TAI-UTC difference in seconds.
Definition libmseed.h:1330
LeapSecond::leapsecond
nstime_t leapsecond
Time of leap second as epoch since 1 January 1900.
Definition libmseed.h:1329
LeapSecond::next
struct LeapSecond * next
Pointer to next entry, NULL if the last.
Definition libmseed.h:1331
leapsecondlist
LeapSecond * leapsecondlist
ms_readleapsecondfile
int ms_readleapsecondfile(const char *filename)
Read leap second from the specified file.
Definition genutils.c:1876
ms_readleapseconds
int ms_readleapseconds(const char *envvarname)
Read leap second file specified by an environment variable.
Definition genutils.c:1847
LeapSecond
Leap second list container.
Definition libmseed.h:1328
MSLogParam::diag_print
void(* diag_print)(const char *)
Function to call for diagnostic and error messages.
Definition libmseed.h:1239
MSLogEntry::message
char message[MAX_LOG_MSG_LENGTH]
Log, warning or error message.
Definition libmseed.h:1212
MSLogEntry::function
char function[30]
Function generating the message.
Definition libmseed.h:1211
MSLogParam::log_print
void(* log_print)(const char *)
Function to call for regular messages.
Definition libmseed.h:1237
MSLogEntry::level
int level
Message level.
Definition libmseed.h:1210
MSLogParam::logprefix
const char * logprefix
Message prefix for regular and diagnostic messages.
Definition libmseed.h:1238
MSLogParam::errprefix
const char * errprefix
Message prefix for error messages.
Definition libmseed.h:1240
MSLogParam::registry
MSLogRegistry registry
Message registry.
Definition libmseed.h:1241
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:299
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:128
MAX_LOG_MSG_LENGTH
#define MAX_LOG_MSG_LENGTH
Definition libmseed.h:1203
ms_rlog_pop
int ms_rlog_pop(MSLogParam *logp, char *message, size_t size, int context)
Pop error and warning messages from log registry.
Definition logging.c:641
ms_rlog_free
int ms_rlog_free(MSLogParam *logp)
Free, without emitting, all messages from log registry.
Definition logging.c:693
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:88
ms_rlog
int ms_rlog(const char *function, int level, const char *format,...)
Register log message using global logging parameters.
Definition logging.c:247
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:564
MSLogEntry
Log registry entry.
Definition libmseed.h:1209
MSLogParam
Logging parameters. Callers should not modify these values directly and generally should not need to ...
Definition libmseed.h:1236
MSLogRegistry
Log message registry.
Definition libmseed.h:1220
LIBMSEED_MEMORY::free
void(* free)(void *)
Pointer to desired free().
Definition libmseed.h:1504
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:1501
MS3Record::swapflag
uint8_t swapflag
Byte swap indicator (bitmask), see Byte swap flags.
Definition libmseed.h:374
MS3Record::datasamples
void * datasamples
Data samples, numsamples of type sampletype.
Definition libmseed.h:391
MS3Record::datalength
uint32_t datalength
Length of data payload in bytes.
Definition libmseed.h:387
MS3Record::crc
uint32_t crc
CRC of entire record.
Definition libmseed.h:385
MS3Record::formatversion
uint8_t formatversion
Format major version.
Definition libmseed.h:378
MS3Record::reclen
int32_t reclen
Length of miniSEED record in bytes.
Definition libmseed.h:373
MS3Record::flags
uint8_t flags
Record-level bit flags.
Definition libmseed.h:379
MS3Record::extralength
uint16_t extralength
Length of extra headers in bytes.
Definition libmseed.h:386
MS3Record::datasize
uint64_t datasize
Size of datasamples buffer in bytes.
Definition libmseed.h:392
MS3Record::record
const char * record
Raw miniSEED record, if available.
Definition libmseed.h:372
MS3Record::samprate
double samprate
Nominal sample rate as samples/second (Hz) or period (s).
Definition libmseed.h:381
MS3Record::numsamples
int64_t numsamples
Number of data samples in datasamples.
Definition libmseed.h:393
MS3Record::samplecnt
int64_t samplecnt
Number of samples in record.
Definition libmseed.h:384
MS3Record::sampletype
char sampletype
Sample type code: t, i, f, d Sample Types.
Definition libmseed.h:394
MS3Record::encoding
int16_t encoding
Data encoding format, see Data Encodings.
Definition libmseed.h:382
MS3Record::starttime
nstime_t starttime
Record start time (first sample).
Definition libmseed.h:380
MS3Record::sid
char sid[LM_SIDLEN]
Source identifier as URN, max length LM_SIDLEN.
Definition libmseed.h:377
MS3Record::pubversion
uint8_t pubversion
Publication version.
Definition libmseed.h:383
MS3Record::extra
char * extra
Pointer to extra headers.
Definition libmseed.h:388
ms3_detect
int64_t ms3_detect(const char *record, uint64_t recbuflen, uint8_t *formatversion)
Detect miniSEED record in buffer.
Definition parseutils.c:175
msr3_pack_init
MS3RecordPacker * msr3_pack_init(const MS3Record *msr, uint32_t flags, int8_t verbose)
Initialize a packer for generator-style record creation.
Definition pack.c:180
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:638
MS3RecordPacker
struct MS3RecordPacker MS3RecordPacker
Opaque packing context for MS3Record generator-style interface.
Definition libmseed.h:428
msr3_print
void msr3_print(const MS3Record *msr, int8_t details)
Print header values of an MS3Record.
Definition msrutils.c:225
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:343
msr3_unpack_data
int64_t msr3_unpack_data(MS3Record *msr, int8_t verbose)
Unpack data samples for a MS3Record.
Definition unpack.c:1215
msr3_host_latency
double msr3_host_latency(const MS3Record *msr)
Calculate data latency based on the host time.
Definition msrutils.c:393
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:966
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:330
msr3_resize_buffer
int msr3_resize_buffer(MS3Record *msr)
Resize data sample buffer of MS3Record to what is needed.
Definition msrutils.c:301
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:1370
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:855
msr3_pack_next
int msr3_pack_next(MS3RecordPacker *packer, char **record, int32_t *reclen)
Generate next miniSEED record.
Definition pack.c:381
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
msr3_pack_free
void msr3_pack_free(MS3RecordPacker **packer, int64_t *packedsamples)
Free packer and resources.
Definition pack.c:600
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:534
msr3_nsperiod
nstime_t msr3_nsperiod(const MS3Record *msr)
Calculate sample period in nanoseconds/sample for a given MS3Record.
Definition msrutils.c:362
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:733
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:1102
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 using a callback function to handle the records.
Definition pack.c:113
MS3Record
miniSEED record container
Definition libmseed.h:371
MS3RecordPtr::next
struct MS3RecordPtr * next
Pointer to next entry, NULL if the last.
Definition libmseed.h:556
MS3RecordPtr::prvtptr
void * prvtptr
Private pointer, will not be populated by library but will be free'd.
Definition libmseed.h:555
MS3RecordList::last
MS3RecordPtr * last
Pointer to last entry, NULL if the none.
Definition libmseed.h:564
MS3RecordPtr::fileoffset
int64_t fileoffset
Offset into file to record for fileptr or filename.
Definition libmseed.h:551
MS3RecordPtr::filename
const char * filename
Pointer (borrowed) to file name containing record, NULL if not used.
Definition libmseed.h:550
MS3RecordList::first
MS3RecordPtr * first
Pointer to first entry, NULL if the none.
Definition libmseed.h:563
MS3RecordPtr::msr
MS3Record * msr
Pointer to MS3Record for this record.
Definition libmseed.h:552
MS3RecordPtr::bufferptr
const char * bufferptr
Pointer in buffer to record, NULL if not used.
Definition libmseed.h:548
MS3RecordPtr::fileptr
FILE * fileptr
Pointer to open FILE containing record, NULL if not used.
Definition libmseed.h:549
MS3RecordList::recordcnt
uint64_t recordcnt
Count of records in the list (for convenience).
Definition libmseed.h:562
MS3RecordPtr::endtime
nstime_t endtime
End time of record, time of last sample.
Definition libmseed.h:553
MS3RecordPtr::dataoffset
uint32_t dataoffset
Offset from start of record to encoded data.
Definition libmseed.h:554
MS3RecordList
Record list, holds MS3RecordPtr entries that contribute to a given MS3TraceSeg.
Definition libmseed.h:561
MS3RecordPtr
A miniSEED record pointer and metadata.
Definition libmseed.h:547
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:243
ms_strncpopen
int ms_strncpopen(char *dest, const char *source, int length)
Copy fixed number of characters into unterminated string.
Definition genutils.c:808
ms_sid2nslc
DEPRECATED int ms_sid2nslc(const char *sid, char *net, char *sta, char *loc, char *chan)
Definition genutils.c:360
ms_strncpclean
int ms_strncpclean(char *dest, const char *source, int length)
Copy string, removing spaces, always terminated.
Definition genutils.c:702
ms_xchan2seedchan
int ms_xchan2seedchan(char *seedchan, const char *xchan)
Convert extended channel to SEED 2.x channel.
Definition genutils.c:592
ms_seedchan2xchan
int ms_seedchan2xchan(char *xchan, const char *seedchan)
Convert SEED 2.x channel to extended channel.
Definition genutils.c:537
ms_strncpcleantail
int ms_strncpcleantail(char *dest, const char *source, int length)
Copy string, removing trailing spaces, always terminated.
Definition genutils.c:756
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:398
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:977
ms_timeformat_t
ms_timeformat_t
Time format identifiers.
Definition libmseed.h:291
ms_nstime2timestr
DEPRECATED char * ms_nstime2timestr(nstime_t nstime, char *timestr, ms_timeformat_t timeformat, ms_subseconds_t subsecond)
Definition genutils.c:1257
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:913
ms_subseconds_t
ms_subseconds_t
Subsecond format identifiers.
Definition libmseed.h:318
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:1568
ms_timestr2nstime
nstime_t ms_timestr2nstime(const char *timestr)
Convert a time string to a high precision epoch time.
Definition genutils.c:1415
ms_nstime2timestrz
DEPRECATED char * ms_nstime2timestrz(nstime_t nstime, char *timestr, ms_timeformat_t timeformat, ms_subseconds_t subsecond)
Definition genutils.c:1271
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:1681
nstime_t
int64_t nstime_t
libmseed time type, integer nanoseconds since the Unix/POSIX epoch (00:00:00 Thursday,...
Definition libmseed.h:229
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:1342
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:859
ms_nstime2timestr_n
char * ms_nstime2timestr_n(nstime_t nstime, char *timestr, size_t timestrsize, ms_timeformat_t timeformat, ms_subseconds_t subsecond)
Convert an nstime_t to a time string.
Definition genutils.c:1046
MS3TraceID::next
struct MS3TraceID * next[MSTRACEID_SKIPLIST_HEIGHT]
Next trace ID at first pointer, NULL if the last.
Definition libmseed.h:636
MS3TraceSeg::numsamples
int64_t numsamples
Number of data samples in datasamples.
Definition libmseed.h:616
MS3TraceSeg::recordlist
struct MS3RecordList * recordlist
List of pointers to records that contributed.
Definition libmseed.h:620
MS3TraceList::prngstate
uint64_t prngstate
INTERNAL: State for Pseudo RNG.
Definition libmseed.h:646
MS3TraceSeg::endtime
nstime_t endtime
Time of last sample.
Definition libmseed.h:611
MS3TraceID::first
struct MS3TraceSeg * first
Pointer to first of list of segments.
Definition libmseed.h:634
MS3TraceID::latest
nstime_t latest
Time of latest sample.
Definition libmseed.h:631
MS3TraceList::traces
struct MS3TraceID traces
Head node of trace skip list, first entry at traces.next[0].
Definition libmseed.h:645
MS3TraceID::pubversion
uint8_t pubversion
Largest contributing publication version.
Definition libmseed.h:629
MS3TraceSeg::prvtptr
void * prvtptr
Definition libmseed.h:618
MS3TraceID::height
uint8_t height
Height of skip list at next.
Definition libmseed.h:638
MS3TraceSeg::datasize
uint64_t datasize
Size of datasamples buffer in bytes.
Definition libmseed.h:615
MS3TraceID::earliest
nstime_t earliest
Time of earliest sample.
Definition libmseed.h:630
MS3Tolerance::samprate
double(* samprate)(const MS3Record *msr)
Pointer to function that returns sample rate tolerance.
Definition libmseed.h:677
MS3TraceID::prvtptr
void * prvtptr
Private pointer for general use, unused by library.
Definition libmseed.h:632
MS3TraceSeg::datasamples
void * datasamples
Data samples, numsamples of type sampletype.
Definition libmseed.h:614
MS3TraceSeg::sampletype
char sampletype
Sample type code, see Sample Types.
Definition libmseed.h:617
MS3TraceSeg::prev
struct MS3TraceSeg * prev
Pointer to previous segment.
Definition libmseed.h:621
MS3TraceSeg::samplecnt
int64_t samplecnt
Number of samples in trace coverage.
Definition libmseed.h:613
MS3TraceID::sid
char sid[LM_SIDLEN]
Source identifier as URN, max length LM_SIDLEN.
Definition libmseed.h:628
MS3TraceID::last
struct MS3TraceSeg * last
Pointer to last of list of segments.
Definition libmseed.h:635
MS3TraceList::numtraceids
uint32_t numtraceids
Number of traces IDs in list.
Definition libmseed.h:644
MS3Tolerance::time
double(* time)(const MS3Record *msr)
Pointer to function that returns time tolerance.
Definition libmseed.h:676
MS3TraceSeg::samprate
double samprate
Nominal sample rate (Hz).
Definition libmseed.h:612
MS3TraceSeg::next
struct MS3TraceSeg * next
Pointer to next segment, NULL if the last.
Definition libmseed.h:622
MS3TraceSeg::starttime
nstime_t starttime
Time of first sample.
Definition libmseed.h:610
MS3TraceID::numsegments
uint32_t numsegments
Number of segments for this ID.
Definition libmseed.h:633
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:1692
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:2936
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:2801
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:2116
mstl3_free
void mstl3_free(MS3TraceList **ppmstl, int8_t freeprvtptr)
Free all memory associated with a MS3TraceList.
Definition tracelist.c:102
mstl3_addmsr
MS3TraceSeg * mstl3_addmsr(MS3TraceList *mstl, const MS3Record *msr, int8_t splitversion, int8_t autoheal, uint32_t flags, const MS3Tolerance *tolerance)
Add data coverage from an MS3Record to a MS3TraceList.
Definition tracelist.c:787
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:851
mstl3_pack_next
int mstl3_pack_next(MS3TraceListPacker *packer, uint32_t flags, char **record, int32_t *reclen)
Generate next miniSEED record from trace list packing state.
Definition tracelist.c:2246
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:3016
mstl3_pack_segment
int64_t mstl3_pack_segment(MS3TraceList *mstl, 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:2623
mstl3_resize_buffers
int mstl3_resize_buffers(MS3TraceList *mstl)
Resize data sample buffers of MS3TraceList to what is needed.
Definition tracelist.c:1600
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:899
MS3TraceListPacker
struct MS3TraceListPacker MS3TraceListPacker
Opaque packing context for MS3TraceList generator-style interface.
Definition libmseed.h:712
mstl3_pack_ppupdate_flushidle
int64_t mstl3_pack_ppupdate_flushidle(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, uint32_t flush_idle_seconds)
Definition tracelist.c:2135
mstraceseg3_pack
DEPRECATED int64_t mstraceseg3_pack(MS3TraceID *, MS3TraceSeg *, void(*)(char *, int, void *), void *, int, int8_t, int64_t *, uint32_t, int8_t, char *)
Definition tracelist.c:2769
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:1444
mstl3_init
MS3TraceList * mstl3_init(MS3TraceList *mstl)
Initialize a MS3TraceList container.
Definition tracelist.c:67
MSTRACEID_SKIPLIST_HEIGHT
#define MSTRACEID_SKIPLIST_HEIGHT
Maximum skip list height for MSTraceIDs.
Definition libmseed.h:605
mstl3_findID
MS3TraceID * mstl3_findID(MS3TraceList *mstl, const char *sid, uint8_t pubversion, MS3TraceID **prev)
Find matching MS3TraceID in a MS3TraceList.
Definition tracelist.c:163
mstl3_pack_free
void mstl3_pack_free(MS3TraceListPacker **packer, int64_t *packedsamples)
Free trace list packing state and resources.
Definition tracelist.c:2548
mstl3_pack_init
MS3TraceListPacker * mstl3_pack_init(MS3TraceList *mstl, int reclen, int8_t encoding, uint32_t flags, int8_t verbose, char *extra, uint32_t flush_idle_seconds)
Initialize a packing state for generator-style trace list packing.
Definition tracelist.c:2179
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)
Definition tracelist.c:809
MS3Tolerance
Callback functions that return time and sample rate tolerances.
Definition libmseed.h:675
MS3TraceID
Container for a trace ID, linkable.
Definition libmseed.h:627
MS3TraceList
Container for a collection of continuous trace segment, linkable.
Definition libmseed.h:643
MS3TraceSeg
Container for a continuous trace segment, linkable.
Definition libmseed.h:609
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:1823
lmp_nanosleep
uint64_t lmp_nanosleep(uint64_t nanoseconds)
Sleep for a specified number of nanoseconds.
Definition genutils.c:2045
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:1784
lmp_fseek64
int lmp_fseek64(FILE *stream, int64_t offset, int whence)
Definition genutils.c:2023
lmp_ftell64
int64_t lmp_ftell64(FILE *stream)
Definition genutils.c:2007
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)
Return the current system time.
Definition genutils.c:2078
lmp_strncasecmp
int lmp_strncasecmp(const char *s1, const char *s2, size_t n)
Case-insensitive, ASCII-only string comparison.
Definition genutils.c:2125
flag
int8_t flag
Definition libmseed.h:1474
LM_SIDLEN
#define LM_SIDLEN
Length of source ID string.
Definition libmseed.h:146
DEPRECATED
#define DEPRECATED
Definition libmseed.h:213
LMIO
Type definition for data source I/O: file-system versus URL.
Definition libmseed.h:777
LMIO::handle
void * handle
Primary IO handle, either file or URL.
Definition libmseed.h:785
LMIO::handle2
void * handle2
Secondary IO handle for URL.
Definition libmseed.h:786
LMIO::still_running
int still_running
Fetch status flag for URL transmissions.
Definition libmseed.h:787
LMIO::type
enum LMIO::@254045037044215310213377126306215005316170340112 type
IO handle type.
LMIO::LMIO_FD
@ LMIO_FD
IO handle is a provided file descriptor.
Definition libmseed.h:783
LMIO::LMIO_URL
@ LMIO_URL
IO handle is URL-type.
Definition libmseed.h:782
LMIO::LMIO_NULL
@ LMIO_NULL
IO handle type is undefined.
Definition libmseed.h:780
LMIO::LMIO_FILE
@ LMIO_FILE
IO handle is FILE-type.
Definition libmseed.h:781