UPDAT-SMAR-DRIVEDB
Section: SMART Monitoring Tools (8)
Updated: 202-0-30
Index
Return to Main Contents
NAME
updat-smar-drivedb - update smartmontools drive database
SYNOPSIS
updat-smar-drivedb
[
OPTIONS]
[
DESTFILE]
DESCRIPTION
[This man page is generated for the Linux version of smartmontools. It does not contain info specific to other platforms.]
updat-smar-drivedb
updates
/var/db/smartmontools/drivedb.h
or
DESTFILE
from branches/RELEASE_7_5_DRIVEDB of smartmontools SVN repository.
The tools used for downloading are either
curl(1),
wget(1),
lynx(1),
or
svn(1).
The downloaded file is verified with OpenPGP/GPG key ID 721042C5.
The public key block is included in the script.
The old file is kept if the downloaded file is identical (ignoring
the differences in Id string) otherwise it is moved to
drivedb.h.old.
The old file is also kept if the downloaded file reports an older version
on the same branch.
This could be overridden with the '--force' option.
If the branch version differs, the file is always updated.
OPTIONS
- -s SMARTCTL, --smartctl SMARTCTL
-
Use the
smartctl(8)
executable at path SMARTCTL for drive database syntax check.
The form '-s -' disables the syntax check.
The default is
/usr/sbin/smartctl.
- -t [DIR/]TOOL, --tool [DIR/]TOOL
-
Use TOOL for download.
TOOL is one of:
curl wget lynx
svn.
The default is the first one found in PATH.
If a DIR is also specified, the plain TOOL name must begin with any of the
above names.
- -u LOCATION, --url-of LOCATION
-
Use URL of LOCATION for download.
LOCATION is one of:
github
(GitHub mirror of SVN repository),
sf
(Sourceforge code browser),
svn
(SVN repository),
svni
(SVN repository via HTTP instead of HTTPS),
trac
(Trac code browser).
The default is
svn.
- --url URL
-
Download from URL.
A valid OpenPGP/GPG signature with '.raw.asc' extension must also
exist unless '--no-verify' is also specified.
- --file FILE
-
Copy from local FILE.
A valid OpenPGP/GPG signature 'FILE.raw.asc' must also exist
unless '--no-verify' is also specified.
- --trunk
-
Download from SVN trunk.
This requires '--no-verify' because the trunk versions are not
signed.
- --branch X.Y
-
Download from branches/RELEASE_X_Y_DRIVEDB.
This also selects the OpenPGP/GPG key for older branches
(5.40 to 6.6: Key ID DFD22559).
- --cacert FILE
-
Use CA certificates from FILE to verify the peer.
- --capath DIR
-
Use CA certificate files from DIR to verify the peer.
- --insecure
-
Don't abort download if certificate verification fails.
This option is also required if a HTTP URL is selected with '-u'
option.
- --no-verify
-
Don't verify signature with GnuPG.
- --force
-
Allow downgrades.
By default, the database is not replaced with an older version of the
same branch.
- --export-key
-
Print the OpenPGP/GPG public key block.
- --dryrun
-
Print download commands only.
- -q, --quiet
-
Suppress info messages.
- -v, --verbose
-
Verbose output.
- -h, --help
-
Print help text.
EXAMPLES
Regular update:
# updat-smar-drivedb
/var/db/smartmontools/drivedb.h 7.2/5225 updated to 7.2/5237
Revert to previous version:
# updat-smar-drivedb-force
-file /var/db/smartmontools/drivedb.h.old
/var/db/smartmontools/drivedb.h 7.2/5237 downgraded to 7.2/5225
Download the database from SVN trunk to current directory:
$ updat-smar-drivedb-trunk-n-verify-s--u trac drived-trunk.h
drived-trunk.h 7.3/5254 newly installed (NOT VERIFIED)
EXIT STATUS
The exit status is 0 if the database has been successfully updated or is
already up to date.
If an error occurs the exit status is 1.
FILES
- /usr/sbin/updat-smar-drivedb
-
full path of this script.
- /usr/sbin/smartctl
-
used to check syntax of new drive database.
- /var/db/smartmontools/drivedb.h
-
current drive database.
- /var/db/smartmontools/drivedb.h.raw
-
current drive database with unexpanded SVN Id string.
- /var/db/smartmontools/drivedb.h.raw.asc
-
signature file.
- /var/db/smartmontools/drivedb.h.*old*
-
previous files.
- /var/db/smartmontools/drivedb.h.*error*
-
new files if rejected due to errors.
- /var/db/smartmontools/drivedb.h.lastcheck
-
empty file created if downloaded file was identical.
AUTHORS
Christian Franke.
This manual page was originally written by
Hannes von Haugwitz <hannes@vonhaugwitz.com>.
REPORTING BUGS
To submit a bug report, create a ticket in smartmontools wiki:
<
https://www.smartmontools.org/>.
Alternatively send the info to the smartmontools support mailing list:
<
https://listi.jpberlin.de/mailman/listinfo/smartmontool-support>.
SEE ALSO
smartctl(8),
smartd(8).
PACKAGE VERSION
smartmontool-7.5 202-0-30 r5714
$Id: updat-smar-drivedb.8.in 5605 202-0-29 17:12:50Z chrfranke $
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- EXIT STATUS
-
- FILES
-
- AUTHORS
-
- REPORTING BUGS
-
- SEE ALSO
-
- PACKAGE VERSION
-