NAME

       tz2alt - Monitors daylight savings time changes and publishes them to PTP stack.

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

       -f config
              Read configuration from the specified file.  No configuration file is read by default.

       -h     Displays the command line help summary.

       -l print-level
              Sets the maximum syslog level of messages which should be printed or sent to  the  system  logger.
              The default is 6 (LOG_INFO).

       -m     Prints log messages to the standard output.

       -q     Prevents sending log messages to the system logger.

       -v     Prints the software version and exits.

LONG OPTIONS

       Each  and  every  configuration  file  option  (see below) may also appear as a "long" style command line
       argument.  For example, the use_syslog option may be set using either of these two forms.

              --use_syslog 1   --use_syslog=1

       Option values given on the command line override values in the global section of the configuration file.

CONFIGURATION FILE

       The configuration file is divided into sections. Each section starts with  a  line  containing  its  name
       enclosed  in  brackets  and  it  follows  with  settings.   Each setting is placed on a separate line, it
       contains the name of the option and the value separated by whitespace characters. Empty lines  and  lines
       starting with # are ignored.

GLOBAL OPTIONS

       domainNumber
              The domain attribute of the local clock.  The default is 0.

       leapfile
              The  path to the current leap seconds definition file. In a Debian system this file is provided by
              the tzdata package and can be found at /usr/share/zoneinfo/leap-seconds.list.  If  a  leapfile  is
              configured  it  will  be  reloaded  if  modified. The default is an empty string, which causes the
              program to use a hard coded table that reflects  the  known  leap  seconds  on  the  date  of  the
              software's release.

       logging_level
              The maximum logging level of messages which should be printed.  The default is 6 (LOG_INFO).

       message_tag
              The  tag  which is added to all messages printed to the standard output or system log.  If the tag
              contains the string "{level}", it will be replaced with the log level of the message as a  number.
              The  default  is  an  empty  string  (which  cannot be set in the configuration file as the option
              requires an argument).

       transportSpecific
              The transport specific field. Must be in the range 0 to 255.  The default is 0.

       use_syslog
              Print messages to the system log if enabled.  The default is 1 (enabled).

       verbose
              Print messages to the standard output if enabled.  The default is 0 (disabled).

WARNING

       Be cautious when sharing the same configuration file between ptp4l, phc2sys, and tz2alt.   Keep  in  mind
       that  values  specified  in the configuration file take precedence over the default values.  If an option
       which is common to the other programs is set in the configuration file, then the value will be applied to
       all the programs using the file, and this might not be what is expected.

       It is recommended to use separate configuration files for ptp4l, phc2sys, and tz2alt in  order  to  avoid
       any unexpected behavior.

SEE ALSO

       ptp4l(8)

linuxptp                                          February 2023                                        TS2ALT(8)