Go to main content

man pages section 1M: System Administration Commands

Exit Print View

Updated: July 2017
 
 

rtc(1M)

Name

rtc - provide all real-time clock and UTC-lag management

Synopsis

/usr/sbin/rtc [-c] [[-z zone-name] [-w]]

Description

The real-time clock is a hardware based time counter. It is used by the operating system to calculate the current time after optionally applying a time zone and daylight savings time adjustment. Some operating systems use a convention of storing a time-zone adjusted value in the real-time clock. Oracle Solaris generally stores a GMT value in the real-time clock.

On x86 systems, the rtc command reconciles the difference in the way that time is established between UNIX and MS-DOS systems. UNIX systems utilize Universal Coordinated Time (UTC), while MS-DOS systems utilize local time.

Without arguments, rtc displays the currently configured time zone string. The currently configured time zone string is based on what was last recorded by rtc– z zone-name.

The rtc command is not normally run from a shell prompt; it is generally invoked by the system. Commands such as date(1) and rdate(1M), which are used to set the time on a system, invoke /usr/sbin/rtc –c to ensure that daylight savings time (DST) is corrected for properly.

Options

–c

This option checks for DST and makes corrections if necessary. It is normally run once a day by a cron job.

If there is no RTC time zone or /etc/rtc_config file, this option will do nothing.

–z zone-name

This option, which is normally run by the system at software installation time, is used to specify the time zone in which the RTC is to be maintained. It updates the configuration file /etc/rtc_config with the name of the specified zone and the current UTC lag for that zone. If there is an existing rtc_config file, this command will update it. If not, this command will create it.

–w

Only valid with the –z option; when this option is given, it is assumed that the real-time clock has the proper time and warps the system's time. By default, the system time is assumed to be correct and the real-time clock is modified instead.

Files

/etc/rtc_config

The data file used to record the time zone and UTC lag. This file is completely managed by /usr/sbin/rtc, and it is read by the kernel.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Architecture
x86
Availability
system/core-os

See Also

date(1), rdate(1M), attributes(5)