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

NAME

6       ms_readleapseconds - Read a leap second file into a global buffer
7
8

SYNOPSIS

10       #include <libmseed.h>
11
12       int  ms_readleapseconds ( char *envvarname );
13
14       int  ms_readleapsecondfile ( char *filename );
15
16

DESCRIPTION

18       These  functions read a leap seconds file and store a list of leap sec‐
19       onds in an internal, global list.  The leap seconds are used to  deter‐
20       mine  the  proper  end time of a record (and consquently a trace).  The
21       use of this facility causes the leap second  indication  in  the  fixed
22       section data header to be ignored.
23
24       The  ms_readleapseconds  function  takes  and environment variable name
25       that is expected to contain the name  of  a  leap  seconds  file.   The
26       ms_readleapsecondfile function takes the name of a leap second file.
27
28

LEAP SECOND LIST FILE

30       The  leap second list file is expected to contain a list of leap second
31       times and TAI-UTC difference values.  The first column should  be  time
32       stamps as seconds since the NTP epoch (Jan. 1 1900).  The second column
33       should be an integer number of  seconds  that  specify  the  difference
34       between TAI and UTC.
35
36       Usually  the  most  recent  version  of  this  file  is available here:
37       https://www.ietf.org/timezones/data/leap-seconds.list
38
39

RETURN VALUES

41       ms_readleapseconds returns the number of leap seconds read on  success,
42       -1 on file read errors and -2 when the environment variable is not set.
43
44       ms_readleapsecondfile  returns  the number leap seconds read on success
45       and -1 on errors.
46
47

AUTHOR

49       Chad Trabant
50       IRIS Data Management Center
51
52
53
54Libmseed API                      2016/10/01             MS_READLEAPSECONDS(3)