components/ntp/Solaris/ntp.client
author Brian Utterback <brian.utterback@oracle.com>
Wed, 29 Apr 2015 12:54:24 -0700
branchs11u2-sru
changeset 4215 c0c7615b4511
parent 2789 b28fe4d7df32
permissions -rw-r--r--
14932716 SUNBT4031742 /etc/inet/ntp.client should include broadcastclient 20728422 ntpq4 -c mrulis randomly returns no data and posts error latest.newest... 20783962 There is no way to adjust the leap second by slewmode in ntpd(v4). 20853665 problem in SERVICE/NTP 20853731 problem in SERVICE/NTP 20952293 problem in SERVICE/NTP
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
172
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
     1
#
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
     2
# CDDL HEADER START
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
     3
#
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
     4
# The contents of this file are subject to the terms of the
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
     5
# Common Development and Distribution License (the "License").
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
     6
# You may not use this file except in compliance with the License.
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
     7
#
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
     8
# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
     9
# or http://www.opensolaris.org/os/licensing.
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    10
# See the License for the specific language governing permissions
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    11
# and limitations under the License.
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    12
#
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    13
# When distributing Covered Code, include this CDDL HEADER in each
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    14
# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    15
# If applicable, add the following below this CDDL HEADER, with the
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    16
# fields enclosed by brackets "[]" replaced with your own identifying
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    17
# information: Portions Copyright [yyyy] [name of copyright owner]
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    18
#
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    19
# CDDL HEADER END
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    20
#
4215
c0c7615b4511 14932716 SUNBT4031742 /etc/inet/ntp.client should include broadcastclient
Brian Utterback <brian.utterback@oracle.com>
parents: 2789
diff changeset
    21
# Copyright (c) 2009, 2015, Oracle and/or its affiliates. All rights reserved.
172
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    22
432
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    23
# If you do not want to configure your client to listen for multicast, comment
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    24
# this line out. This should only be used for casual time keeping, like keeping
172
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    25
# a desktop system in sync. 
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    26
432
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    27
multicastclient 224.0.1.1
172
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    28
2789
b28fe4d7df32 15705382 SUNBT7031289 Update ntp to 4.2.7
Brian Utterback <brian.utterback@oracle.com>
parents: 432
diff changeset
    29
# You can also use broadcast mode. Again, only use for casual timekeeping.
b28fe4d7df32 15705382 SUNBT7031289 Update ntp to 4.2.7
Brian Utterback <brian.utterback@oracle.com>
parents: 432
diff changeset
    30
4215
c0c7615b4511 14932716 SUNBT4031742 /etc/inet/ntp.client should include broadcastclient
Brian Utterback <brian.utterback@oracle.com>
parents: 2789
diff changeset
    31
broadcastclient
2789
b28fe4d7df32 15705382 SUNBT7031289 Update ntp to 4.2.7
Brian Utterback <brian.utterback@oracle.com>
parents: 432
diff changeset
    32
b28fe4d7df32 15705382 SUNBT7031289 Update ntp to 4.2.7
Brian Utterback <brian.utterback@oracle.com>
parents: 432
diff changeset
    33
# The default is to require authentication. Without authentication you do not
b28fe4d7df32 15705382 SUNBT7031289 Update ntp to 4.2.7
Brian Utterback <brian.utterback@oracle.com>
parents: 432
diff changeset
    34
# have any control over what servers your system is getting its time from. 
b28fe4d7df32 15705382 SUNBT7031289 Update ntp to 4.2.7
Brian Utterback <brian.utterback@oracle.com>
parents: 432
diff changeset
    35
# It is possible for another system to target your system to change the time. 
b28fe4d7df32 15705382 SUNBT7031289 Update ntp to 4.2.7
Brian Utterback <brian.utterback@oracle.com>
parents: 432
diff changeset
    36
# However for casual time keeping and ease of administration authentication 
b28fe4d7df32 15705382 SUNBT7031289 Update ntp to 4.2.7
Brian Utterback <brian.utterback@oracle.com>
parents: 432
diff changeset
    37
# may not be necessary. Using authentication is recommended.
b28fe4d7df32 15705382 SUNBT7031289 Update ntp to 4.2.7
Brian Utterback <brian.utterback@oracle.com>
parents: 432
diff changeset
    38
b28fe4d7df32 15705382 SUNBT7031289 Update ntp to 4.2.7
Brian Utterback <brian.utterback@oracle.com>
parents: 432
diff changeset
    39
