]>
Commit | Line | Data |
---|---|---|
d2e702cf GI |
1 | .ig |
2 | Copyright (C) 2013 Hannes von Haugwitz <hannes@vonhaugwitz.com> | |
ff28b140 | 3 | Copyright (C) 2014-18 Christian Franke |
d2e702cf | 4 | |
ff28b140 | 5 | SPDX-License-Identifier: GPL-2.0-or-later |
d2e702cf | 6 | |
ff28b140 | 7 | $Id: update-smart-drivedb.8.in 4879 2018-12-28 22:05:12Z chrfranke $ |
d2e702cf GI |
8 | |
9 | .. | |
f9e10201 JD |
10 | .\" Macros borrowed from pages generated with Pod::Man |
11 | .de Vb \" Begin verbatim text | |
12 | .ft CW | |
13 | .nf | |
14 | .ne \\$1 | |
15 | .. | |
16 | .de Ve \" End verbatim text | |
17 | .ft R | |
18 | .fi | |
19 | .. | |
20 | .\" Use groff extension \(aq (apostrophe quote, ASCII 0x27) if possible | |
21 | .ie \n(.g .ds Aq \(aq | |
22 | .el .ds Aq ' | |
a86ec89e | 23 | .TH UPDATE-SMART-DRIVEDB 8 "CURRENT_SVN_DATE" "CURRENT_SVN_VERSION" "SMART Monitoring Tools" |
d2e702cf GI |
24 | .SH NAME |
25 | update-smart-drivedb \- update smartmontools drive database | |
f9e10201 | 26 | .Sp |
d2e702cf GI |
27 | .SH "SYNOPSIS" |
28 | .B update-smart-drivedb | |
a86ec89e | 29 | .RI [ OPTIONS ] |
d2e702cf | 30 | .RI [ DESTFILE ] |
f9e10201 | 31 | .Sp |
d2e702cf | 32 | .SH "DESCRIPTION" |
a86ec89e GI |
33 | .\" %IF NOT OS ALL |
34 | .\"! [This man page is generated for the OS_MAN_FILTER version of smartmontools. | |
35 | .\"! It does not contain info specific to other platforms.] | |
36 | .\"! .PP | |
37 | .\" %ENDIF NOT OS ALL | |
d2e702cf GI |
38 | .B update-smart-drivedb |
39 | updates | |
40 | .B /usr/local/share/smartmontools/drivedb.h | |
41 | or | |
42 | .I DESTFILE | |
f9e10201 JD |
43 | from branches/RELEASE_6_0_DRIVEDB of smartmontools SVN repository. |
44 | .PP | |
45 | The tools used for downloading are either | |
d2e702cf | 46 | .BR curl (1), |
a86ec89e GI |
47 | .BR wget (1), |
48 | .BR lynx (1), | |
d2e702cf | 49 | .\" %IF OS FreeBSD |
d2e702cf | 50 | .BR fetch (1) |
a86ec89e | 51 | [FreeBSD only], |
d2e702cf GI |
52 | .\" %ENDIF OS FreeBSD |
53 | .\" %IF OS OpenBSD | |
d2e702cf | 54 | .BR ftp (1) |
a86ec89e | 55 | [OpenBSD only], |
d2e702cf | 56 | .\" %ENDIF OS OpenBSD |
a86ec89e GI |
57 | or |
58 | .BR svn (1). | |
f9e10201 JD |
59 | .PP |
60 | [NEW EXPERIMENTAL UPDATE-SMART-DRIVEDB FEATURE] | |
ff28b140 | 61 | The downloaded file is verified with OpenPGP/GPG key ID 721042C5. |
f9e10201 JD |
62 | The public key block is included in the script. |
63 | .PP | |
d2e702cf GI |
64 | The old file is kept if the downloaded file is identical (ignoring |
65 | the differences in Id string) otherwise it is moved to | |
66 | .BR drivedb.h.old . | |
f9e10201 | 67 | .Sp |
d2e702cf GI |
68 | .SH "OPTIONS" |
69 | .TP | |
a86ec89e GI |
70 | .B \-s SMARTCTL |
71 | Use the | |
72 | .BR smartctl (8) | |
73 | executable at path SMARTCTL for drive database syntax check. | |
f9e10201 | 74 | The form \*(Aq\-s \-\*(Aq disables the syntax check. |
a86ec89e GI |
75 | The default is |
76 | .BR /usr/local/sbin/smartctl . | |
77 | .TP | |
78 | .B \-t TOOL | |
79 | Use TOOL for download. | |
80 | TOOL is one of: | |
81 | .I curl wget lynx | |
82 | .\" %IF OS FreeBSD | |
83 | .I fetch | |
84 | .\" %ENDIF OS FreeBSD | |
85 | .\" %IF OS OpenBSD | |
86 | .I ftp | |
87 | .\" %ENDIF OS OpenBSD | |
88 | .IR svn . | |
89 | The default is the first one found in PATH. | |
90 | .TP | |
91 | .B \-u LOCATION | |
f9e10201 JD |
92 | Use URL of LOCATION for download. |
93 | LOCATION is one of: | |
a86ec89e | 94 | .br |
ff28b140 TL |
95 | .I github |
96 | (GitHub mirror of SVN repository), | |
97 | .br | |
a86ec89e | 98 | .I sf |
ff28b140 | 99 | (Sourceforge code browser), |
a86ec89e GI |
100 | .br |
101 | .I svn | |
ff28b140 | 102 | (SVN repository), |
a86ec89e GI |
103 | .br |
104 | .I svni | |
ff28b140 | 105 | (SVN repository via HTTP instead of HTTPS), |
a86ec89e GI |
106 | .br |
107 | .I trac | |
ff28b140 | 108 | (Trac code browser). |
a86ec89e GI |
109 | .br |
110 | The default is | |
111 | .IR svn . | |
112 | .TP | |
f9e10201 JD |
113 | .B \-\-trunk |
114 | Download from SVN trunk. | |
115 | This requires \*(Aq\-\-no\-verify\*(Aq unless the trunk version is still | |
116 | identical to branches/RELEASE_6_0_DRIVEDB. | |
117 | .TP | |
a86ec89e GI |
118 | .B \-\-cacert FILE |
119 | Use CA certificates from FILE to verify the peer. | |
120 | .TP | |
121 | .B \-\-capath DIR | |
122 | Use CA certificate files from DIR to verify the peer. | |
123 | .TP | |
124 | .B \-\-insecure | |
125 | Don't abort download if certificate verification fails. | |
f9e10201 JD |
126 | This option is also required if a HTTP URL is selected with \*(Aq\-u\*(Aq |
127 | option. | |
128 | .TP | |
129 | .B \-\-no\-verify | |
130 | Don't verify signature with GnuPG. | |
131 | .TP | |
132 | .B \-\-export\-key | |
133 | Print the OpenPGP/GPG public key block. | |
a86ec89e GI |
134 | .TP |
135 | .B \-\-dryrun | |
136 | Print download commands only. | |
137 | .TP | |
138 | .B \-v | |
139 | Verbose output. | |
f9e10201 | 140 | .Sp |
d2e702cf | 141 | .SH "EXAMPLES" |
f9e10201 | 142 | .Vb 2 |
d2e702cf | 143 | # update-smart-drivedb |
f9e10201 JD |
144 | /usr/local/share/smartmontools/drivedb.h updated from \e |
145 | branches/RELEASE_6_0_DRIVEDB | |
146 | .Ve | |
147 | .Sp | |
d2e702cf GI |
148 | .SH "EXIT STATUS" |
149 | The exit status is 0 if the database has been successfully | |
f9e10201 JD |
150 | updated. |
151 | If an error occurs the exit status is 1. | |
152 | .Sp | |
d2e702cf GI |
153 | .SH FILES |
154 | .TP | |
155 | .B /usr/local/sbin/update-smart-drivedb | |
156 | full path of this script. | |
157 | .TP | |
158 | .B /usr/local/sbin/smartctl | |
159 | used to check syntax of new drive database. | |
160 | .TP | |
161 | .B /usr/local/share/smartmontools/drivedb.h | |
162 | current drive database. | |
163 | .TP | |
f9e10201 JD |
164 | .B /usr/local/share/smartmontools/drivedb.h.raw |
165 | current drive database with unexpanded SVN Id string. | |
166 | .TP | |
167 | .B /usr/local/share/smartmontools/drivedb.h.raw.asc | |
168 | signature file. | |
d2e702cf | 169 | .TP |
f9e10201 JD |
170 | .B /usr/local/share/smartmontools/drivedb.h.*old* |
171 | previous files. | |
172 | .TP | |
173 | .B /usr/local/share/smartmontools/drivedb.h.*error* | |
174 | new files if rejected due to errors. | |
d2e702cf GI |
175 | .TP |
176 | .B /usr/local/share/smartmontools/drivedb.h.lastcheck | |
177 | empty file created if downloaded file was identical. | |
f9e10201 | 178 | .Sp |
d2e702cf | 179 | .SH AUTHORS |
a86ec89e | 180 | \fBChristian Franke\fP. |
d2e702cf GI |
181 | .br |
182 | This manual page was originally written by | |
183 | .BR "Hannes von Haugwitz <hannes@vonhaugwitz.com>" . | |
f9e10201 | 184 | .Sp |
a86ec89e GI |
185 | .SH REPORTING BUGS |
186 | To submit a bug report, create a ticket in smartmontools wiki: | |
187 | .br | |
f9e10201 | 188 | <\fBhttps://www.smartmontools.org/\fP>. |
a86ec89e GI |
189 | .br |
190 | Alternatively send the info to the smartmontools support mailing list: | |
191 | .br | |
f9e10201 JD |
192 | <\fBhttps://listi.jpberlin.de/mailman/listinfo/smartmontools-support\fB>. |
193 | .Sp | |
a86ec89e GI |
194 | .SH SEE ALSO |
195 | \fBsmartctl\fP(8), \fBsmartd\fP(8). | |
f9e10201 | 196 | .Sp |
a86ec89e GI |
197 | .SH PACKAGE VERSION |
198 | CURRENT_SVN_VERSION CURRENT_SVN_DATE CURRENT_SVN_REV | |
199 | .br | |
ff28b140 | 200 | $Id: update-smart-drivedb.8.in 4879 2018-12-28 22:05:12Z chrfranke $ |