.ig
Copyright (C) 2013 Hannes von Haugwitz <hannes@vonhaugwitz.com>
Copyright (C) 2014-23 Christian Franke

SPDX-License-Identifier: GPL-2.0-or-later

$Id: update-smart-drivedb.8.in 5605 2024-03-29 17:12:50Z chrfranke $

..
.\" Macros borrowed from pages generated with Pod::Man
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp 0.4v
.if n .sp
..
.de Vb \" Begin verbatim text
.if t .ft CW
.if n .ft R
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Use groff extension \(aq (apostrophe quote, ASCII 0x27) if possible
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.TH UPDATE-SMART-DRIVEDB 8 "2025-04-30" "smartmontools-7.5" "SMART Monitoring Tools"
.SH "نام (NAME)"
update-smart-drivedb \- به‌روزرسانی پایگاه‌داده درایوهای smartmontools
.Sp
.SH "خلاصه دستور (SYNOPSIS)"
.B update-smart-drivedb
.RI [ گزینه‌ها ]
.RI [ DESTFILE ]
.Sp
.SH "توضیحات (DESCRIPTION)"
.\" %IF NOT OS ALL
[این صفحه راهنما برای نسخهٔ لینوکس smartmontools تولید شده است. \"#
شامل اطلاعات مختص به سایر پلتفرم‌ها نمی‌شود.] \"#
.PP \"#
.\" %ENDIF NOT OS ALL
دستور
.B update-smart-drivedb
فایل
.B /usr/share/smartmontools/drivedb.h
یا
.I DESTFILE
را از شاخهٔ branches/RELEASE_7_5_DRIVEDB در مخزن SVN برنامهٔ smartmontools به‌روزرسانی می‌کند.
.PP
ابزارهای مورد استفاده برای دانلود یکی از موارد زیر هستند:
.BR curl (1)،
.BR wget (1)،
.BR lynx (1)
.\"# .\" %IF OS FreeBSD
.\"# .BR fetch (1)
.\"# [FreeBSD only],
.\"# .\" %ENDIF OS FreeBSD
.\"# .\" %IF OS OpenBSD
.\"# .BR ftp (1)
.\"# [OpenBSD only],
.\"# .\" %ENDIF OS OpenBSD
یا
.BR svn (1).
.PP
فایل دانلودشده با کلید OpenPGP/GPG به شناسهٔ 721042C5 اعتبارسنجی می‌شود.
بلوک کلید عمومی در خود اسکریپت گنجانده شده است.
.PP
اگر فایل دانلودشده یکسان باشد (با نادیده گرفتن تفاوت‌های رشتهٔ Id)، فایل قدیمی حفظ می‌شود؛ در غیر این صورت به
.BR drivedb.h.old
منتقل می‌شود.
.PP
همچنین اگر فایل دانلودشده نسخهٔ قدیمی‌تری را روی همان شاخه گزارش دهد، فایل قدیمی حفظ خواهد شد.
این رفتار را می‌توان با گزینهٔ
.B \-\-force
لغو کرد.
اگر نسخهٔ شاخه متفاوت باشد، فایل همیشه به‌روزرسانی می‌شود.
.Sp
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-s SMARTCTL, \-\-smartctl SMARTCTL
استفاده از فایل اجرایی
.BR smartctl (8)
در مسیر SMARTCTL برای بررسی نحو (syntax) پایگاه‌داده درایو.
حالت
\*(Aq\-s \-\*(Aq
بررسی نحو را غیرفعال می‌کند.
مقدار پیش‌فرض
.B /usr/bin/smartctl
است.
.TP
.B \-t [DIR/]TOOL, \-\-tool [DIR/]TOOL
استفاده از ابزار TOOL برای دانلود.
TOOL یکی از موارد زیر است:
.I curl wget lynx
.\"# .\" %IF OS FreeBSD
.\"# .I fetch
.\"# .\" %ENDIF OS FreeBSD
.\"# .\" %IF OS OpenBSD
.\"# .I ftp
.\"# .\" %ENDIF OS OpenBSD
.IR svn .
مقدار پیش‌فرض، نخستین موردی است که در PATH یافت شود.
اگر DIR نیز مشخص شده باشد، نام سادهٔ TOOL باید با هر یک از نام‌های بالا آغاز شود.
.TP
.B \-u LOCATION, \-\-url\-of LOCATION
استفاده از نشانی اینترنتی (URL) مربوط به LOCATION برای دانلود.
LOCATION یکی از موارد زیر است:
.br
.I github
(آینهٔ GitHub مخزن SVN)،
.br
.I sf
(مرورگر کد Sourceforge)،
.br
.I svn
(مخزن SVN)،
.br
.I svni
(مخزن SVN از طریق HTTP به جای HTTPS)،
.br
.I trac
(مرورگر کد Trac).
.br
مقدار پیش‌فرض
.B svn
است.
.TP
.B \-\-url URL
دانلود از نشانی URL.
یک امضای معتبر OpenPGP/GPG با پسوند
\*(Aq.raw.asc\*(Aq
نیز باید وجود داشته باشد مگر اینکه
.B \-\-no\-verify
نیز مشخص شده باشد.
.TP
.B \-\-file FILE
کپی از فایل محلی FILE.
یک امضای معتبر OpenPGP/GPG با نام
\*(AqFILE.raw.asc\*(Aq
نیز باید وجود داشته باشد مگر اینکه
.B \-\-no\-verify
نیز مشخص شده باشد.
.\"# .\" %IF ENABLE_DB_INSTALL
.\"# .TP
.\"# .B \-\-install
.\"# کپی از فایل پایگاه‌داده درایو که در ابتدا نصب شده است.
.\"# این معادل است با:
.\"# .br
.\"# \*(Aq\-\-no\-verify \-\-file /usr/share/smartmontools/drivedb.h\*(Aq
.\"# .\" %ENDIF ENABLE_DB_INSTALL
.TP
.B \-\-trunk
دانلود از trunk در SVN.
این گزینه نیازمند
.B \-\-no\-verify
است زیرا نسخه‌های trunk امضا نشده‌اند.
.TP
.B \-\-branch X.Y
دانلود از شاخهٔ branches/RELEASE_\fBX\fP_\fBY\fP_DRIVEDB.
این گزینه همچنین کلید OpenPGP/GPG را برای شاخه‌های قدیمی‌تر انتخاب می‌کند
(نسخهٔ ۵.۴۰ تا ۶.۶: شناسه کلید DFD22559).
.TP
.B \-\-cacert FILE
استفاده از گواهی‌های CA از فایل FILE برای اعتبارسنجی طرف مقابل (peer).
.TP
.B \-\-capath DIR
استفاده از فایل‌های گواهی CA از پوشهٔ DIR برای اعتبارسنجی طرف مقابل (peer).
.TP
.B \-\-insecure
در صورت ناموفق بودن اعتبارسنجی گواهی، دانلود را متوقف نکن.
این گزینه همچنین در صورت انتخاب نشانی HTTP با گزینهٔ
.B \-u
الزامی است.
.TP
.B \-\-no\-verify
عدم اعتبارسنجی امضا با GnuPG.
.TP
.B \-\-force
اجازه به دانگرید (برگشت به نسخه قدیمی‌تر).
به‌طور پیش‌فرض، پایگاه‌داده با نسخهٔ قدیمی‌تر از همان شاخه جایگزین نمی‌شود.
.TP
.B \-\-export\-key
چاپ بلوک کلید عمومی OpenPGP/GPG.
.TP
.B \-\-dryrun
فقط دستورات دانلود چاپ شوند.
.TP
.B \-q, \-\-quiet
عدم نمایش پیام‌های اطلاعاتی.
.TP
.B \-v, \-\-verbose
خروجی پرجزئیات (Verbose).
.TP
.B \-h, \-\-help
چاپ متن راهنما.
.Sp
.SH "مثال‌ها (EXAMPLES)"
به‌روزرسانی عادی:
.Vb 2
# update-smart-drivedb
/usr/share/smartmontools/drivedb.h 7.2/5225 updated to 7.2/5237
.Ve
.PP
بازگشت به نسخه قبلی:
.Vb 2
# update-smart-drivedb --force \e
  --file /usr/share/smartmontools/drivedb.h.old
/usr/share/smartmontools/drivedb.h 7.2/5237 downgraded to 7.2/5225
.Ve
.PP
دانلود پایگاه‌داده از trunk در SVN به دایرکتوری جاری:
.Vb 2
$ update-smart-drivedb --trunk --no-verify -s - -u trac drivedb-trunk.h
drivedb-trunk.h 7.3/5254 newly installed (NOT VERIFIED)
.Ve
.Sp
.SH "وضعیت خروج (EXIT STATUS)"
اگر پایگاه‌داده با موفقیت به‌روزرسانی شده باشد یا از قبل به‌روز باشد، وضعیت خروج ۰ است.
در صورت بروز خطا، وضعیت خروج ۱ است.
.Sp
.SH "فایل‌ها (FILES)"
.TP
.B /usr/bin/update-smart-drivedb
مسیر کامل این اسکریپت.
.TP
.B /usr/bin/smartctl
برای بررسی نحو پایگاه‌داده جدید درایو استفاده می‌شود.
.\"# .\" %IF ENABLE_DB_INSTALL
.\"# .TP
.\"# .B /usr/share/smartmontools/drivedb.h
.\"# پایگاه‌داده درایو که در ابتدا نصب شده است.
.\"# .\" %ENDIF ENABLE_DB_INSTALL
.TP
.B /usr/share/smartmontools/drivedb.h
پایگاه‌داده فعلی درایو.
.TP
.B /usr/share/smartmontools/drivedb.h.raw
پایگاه‌داده فعلی درایو با رشتهٔ بازنشدهٔ SVN Id.
.TP
.B /usr/share/smartmontools/drivedb.h.raw.asc
فایل امضا.
.TP
.B /usr/share/smartmontools/drivedb.h.*old*
فایل‌های قبلی.
.TP
.B /usr/share/smartmontools/drivedb.h.*error*
فایل‌های جدید در صورتی که به دلیل خطا رد شوند.
.TP
.B /usr/share/smartmontools/drivedb.h.lastcheck
فایل خالی ایجادشده در صورتی که فایل دانلودشده یکسان باشد.
.Sp
.SH "نویسندگان (AUTHORS)"
\fBChristian Franke\fP.
.br
این صفحه راهنما در ابتدا توسط
.B Hannes von Haugwitz <hannes@vonhaugwitz.com>
نوشته شده است.
.Sp
.SH "گزارش باگ‌ها (REPORTING BUGS)"
برای ارسال گزارش باگ، یک تیکت در ویکی smartmontools ایجاد کنید:
.br
<\fBhttps://www.smartmontools.org\fP>.
.br
همچنین می‌توانید اطلاعات را به فهرست ایمیل پشتیبانی smartmontools ارسال کنید:
.br
<\fBhttps://listi.jpberlin.de/mailman/listinfo/smartmontools-support\fP>.
.Sp
.SH "همچنین ببینید (SEE ALSO)"
\fBsmartctl\fP(8), \fBsmartd\fP(8).
.Sp
.SH "نسخه بسته (PACKAGE VERSION)"
smartmontools-7.5 2025-04-30 r5714
.br
$Id: update-smart-drivedb.8.in 5605 2024-03-29 17:12:50Z chrfranke $