FreeBSD Manual Pages
UPDATE-SMART-DRIVEDB(8) SMART Monitoring Tools UPDATE-SMART-DRIVEDB(8) NAME update-smart-drivedb - update smartmontools drive database SYNOPSIS update-smart-drivedb [OPTIONS] [DESTFILE] DESCRIPTION [This man page is generated for the FreeBSD version of smartmontools. It does not contain info specific to other platforms.] update-smart-drivedb updates /usr/local/share/smartmontools/drivedb.h or DESTFILE from branches/RELEASE_7_3_DRIVEDB of smartmontools SVN repository. The tools used for downloading are either curl(1), wget(1), lynx(1), fetch(1) [FreeBSD only], 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. [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] 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 data- base syntax check. The form '-s -' disables the syntax check. The default is /usr/local/sbin/smartctl. -t [DIR/]TOOL, --tool [DIR/]TOOL Use TOOL for download. TOOL is one of: curl wget lynx fetch svn. The default is the first one found in PATH. [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] A DIR could also be specified. The plain TOOL name must then 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 [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] Download from URL. A valid OpenPGP/GPG signature with '.raw.asc' exten- sion must also exist unless '--no-verify' is also specified. --file FILE [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] 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' op- tion. --no-verify Don't verify signature with GnuPG. --force [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] Allow down- grades. 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 [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] Suppress info messages. -v, --verbose Verbose output. -h, --help Print help text. EXAMPLES Regular update: # update-smart-drivedb /usr/local/share/smartmontools/drivedb.h 7.2/5225 updated to 7.2/5237 Revert to previous version: # update-smart-drivedb --force \ --file /usr/local/share/smartmontools/drivedb.h.old /usr/local/share/smartmontools/drivedb.h 7.2/5237 downgraded to 7.2/5225 Download the database from SVN trunk to current directory: $ update-smart-drivedb --trunk --no-verify -s - -u trac drivedb-trunk.h drivedb-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/local/sbin/update-smart-drivedb full path of this script. /usr/local/sbin/smartctl used to check syntax of new drive database. /usr/local/share/smartmontools/drivedb.h current drive database. /usr/local/share/smartmontools/drivedb.h.raw current drive database with unexpanded SVN Id string. /usr/local/share/smartmontools/drivedb.h.raw.asc signature file. /usr/local/share/smartmontools/drivedb.h.*old* previous files. /usr/local/share/smartmontools/drivedb.h.*error* new files if rejected due to errors. /usr/local/share/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/smartmontools-support>. SEE ALSO smartctl(8), smartd(8). PACKAGE VERSION smartmontools-7.4 2023-08-01 r5530 $Id: update-smart-drivedb.8.in 5521 2023-07-24 16:44:49Z chrfranke $ smartmontools-7.4 2023-08-01 UPDATE-SMART-DRIVEDB(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | FILES | AUTHORS | REPORTING BUGS | SEE ALSO | PACKAGE VERSION
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=update-smart-drivedb&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>