1UPDATE-SMART-DRIVEDB(8)     SMART Monitoring Tools     UPDATE-SMART-DRIVEDB(8)
2
3
4

NAME

6       update-smart-drivedb - update smartmontools drive database
7
8

SYNOPSIS

10       update-smart-drivedb [OPTIONS] [DESTFILE]
11
12

DESCRIPTION

14       [This man page is generated for the Linux version of smartmontools.  It
15       does not contain info specific to other platforms.]
16
17       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
21       The tools used for downloading are either curl(1), wget(1), lynx(1), or
22       svn(1).
23
24       The  downloaded file is verified with OpenPGP/GPG key ID 721042C5.  The
25       public key block is included in the script.
26
27       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
30       [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
35

OPTIONS

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
42       -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
49       -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
58       --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
63       --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
68       --trunk
69              Download  from  SVN  trunk.  This requires '--no-verify' because
70              the trunk versions are not signed.
71
72       --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
77       --cacert FILE
78              Use CA certificates from FILE to verify the peer.
79
80       --capath DIR
81              Use CA certificate files from DIR to verify the peer.
82
83       --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
88       --no-verify
89              Don't verify signature with GnuPG.
90
91       --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
96       --export-key
97              Print the OpenPGP/GPG public key block.
98
99       --dryrun
100              Print download commands only.
101
102       -q, --quiet
103              [NEW EXPERIMENTAL  UPDATE-SMART-DRIVEDB  7.3  FEATURE]  Suppress
104              info messages.
105
106       -v, --verbose
107              Verbose output.
108
109       -h, --help
110              Print help text.
111
112

EXAMPLES

114       Regular update:
115       # update-smart-drivedb
116       /usr/share/smartmontools/drivedb.h 7.2/5225 updated to 7.2/5237
117
118       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
123       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
127

EXIT STATUS

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
132

FILES

134       /usr/sbin/update-smart-drivedb
135              full path of this script.
136
137       /usr/sbin/smartctl
138              used to check syntax of new drive database.
139
140       /usr/share/smartmontools/drivedb.h
141              current drive database.
142
143       /usr/share/smartmontools/drivedb.h.raw
144              current drive database with unexpanded SVN Id string.
145
146       /usr/share/smartmontools/drivedb.h.raw.asc
147              signature file.
148
149       /usr/share/smartmontools/drivedb.h.*old*
150              previous files.
151
152       /usr/share/smartmontools/drivedb.h.*error*
153              new files if rejected due to errors.
154
155       /usr/share/smartmontools/drivedb.h.lastcheck
156              empty file created if downloaded file was identical.
157
158

AUTHORS

160       Christian Franke.
161       This  manual  page  was  originally  written  by  Hannes  von  Haugwitz
162       <hannes@vonhaugwitz.com>.
163
164

REPORTING BUGS

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
171

SEE ALSO

173       smartctl(8), smartd(8).
174
175

PACKAGE VERSION

177       smartmontools-7.4 2023-08-01 r5530
178       $Id: update-smart-drivedb.8.in 5521 2023-07-24 16:44:49Z chrfranke $
179
180
181
182smartmontools-7.4                 2023-08-01           UPDATE-SMART-DRIVEDB(8)
Impressum