.ig
Copyright (C) 2013 Hannes von Haugwitz <hannes@vonhaugwitz.com>
-Copyright (C) 2014-16 Christian Franke
+Copyright (C) 2014-17 Christian Franke
-$Id: update-smart-drivedb.8.in 4223 2016-02-26 20:18:40Z chrfranke $
+$Id: update-smart-drivedb.8.in 4584 2017-11-03 22:43:32Z chrfranke $
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
(for example COPYING); If not, see <http://www.gnu.org/licenses/>.
..
+.\" Macros borrowed from pages generated with Pod::Man
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Use groff extension \(aq (apostrophe quote, ASCII 0x27) if possible
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
.TH UPDATE-SMART-DRIVEDB 8 "CURRENT_SVN_DATE" "CURRENT_SVN_VERSION" "SMART Monitoring Tools"
.SH NAME
update-smart-drivedb \- update smartmontools drive database
-
+.Sp
.SH "SYNOPSIS"
.B update-smart-drivedb
.RI [ OPTIONS ]
.RI [ DESTFILE ]
-
+.Sp
.SH "DESCRIPTION"
.\" %IF NOT OS ALL
.\"! [This man page is generated for the OS_MAN_FILTER version of smartmontools.
.B /usr/local/share/smartmontools/drivedb.h
or
.I DESTFILE
-from smartmontools SVN repository.
-
-It tries to download first from the current branch and then from
-trunk. The tools used for downloading are either
+from branches/RELEASE_6_0_DRIVEDB of smartmontools SVN repository.
+.PP
+The tools used for downloading are either
.BR curl (1),
.BR wget (1),
.BR lynx (1),
.\" %ENDIF OS OpenBSD
or
.BR svn (1).
-
+.PP
+[NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB FEATURE]
+The downloaded file is verified with OpenPGP/GPG key ID DFD22559.
+The public key block is included in the script.
+.PP
The old file is kept if the downloaded file is identical (ignoring
the differences in Id string) otherwise it is moved to
.BR drivedb.h.old .
-
+.Sp
.SH "OPTIONS"
.TP
.B \-s SMARTCTL
Use the
.BR smartctl (8)
executable at path SMARTCTL for drive database syntax check.
-The form \'\-s \-\' disables the syntax check.
+The form \*(Aq\-s \-\*(Aq disables the syntax check.
The default is
.BR /usr/local/sbin/smartctl .
.TP
The default is the first one found in PATH.
.TP
.B \-u LOCATION
-Use URL of LOCATION for download. LOCATION is one of:
+Use URL of LOCATION for download.
+LOCATION is one of:
.br
.I sf
(Sourceforge code browser via HTTPS),
The default is
.IR svn .
.TP
+.B \-\-trunk
+Download from SVN trunk.
+This requires \*(Aq\-\-no\-verify\*(Aq unless the trunk version is still
+identical to branches/RELEASE_6_0_DRIVEDB.
+.TP
.B \-\-cacert FILE
Use CA certificates from FILE to verify the peer.
.TP
.TP
.B \-\-insecure
Don't abort download if certificate verification fails.
-This option is also required if a HTTP URL is selected with \'-u\' option.
+This option is also required if a HTTP URL is selected with \*(Aq\-u\*(Aq
+option.
+.TP
+.B \-\-no\-verify
+Don't verify signature with GnuPG.
+.TP
+.B \-\-export\-key
+Print the OpenPGP/GPG public key block.
.TP
.B \-\-dryrun
Print download commands only.
.TP
.B \-v
Verbose output.
-
+.Sp
.SH "EXAMPLES"
-.nf
+.Vb 2
# update-smart-drivedb
-/usr/local/share/smartmontools/drivedb.h updated from branches/RELEASE_6_0_DRIVEDB
-.fi
-
+/usr/local/share/smartmontools/drivedb.h updated from \e
+branches/RELEASE_6_0_DRIVEDB
+.Ve
+.Sp
.SH "EXIT STATUS"
The exit status is 0 if the database has been successfully
-updated. If an error occurs the exit status is 1.
-
+updated.
+If an error occurs the exit status is 1.
+.Sp
.SH FILES
.TP
.B /usr/local/sbin/update-smart-drivedb
.B /usr/local/share/smartmontools/drivedb.h
current drive database.
.TP
-.B /usr/local/share/smartmontools/drivedb.h.old
-previous drive database.
+.B /usr/local/share/smartmontools/drivedb.h.raw
+current drive database with unexpanded SVN Id string.
+.TP
+.B /usr/local/share/smartmontools/drivedb.h.raw.asc
+signature file.
.TP
-.B /usr/local/share/smartmontools/drivedb.h.error
-new drive database if rejected due to syntax errors.
+.B /usr/local/share/smartmontools/drivedb.h.*old*
+previous files.
+.TP
+.B /usr/local/share/smartmontools/drivedb.h.*error*
+new files if rejected due to errors.
.TP
.B /usr/local/share/smartmontools/drivedb.h.lastcheck
empty file created if downloaded file was identical.
-
+.Sp
.SH AUTHORS
\fBChristian Franke\fP.
.br
This manual page was originally written by
.BR "Hannes von Haugwitz <hannes@vonhaugwitz.com>" .
-
+.Sp
.SH REPORTING BUGS
To submit a bug report, create a ticket in smartmontools wiki:
.br
-<\fBhttp://www.smartmontools.org/\fP>.
+<\fBhttps://www.smartmontools.org/\fP>.
.br
Alternatively send the info to the smartmontools support mailing list:
.br
-<\fBhttps://lists.sourceforge.net/lists/listinfo/smartmontools-support\fB>.
-
+<\fBhttps://listi.jpberlin.de/mailman/listinfo/smartmontools-support\fB>.
+.Sp
.SH SEE ALSO
\fBsmartctl\fP(8), \fBsmartd\fP(8).
-
+.Sp
.SH PACKAGE VERSION
CURRENT_SVN_VERSION CURRENT_SVN_DATE CURRENT_SVN_REV
.br
-$Id: update-smart-drivedb.8.in 4223 2016-02-26 20:18:40Z chrfranke $
+$Id: update-smart-drivedb.8.in 4584 2017-11-03 22:43:32Z chrfranke $