update-smart-drivedb.8.in

   1 .ig
   2 Copyright (C) 2013 Hannes von Haugwitz <hannes@vonhaugwitz.com>
   3 Copyright (C) 2014-16 Christian Franke
   4
   5 $Id: update-smart-drivedb.8.in 4223 2016-02-26 20:18:40Z chrfranke $
   6
   7 This program is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 2, or (at your option)
  10 any later version.
  11
  12 You should have received a copy of the GNU General Public License
  13 (for example COPYING); If not, see <http://www.gnu.org/licenses/>.
  14
  15 ..
  16 .TH UPDATE-SMART-DRIVEDB 8 "CURRENT_SVN_DATE" "CURRENT_SVN_VERSION" "SMART Monitoring Tools"
  17 .SH NAME
  18 update-smart-drivedb \- update smartmontools drive database
  19
  20 .SH "SYNOPSIS"
  21 .B update-smart-drivedb
  22 .RI [ OPTIONS ]
  23 .RI [ DESTFILE ]
  24
  25 .SH "DESCRIPTION"
  26 .\" %IF NOT OS ALL
  27 .\"! [This man page is generated for the OS_MAN_FILTER version of smartmontools.
  28 .\"! It does not contain info specific to other platforms.]
  29 .\"! .PP
  30 .\" %ENDIF NOT OS ALL
  31 .B update-smart-drivedb
  32 updates
  33 .B /usr/local/share/smartmontools/drivedb.h
  34 or
  35 .I DESTFILE
  36 from smartmontools SVN repository.
  37
  38 It tries to download first from the current branch and then from
  39 trunk. The tools used for downloading are either
  40 .BR curl (1),
  41 .BR wget (1),
  42 .BR lynx (1),
  43 .\" %IF OS FreeBSD
  44 .BR fetch (1)
  45 [FreeBSD only],
  46 .\" %ENDIF OS FreeBSD
  47 .\" %IF OS OpenBSD
  48 .BR ftp (1)
  49 [OpenBSD only],
  50 .\" %ENDIF OS OpenBSD
  51 or
  52 .BR svn (1).
  53
  54 The old file is kept if the downloaded file is identical (ignoring
  55 the differences in Id string) otherwise it is moved to
  56 .BR drivedb.h.old .
  57
  58 .SH "OPTIONS"
  59 .TP
  60 .B \-s SMARTCTL
  61 Use the
  62 .BR smartctl (8)
  63 executable at path SMARTCTL for drive database syntax check.
  64 The form \'\-s \-\' disables the syntax check.
  65 The default is
  66 .BR /usr/local/sbin/smartctl .
  67 .TP
  68 .B \-t TOOL
  69 Use TOOL for download.
  70 TOOL is one of:
  71 .I curl wget lynx
  72 .\" %IF OS FreeBSD
  73 .I fetch
  74 .\" %ENDIF OS FreeBSD
  75 .\" %IF OS OpenBSD
  76 .I ftp
  77 .\" %ENDIF OS OpenBSD
  78 .IR svn .
  79 The default is the first one found in PATH.
  80 .TP
  81 .B \-u LOCATION
  82 Use URL of LOCATION for download. LOCATION is one of:
  83 .br
  84 .I sf
  85 (Sourceforge code browser via HTTPS),
  86 .br
  87 .I svn
  88 (SVN repository via HTTPS),
  89 .br
  90 .I svni
  91 (SVN repository via HTTP),
  92 .br
  93 .I trac
  94 (Trac code browser via HTTPS).
  95 .br
  96 The default is
  97 .IR svn .
  98 .TP
  99 .B \-\-cacert FILE
 100 Use CA certificates from FILE to verify the peer.
 101 .TP
 102 .B \-\-capath DIR
 103 Use CA certificate files from DIR to verify the peer.
 104 .TP
 105 .B \-\-insecure
 106 Don't abort download if certificate verification fails.
 107 This option is also required if a HTTP URL is selected with \'-u\' option.
 108 .TP
 109 .B \-\-dryrun
 110 Print download commands only.
 111 .TP
 112 .B \-v
 113 Verbose output.
 114
 115 .SH "EXAMPLES"
 116 .nf
 117 # update-smart-drivedb
 118 /usr/local/share/smartmontools/drivedb.h updated from branches/RELEASE_6_0_DRIVEDB
 119 .fi
 120
 121 .SH "EXIT STATUS"
 122 The exit status is 0 if the database has been successfully
 123 updated. If an error occurs the exit status is 1.
 124
 125 .SH FILES
 126 .TP
 127 .B /usr/local/sbin/update-smart-drivedb
 128 full path of this script.
 129 .TP
 130 .B /usr/local/sbin/smartctl
 131 used to check syntax of new drive database.
 132 .TP
 133 .B /usr/local/share/smartmontools/drivedb.h
 134 current drive database.
 135 .TP
 136 .B /usr/local/share/smartmontools/drivedb.h.old
 137 previous drive database.
 138 .TP
 139 .B /usr/local/share/smartmontools/drivedb.h.error
 140 new drive database if rejected due to syntax errors.
 141 .TP
 142 .B /usr/local/share/smartmontools/drivedb.h.lastcheck
 143 empty file created if downloaded file was identical.
 144
 145 .SH AUTHORS
 146 \fBChristian Franke\fP.
 147 .br
 148 This manual page was originally written by
 149 .BR "Hannes von Haugwitz <hannes@vonhaugwitz.com>" .
 150
 151 .SH REPORTING BUGS
 152 To submit a bug report, create a ticket in smartmontools wiki:
 153 .br
 154 <\fBhttp://www.smartmontools.org/\fP>.
 155 .br
 156 Alternatively send the info to the smartmontools support mailing list:
 157 .br
 158 <\fBhttps://lists.sourceforge.net/lists/listinfo/smartmontools-support\fB>.
 159
 160 .SH SEE ALSO
 161 \fBsmartctl\fP(8), \fBsmartd\fP(8).
 162
 163 .SH PACKAGE VERSION
 164 CURRENT_SVN_VERSION CURRENT_SVN_DATE CURRENT_SVN_REV
 165 .br
 166 $Id: update-smart-drivedb.8.in 4223 2016-02-26 20:18:40Z chrfranke $