tz2alt(8)

1TS2ALT(8)                   System Manager's Manual                  TS2ALT(8)
2
3
4

NAME

6       tz2alt  -  Monitors daylight savings time changes and publishes them to
7       PTP stack.
8
9

SYNOPSIS

11       ts2alt [ -hmqv ] [ -f conf ] [ -k key ] [ -p period ] [ -w window  ]  [
12       -z timezone ] [ long-options ] ...
13
14

DESCRIPTION

16       tz2alt leverages the local time zone database to monitor for changes in
17       daylight savings time and publishes the  pending  changes  to  the  PTP
18       stack.
19
20

OPTIONS

22       -f config
23              Read  configuration  from  the specified file.  No configuration
24              file is read by default.
25
26       -h     Displays the command line help summary.
27
28       -l print-level
29              Sets the maximum  syslog  level  of  messages  which  should  be
30              printed  or  sent  to  the  system  logger.  The  default  is  6
31              (LOG_INFO).
32
33       -m     Prints log messages to the standard output.
34
35       -q     Prevents sending log messages to the system logger.
36
37       -v     Prints the software version and exits.
38
39

LONG OPTIONS

41       Each and every configuration file option (see below) may also appear as
42       a  "long" style command line argument.  For example, the use_syslog op‐
43       tion may be set using either of these two forms.
44
45              --use_syslog 1   --use_syslog=1
46
47       Option values given on the command line override values in  the  global
48       section of the configuration file.
49
50

CONFIGURATION FILE

52       The  configuration  file  is divided into sections. Each section starts
53       with a line containing its name enclosed in  brackets  and  it  follows
54       with  settings.  Each setting is placed on a separate line, it contains
55       the name of the option and the value separated  by  whitespace  charac‐
56       ters. Empty lines and lines starting with # are ignored.
57
58

GLOBAL OPTIONS

60       domainNumber
61              The domain attribute of the local clock.  The default is 0.
62
63
64       leapfile
65              The  path  to the current leap seconds definition file. In a De‐
66              bian system this file is provided by the tzdata package and  can
67              be found at /usr/share/zoneinfo/leap-seconds.list. If a leapfile
68              is configured it will be reloaded if modified. The default is an
69              empty string, which causes the program to use a hard coded table
70              that reflects the known leap seconds on the date  of  the  soft‐
71              ware's release.
72
73
74       logging_level
75              The  maximum  logging level of messages which should be printed.
76              The default is 6 (LOG_INFO).
77
78
79       message_tag
80              The tag which is added to all messages printed to  the  standard
81              output  or  system  log.   The default is an empty string (which
82              cannot be set in the configuration file as the  option  requires
83              an argument).
84
85
86       transportSpecific
87              The  transport  specific  field.  Must be in the range 0 to 255.
88              The default is 0.
89
90
91       use_syslog
92              Print messages to the system log if enabled.  The default  is  1
93              (enabled).
94
95
96       verbose
97              Print  messages  to the standard output if enabled.  The default
98              is 0 (disabled).
99
100

WARNING

102       Be cautious when sharing the same  configuration  file  between  ptp4l,
103       phc2sys, and tz2alt.  Keep in mind that values specified in the config‐
104       uration file take precedence over the default  values.   If  an  option
105       which is common to the other programs is set in the configuration file,
106       then the value will be applied to all the programs using the file,  and
107       this might not be what is expected.
108
109       It  is  recommended  to  use  separate  configuration  files for ptp4l,
110       phc2sys, and tz2alt in order to avoid any unexpected behavior.
111
112