Your message dated Tue, 01 May 2012 15:05:07 +0000
with message-id <[email protected]>
and subject line Bug#667580: fixed in fake-hwclock 0.5
has caused the Debian Bug report #667580,
regarding manpage for fake-hwclock
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)
--
667580: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=667580
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: fake-hwclock
Severity: important
Tags: patch
I've just written a manpage for fake-hwclock. Patch containing the
manpage is attached
This is my first attempt at writing a manpage so please give
constructive criticism.
diff -urN fake-hwclock-0.4/debian/fake-hwclock.manpages fake-hwclock-0.4.new/debian/fake-hwclock.manpages
--- fake-hwclock-0.4/debian/fake-hwclock.manpages 1970-01-01 01:00:00.000000000 +0100
+++ fake-hwclock-0.4.new/debian/fake-hwclock.manpages 2012-04-05 03:00:37.000000000 +0100
@@ -0,0 +1 @@
+fake-hwclock.8
diff -urN fake-hwclock-0.4/debian/rules fake-hwclock-0.4.new/debian/rules
--- fake-hwclock-0.4/debian/rules 2012-03-05 16:30:28.000000000 +0000
+++ fake-hwclock-0.4.new/debian/rules 2012-04-05 02:57:50.000000000 +0100
@@ -29,6 +29,7 @@
dh_installdocs
dh_installcron
dh_installinit --no-start -- start 02 S . stop 02 0 1 6 .
+ dh_installman
dh_compress
dh_fixperms
dh_installdeb
diff -urN fake-hwclock-0.4/fake-hwclock.8 fake-hwclock-0.4.new/fake-hwclock.8
--- fake-hwclock-0.4/fake-hwclock.8 1970-01-01 01:00:00.000000000 +0100
+++ fake-hwclock-0.4.new/fake-hwclock.8 2012-04-05 02:26:20.000000000 +0100
@@ -0,0 +1,57 @@
+.TH FAKE-HWCLOCK 8 "5 April 2012" Debian
+.SH NAME
+fake-hwclock \- Control fake hardware clock
+.SH SYNOPSIS
+\fBfake-hwclock\fP [ \fIcommand\fP ] [ \fBforce\fP ]
+.SH BACKGROUND
+Many embedded Linux systems do not have a functional hardware clock. Either
+they simply don't have a hardware clock at all or they have a hardware clock
+but it is not usable (e.g. because Linux doesn't know how to use it or because
+no battery is present).
+
+This can lead to time moving backwards to some default value (often 1970) when
+the system is rebooted. Since lots of software assumes that time only moves
+forward this is a bad thing. NTP can (and should where practical) be used to
+sync with an external timeserver but it is not available early in the boot
+process and may be unavailable for other reasons.
+.SH DESCRIPTION
+\fBfake-hwclock\fP sets and queries a fake "hardware clock" which stores the
+time in a file. This program may be run by the system administer directly but is
+typically run by init (to load the time on startup and save it on shutdown)
+and cron (to save the time hourly).
+
+If no command is given then fake-hwclock acts as if the save command was used.
+.SH COMMANDS
+.SS
+.TP
+\fBsave\fP
+Save the time to the file.
+.TP
+\fBload\fP
+Load the time from the file. If force is specified fake-hwclock will move the
+clock either backwards or forwards. Otherwise it will only move it forwards.
+.SH FILES
+.SS
+.TP
+\fB/etc/fake-hwclock.data\fR
+The file used to store the time
+.TP
+\fB/etc/init.d/fake-hwclock\fR
+The init script used to run fake-hwclock on startup and shutdown
+.TP
+\fB/etc/default/fake-hwclock\fR
+Settings file for the init script.
+.TP
+\fB/etc/cron.hourly/fake-hwclock\fR
+Cron job used to save the time hourly
+.SH ENVIRONMENT VARIABLES
+.SS
+.TP
+\fBFILE\fR
+set the file used by fake-hwclock
+.SH RETURN VALUES
+1 is returned for invalid commands. 0 is returned in all other cases.
+.SH BUGS
+This approach can only provide a crude approximation of what a real hardware
+clock provides. Use of NTP or another method to keep the time in sync is
+strongly advised.
--- End Message ---
--- Begin Message ---
Source: fake-hwclock
Source-Version: 0.5
We believe that the bug you reported is fixed in the latest version of
fake-hwclock, which is due to be installed in the Debian FTP archive:
fake-hwclock_0.5.dsc
to main/f/fake-hwclock/fake-hwclock_0.5.dsc
fake-hwclock_0.5.tar.gz
to main/f/fake-hwclock/fake-hwclock_0.5.tar.gz
fake-hwclock_0.5_all.deb
to main/f/fake-hwclock/fake-hwclock_0.5_all.deb
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to [email protected],
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Steve McIntyre <[email protected]> (supplier of updated fake-hwclock package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [email protected])
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Format: 1.8
Date: Tue, 01 May 2012 12:27:26 +0100
Source: fake-hwclock
Binary: fake-hwclock
Architecture: source all
Version: 0.5
Distribution: unstable
Urgency: low
Maintainer: Steve McIntyre <[email protected]>
Changed-By: Steve McIntyre <[email protected]>
Description:
fake-hwclock - Save/restore system clock on machines without working RTC
hardwar
Closes: 667580
Changes:
fake-hwclock (0.5) unstable; urgency=low
.
* Add man page, provided by Peter Green. Closes: #667580.
Checksums-Sha1:
8a4097f282e0c6db15dd368e84e0202ffcdd1b90 1522 fake-hwclock_0.5.dsc
13afbbc10a826bb94fcff16bb95d1313318c1743 11105 fake-hwclock_0.5.tar.gz
1c0a4703018934e191bcfb413466e72f6fd9ea51 5326 fake-hwclock_0.5_all.deb
Checksums-Sha256:
07a763c020815aee1692fe6bbac14306a2c5820ce5790168996ce12abf90c751 1522
fake-hwclock_0.5.dsc
a6f400cce2c668a3c4339473e9871eaa5362cd217ccf9db8c858fc9993932ee6 11105
fake-hwclock_0.5.tar.gz
cf9603915082341e55e7a556377214ab25cd5d64454dcd61a06a59f9778eed04 5326
fake-hwclock_0.5_all.deb
Files:
9c389c98df64cf14a6c964306fe57d85 1522 admin extra fake-hwclock_0.5.dsc
af7c9938246d527e2c30a5e33b8bfa3d 11105 admin extra fake-hwclock_0.5.tar.gz
33197bd152cea18f0c851aba34394fe0 5326 admin extra fake-hwclock_0.5_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)
iQIcBAEBCAAGBQJPn/VMAAoJEFh5eVc0QmhO+44QAKSxRAos2AaE+5NnTf09SVnz
JEkm/E8H+lqs6UFPxEAVGS0NPmt2n+MAjKTw8h3mq3ADU5WU0qmozxxBwKMDZ2Rp
48uXKNHF4vyLZd4wBBrFUKYjzeV/iON3qP9p08lkEcDGCH+YAymZMUIK5/fP/kfP
u70iW1nRdcZyNIfco2tO2qO4z/Tq0xD1iqDDbtHjJkmDrIZIte9r18UNreBR3K6E
QR+9Y7kED6ZQmH9s8LTBANyj+rRFGtwdmXriG3/n2Ga78s7I+/m28Ei+WxZQ+WWG
+U/phGxIk5n1MqyOFknein+NQAQvHiMdebX12/iBAQeIIMwb/Sdr5PVTNAA1tMzz
jvRdDq8iTr+ZgAxGCXGljUvdP8rgiRotkh7WCNnJvlsiUhXq+TcoIweNHTO5n16p
L3AdUdUqAiuqzjX6IrshXlmZzUL0p6/D/B5pEJ3vFTn6r8DW4Anq+qendqarD5x5
cdEeLb6DYG1A8Jct9OCOk4e0IImVpJRAoohflb6y6jA3hS8UdZrN8ZerXpZ0gRnx
kl5k0/gw8hn7J07opA0BkrcuBkKqmu/Aqq+Rm/qK8X4O8Rr0IFUWT/ffL8cQgrlt
uv8JngcN+ScOrkVC4efEsSEPUGHs5LPHSwVIc9JejxJegYBvua0Ym2hajPG+7Vxk
k7nLTKlaPLaE2nsOEGey
=6th1
-----END PGP SIGNATURE-----
--- End Message ---