disable auth
b28fe4d7df32 15705382 SUNBT7031289 Update ntp to 4.2.7
Brian Utterback <brian.utterback@oracle.com>
parents: 432
diff changeset
    40
172
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    41
# To configure NTP servers, replace the server_name with either the IP address
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    42
# or hostname of the server you wish to use. If you just want to keep the time
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    43
# in a causual way, one server may be enough for you. If you wish to keep it
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    44
# to a more accurate level, 3 or more is recommended. Do not choose 2, because
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    45
# 2 servers is an unstable configuration. By the same token 3 is only acceptable
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    46
# if all are always available, since when a single one reboots or otherwise 
432
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    47
# becomes unavailable, you have just 2. The iburst keyword specifies that 
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    48
# multiple packets be sent at start-up to allow the system to more quickly
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    49
# get the correct time at boot.
172
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    50
#
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    51
# For a list of Internet NTP servers see 
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    52
# http://support.ntp.org/bin/view/Servers/WebHome
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    53
# If you use this list, be sure to read, understand and abide by the rules
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    54
# each server has published for accessing themselves.
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    55
#
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    56
# There is also a DNS round-robin pool of public access NTP servers. The
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    57
# instructions for accessing these are at http://www.pool.ntp.org
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    58
# Please consider adding your own servers to the pool if possible.
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    59
#
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    60
# Many ISP's also provide NTP servers for use by their customers. 
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    61
432
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    62
# server server_name1 iburst
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    63
# server server_name2 iburst
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    64
# server server_name3 iburst
172
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    65
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    66
# Always configure the drift file. It can take days for ntpd to completely 
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    67
# stabilize and without the drift file, it has to start over on a reboot
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    68
# of if ntpd restarts. 
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    69
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    70
driftfile /var/ntp/ntp.drift
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    71
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    72
# It is always wise to configure at least the loopstats and peerstats files. 
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    73
# Otherwise when ntpd does something you don't expect there is no way to 
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    74
# find out why. 
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    75
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    76
statsdir /var/ntp/ntpstats/
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    77
filegen peerstats file peerstats type day enable
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    78
filegen loopstats file loopstats type day enable
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    79
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    80
# To track the events regarding the system clock, the protostats file can be useful
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    81
# as well. 
432
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    82
172
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    83
#filegen protostats file protostats type day enable
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    84
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    85
# To see the current state of the crypto authentication protocols, enable the
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    86
# cryptostats file.
432
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    87
172
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    88
#filegen cryptostats file cryptostats type day enable
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    89
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    90
# The clockstats files are only useful if a hardware reference clock is 
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    91
# configured. See the /etc/inet/ntp.server file for more information about 
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    92
# that.
432
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    93
172
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    94
#filegen clockstats file clockstats type day enable
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    95
432
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    96
# The sysstats and rawstats output might be useful in debugging, but are 
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    97
# not important otherwise.
4eda6f0a3346 6902531 ntp start method checks for global zone which should not be a requirement
Brian Utterback <Brian.Utterback@Oracle.COM>
parents: 172
diff changeset
    98
172
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
    99
#filegen sysstats file sysstats type day enable
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   100
#filegen rawstats file rawstats type day enable
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   101
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   102
# There are several types on authentication supported by NTP. The easiest
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   103
# to use is a set of passwords, called "keys". They should be stored
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   104
# the /etc/inet/ntp.keys file. Each key in the ntp.keys file can be
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   105
# assigned to certain types of trust levels. See ntpd(1m) for more
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   106
# information on setting up key.
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   107
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   108
#keys /etc/inet/ntp.keys
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   109
#trustedkey 1
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   110
#requestkey 1
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   111
#controlkey 1
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   112
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   113
#
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   114
# To configure leap seconds processing, download the latest NIST leap seconds
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   115
# file to /etc/inet, and then create a symbolic link to it from the ntp.leap
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   116
# file. Without this file, NTP will still be able to accept leap announcements
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   117
# from its upstream sources. If this file exists and is less than 6 months old
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   118
# then the contents of this file will take precedence over the upstream servers.
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   119
# The latest leap seconds file is always available at ftp://time.nist.gov/pub
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   120
093198acf7d4 7018272 Move NTP to userland
Brian Utterback <Brian.Utterback@Oracle.COM>
parents:
diff changeset
   121
#leapfile /etc/inet/ntp.leap