1UPDATE-SMART-DRIVEDB(8) SMART Monitoring Tools UPDATE-SMART-DRIVEDB(8)
2
6 update-smart-drivedb - update smartmontools drive database
7
10 update-smart-drivedb [OPTIONS] [DESTFILE]
11
14 [This man page is generated for the Linux version of smartmontools. It
15 does not contain info specific to other platforms.]
16 update-smart-drivedb updates /usr/share/smartmontools/drivedb.h or
18 DESTFILE from branches/RELEASE_7_3_DRIVEDB of smartmontools SVN reposi‐
19 tory.
20 The tools used for downloading are either curl(1), wget(1), lynx(1), or
22 svn(1).
23 The downloaded file is verified with OpenPGP/GPG key ID 721042C5. The
25 public key block is included in the script.
26 The old file is kept if the downloaded file is identical (ignoring the
28 differences in Id string) otherwise it is moved to drivedb.h.old.
29 [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] The old file is
31 also kept if the downloaded file reports an older version on the same
32 branch. This could be overridden with the '--force' option. If the
33 branch version differs, the file is always updated.
34
37 -s SMARTCTL, --smartctl SMARTCTL
38 Use the smartctl(8) executable at path SMARTCTL for drive data‐
39 base syntax check. The form '-s -' disables the syntax check.
40 The default is /usr/sbin/smartctl.
41 -t [DIR/]TOOL, --tool [DIR/]TOOL
43 Use TOOL for download. TOOL is one of: curl wget lynx svn. The
44 default is the first one found in PATH.
45 [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] A DIR could
46 also be specified. The plain TOOL name must then begin with any
47 of the above names.
48 -u LOCATION, --url-of LOCATION
50 Use URL of LOCATION for download. LOCATION is one of:
51 github (GitHub mirror of SVN repository),
52 sf (Sourceforge code browser),
53 svn (SVN repository),
54 svni (SVN repository via HTTP instead of HTTPS),
55 trac (Trac code browser).
56 The default is svn.
57 --url URL
59 [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] Download
60 from URL. A valid OpenPGP/GPG signature with '.raw.asc' exten‐
61 sion must also exist unless '--no-verify' is also specified.
62 --file FILE
64 [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] Copy from
65 local FILE. A valid OpenPGP/GPG signature 'FILE.raw.asc' must
66 also exist unless '--no-verify' is also specified.
67 --trunk
69 Download from SVN trunk. This requires '--no-verify' because
70 the trunk versions are not signed.
71 --branch X.Y
73 Download from branches/RELEASE_X_Y_DRIVEDB. This also selects
74 the OpenPGP/GPG key for older branches (5.40 to 6.6: Key ID
75 DFD22559).
76 --cacert FILE
78 Use CA certificates from FILE to verify the peer.
79 --capath DIR
81 Use CA certificate files from DIR to verify the peer.
82 --insecure
84 Don't abort download if certificate verification fails. This
85 option is also required if a HTTP URL is selected with '-u' op‐
86 tion.
87 --no-verify
89 Don't verify signature with GnuPG.
90 --force
92 [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] Allow down‐
93 grades. By default, the database is not replaced with an older
94 version of the same branch.
95 --export-key
97 Print the OpenPGP/GPG public key block.
98 --dryrun
100 Print download commands only.
101 -q, --quiet
103 [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB 7.3 FEATURE] Suppress
104 info messages.
105 -v, --verbose
107 Verbose output.
108 -h, --help
110 Print help text.
111
114 Regular update:
115 # update-smart-drivedb
116 /usr/share/smartmontools/drivedb.h 7.2/5225 updated to 7.2/5237
117 Revert to previous version:
119 # update-smart-drivedb --force \
120 --file /usr/share/smartmontools/drivedb.h.old
121 /usr/share/smartmontools/drivedb.h 7.2/5237 downgraded to 7.2/5225
122 Download the database from SVN trunk to current directory:
124 $ update-smart-drivedb --trunk --no-verify -s - -u trac drivedb-trunk.h
125 drivedb-trunk.h 7.3/5254 newly installed (NOT VERIFIED)
126
129 The exit status is 0 if the database has been successfully updated or
130 is already up to date. If an error occurs the exit status is 1.
131
134 /usr/sbin/update-smart-drivedb
135 full path of this script.
136 /usr/sbin/smartctl
138 used to check syntax of new drive database.
139 /usr/share/smartmontools/drivedb.h
141 current drive database.
142 /usr/share/smartmontools/drivedb.h.raw
144 current drive database with unexpanded SVN Id string.
145 /usr/share/smartmontools/drivedb.h.raw.asc
147 signature file.
148 /usr/share/smartmontools/drivedb.h.*old*
150 previous files.
151 /usr/share/smartmontools/drivedb.h.*error*
153 new files if rejected due to errors.
154 /usr/share/smartmontools/drivedb.h.lastcheck
156 empty file created if downloaded file was identical.
157
160 Christian Franke.
161 This manual page was originally written by Hannes von Haugwitz
162 <hannes@vonhaugwitz.com>.
163
166 To submit a bug report, create a ticket in smartmontools wiki:
167 <https://www.smartmontools.org/>.
168 Alternatively send the info to the smartmontools support mailing list:
169 <https://listi.jpberlin.de/mailman/listinfo/smartmontools-support>.
170
173 smartctl(8), smartd(8).
174
177 smartmontools-7.4 2023-08-01 r5530
178 $Id: update-smart-drivedb.8.in 5521 2023-07-24 16:44:49Z chrfranke $
179smartmontools-7.4 2023-08-01 UPDATE-SMART-DRIVEDB(8)