Go to main content

man pages section 5: File Formats

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ntprc (5)

Name

ntprc - file to initialize preferences for NTP programs

Synopsis

Please see following description for synopsis

Description

ntprc(5)                         File Formats                         ntprc(5)



NAME
       ntprc - file to initialize preferences for NTP programs

DESCRIPTION
       The .ntprc file contains data used to initialize certain parameters for
       various NTP related programs. When these programs are started, the cur-
       rent  directory  is  searched for the existence of the .ntprc file.  If
       found, the file is read and searched for a section header  that  speci-
       fies  the program being run. If such a section is found, then the lines
       in that section are used to initialize the program. If such  a  section
       is  not  found  and no other sections are found, then the whole file is
       used do the initialization.  If the file is not found  in  the  current
       directory,  the  users  home  directory is searched if found then it is
       processed as above.

       The .ntprc file is a text file, with each line specifying the  settings
       of  a  command  line  flag.  The  flags are indicated by the use of the
       flag's long name. Anything after the long name on the line is  used  to
       set the value of the flag if it takes a value. The same file is used by
       several NTP programs, so to separate which lines  go  with  which  pro-
       grams, the file is split into sections. Each section is marked with the
       name of the corresponding program in all  capital  letters  and  inside
       square  brackets.   Comments  can be given in the file by beginning the
       comment line with a "#" in the first column.

       The best way to set the lines in the file is  to  run  the  command  in
       question  with  all  of the flags the way you want them and to give the
       --save-opts filename flag at the end to save the parameters to a  file.
       After  that,  simply edit the resulting file to remove the comments and
       add the section header and then append the file to the .ntprc file.

EXAMPLES
       Example 1 A Sample .ntprc File

       A .ntprc file containing the following lines:

         [NTPQ]
         numeric
         command rv 0
         [NTPDC]
         peers


       will force the ntpq program to always execute the "rv  0"  command  and
       print the results with IP addresses and not hostname.

FILES
       ~/.ntprc


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------+
       |ATTRIBUTE TYPE |  ATTRIBUTE VALUE    |
       +---------------+---------------------+
       |Availability   | service/network/ntp |
       +---------------+---------------------+
       |Stability      | Uncommitted         |
       +---------------+---------------------+

SEE ALSO
       ntpq(8), ntp-keygen(8)



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source          was         downloaded         from          http://ar-
       chive.ntp.org/ntp4/ntp-4.2/ntp-4.2.8p15.tar.gz.

       Further information about this software can be found on the open source
       community website at http://www.ntp.org/.



                                                                      ntprc(5)