From owner-svn-src-all@FreeBSD.ORG Fri Mar 9 01:32:06 2012 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 759BC106566B; Fri, 9 Mar 2012 01:32:06 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 5B0E88FC0A; Fri, 9 Mar 2012 01:32:06 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q291W62v073699; Fri, 9 Mar 2012 01:32:06 GMT (envelope-from eadler@svn.freebsd.org) Received: (from eadler@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q291W6TG073697; Fri, 9 Mar 2012 01:32:06 GMT (envelope-from eadler@svn.freebsd.org) Message-Id: <201203090132.q291W6TG073697@svn.freebsd.org> From: Eitan Adler Date: Fri, 9 Mar 2012 01:32:06 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r232712 - head/sbin/adjkerntz X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 09 Mar 2012 01:32:06 -0000 Author: eadler Date: Fri Mar 9 01:32:05 2012 New Revision: 232712 URL: http://svn.freebsd.org/changeset/base/232712 Log: Fix a variety of grammar and style nits PR: docs/165841 Submitted by: Robert Simmons Approved by: brd MFC after: 1 week Modified: head/sbin/adjkerntz/adjkerntz.8 Modified: head/sbin/adjkerntz/adjkerntz.8 ============================================================================== --- head/sbin/adjkerntz/adjkerntz.8 Fri Mar 9 00:53:54 2012 (r232711) +++ head/sbin/adjkerntz/adjkerntz.8 Fri Mar 9 01:32:05 2012 (r232712) @@ -24,12 +24,12 @@ .\" .\" $FreeBSD$ .\" -.Dd April 4, 1996 +.Dd March 8, 2012 .Dt ADJKERNTZ 8 .Os .Sh NAME .Nm adjkerntz -.Nd "adjust local time CMOS clock to reflect time zone changes and keep current timezone offset for the kernel" +.Nd adjust the local time CMOS clock to reflect time zone changes and keep the current timezone offset for the kernel .Sh SYNOPSIS .Nm .Fl i @@ -39,23 +39,21 @@ The .Nm utility maintains the proper relationship between the kernel clock, which -is always set to UTC, and the CMOS clock, which may be set to local -time. +is always set to UTC and the CMOS clock, which may be set to local time. The .Nm -utility also informs the kernel about machine timezone shifts to +utility also informs the kernel about machine timezone shifts in order to maintain proper timestamps for local time file systems such as the MS-DOS file system. -The main purpose of this thing is not general fixing of -initially broken MS-DOS file timestamp idea but keeping -the same timestamps between +The main purpose of maintaining these timestamps properly is to keep the +timestamps of a .Fx -MS-DOS file system -and MS-DOS operating system installed on the same -machine. +MS-DOS file system and an MS-DOS operating system synchronized when they are +installed on the same system rather than fixing broken MS-DOS file +timestamps. If the file .Pa /etc/wall_cmos_clock -exists, it means that CMOS clock keeps local time (MS-DOS and MS-Windows +exists, it means that the CMOS clock keeps local time (MS-DOS and MS-Windows compatible mode). If that file does not exist, it means that the CMOS clock keeps UTC time. The @@ -86,7 +84,7 @@ reads the local time from it and sets the kernel clock to the corresponding UTC time. The .Nm -utility also stores the local time zone offset into the +utility also stores the local time zone offset in the .Pa machdep.adjkerntz kernel variable, for use by subsequent invocations of .Em "'adjkerntz -a'" @@ -94,7 +92,7 @@ and by local time file systems. .Pp For a local time CMOS clock .Em "'adjkerntz -i'" -pauses, and remains inactive as a background daemon until it +pauses and remains inactive as a background daemon until it receives a SIGTERM. The SIGTERM will normally be sent by .Xr init 8 @@ -120,7 +118,7 @@ time zone offset, and the changed time z calculate a new time zone offset. It stores the new offset into the .Pa machdep.adjkerntz -kernel variable, and updates the wall CMOS clock to the new local time. +kernel variable and updates the wall CMOS clock to the new local time. If .Em "'adjkerntz -a'" was started at a nonexistent time (during a timezone change), it exits