نام (NAME)

update-smart-drivedb - به‌روزرسانی پایگاه‌داده درایوهای smartmontools

خلاصه دستور (SYNOPSIS)

update-smart-drivedb [گزینه‌ها] [DESTFILE]

توضیحات (DESCRIPTION)

[این صفحه راهنما برای نسخهٔ لینوکس smartmontools تولید شده است. شامل اطلاعات مختص به سایر پلتفرم‌ها نمی‌شود.]

دستور update-smart-drivedb فایل /usr/share/smartmontools/drivedb.h یا DESTFILE را از شاخهٔ branches/RELEASE_7_5_DRIVEDB در مخزن SVN برنامهٔ smartmontools به‌روزرسانی می‌کند.

ابزارهای مورد استفاده برای دانلود یکی از موارد زیر هستند: curl(1)، wget(1)، lynx(1) یا svn(1).

فایل دانلودشده با کلید OpenPGP/GPG به شناسهٔ 721042C5 اعتبارسنجی می‌شود. بلوک کلید عمومی در خود اسکریپت گنجانده شده است.

اگر فایل دانلودشده یکسان باشد (با نادیده گرفتن تفاوت‌های رشتهٔ Id)، فایل قدیمی حفظ می‌شود؛ در غیر این صورت به drivedb.h.old منتقل می‌شود.

همچنین اگر فایل دانلودشده نسخهٔ قدیمی‌تری را روی همان شاخه گزارش دهد، فایل قدیمی حفظ خواهد شد. این رفتار را می‌توان با گزینهٔ --force لغو کرد. اگر نسخهٔ شاخه متفاوت باشد، فایل همیشه به‌روزرسانی می‌شود.

گزینه‌ها (OPTIONS)

-s SMARTCTL, --smartctl SMARTCTL: استفاده از فایل اجرایی smartctl(8) در مسیر SMARTCTL برای بررسی نحو (syntax) پایگاه‌داده درایو. حالت '-s -' بررسی نحو را غیرفعال می‌کند. مقدار پیش‌فرض /usr/bin/smartctl است.
-t [DIR/]TOOL, --tool [DIR/]TOOL: استفاده از ابزار TOOL برای دانلود. TOOL یکی از موارد زیر است: curl wget lynx svn. مقدار پیش‌فرض، نخستین موردی است که در PATH یافت شود. اگر DIR نیز مشخص شده باشد، نام سادهٔ TOOL باید با هر یک از نام‌های بالا آغاز شود.
-u LOCATION, --url-of LOCATION: استفاده از نشانی اینترنتی (URL) مربوط به LOCATION برای دانلود. LOCATION یکی از موارد زیر است:
github (آینهٔ GitHub مخزن SVN)،
sf (مرورگر کد Sourceforge)،
svn (مخزن SVN)،
svni (مخزن SVN از طریق HTTP به جای HTTPS)،
trac (مرورگر کد Trac).
مقدار پیش‌فرض svn است.
--url URL: دانلود از نشانی URL. یک امضای معتبر OpenPGP/GPG با پسوند '.raw.asc' نیز باید وجود داشته باشد مگر اینکه --no-verify نیز مشخص شده باشد.
--file FILE: کپی از فایل محلی FILE. یک امضای معتبر OpenPGP/GPG با نام 'FILE.raw.asc' نیز باید وجود داشته باشد مگر اینکه --no-verify نیز مشخص شده باشد.
--trunk: دانلود از trunk در SVN. این گزینه نیازمند --no-verify است زیرا نسخه‌های trunk امضا نشده‌اند.
--branch X.Y: دانلود از شاخهٔ branches/RELEASE_X_Y_DRIVEDB. این گزینه همچنین کلید OpenPGP/GPG را برای شاخه‌های قدیمی‌تر انتخاب می‌کند (نسخهٔ ۵.۴۰ تا ۶.۶: شناسه کلید DFD22559).
--cacert FILE: استفاده از گواهی‌های CA از فایل FILE برای اعتبارسنجی طرف مقابل (peer).
--capath DIR: استفاده از فایل‌های گواهی CA از پوشهٔ DIR برای اعتبارسنجی طرف مقابل (peer).
--insecure: در صورت ناموفق بودن اعتبارسنجی گواهی، دانلود را متوقف نکن. این گزینه همچنین در صورت انتخاب نشانی HTTP با گزینهٔ -u الزامی است.
--no-verify: عدم اعتبارسنجی امضا با GnuPG.
--force: اجازه به دانگرید (برگشت به نسخه قدیمی‌تر). به‌طور پیش‌فرض، پایگاه‌داده با نسخهٔ قدیمی‌تر از همان شاخه جایگزین نمی‌شود.
--export-key: چاپ بلوک کلید عمومی OpenPGP/GPG.
--dryrun: فقط دستورات دانلود چاپ شوند.
-q, --quiet: عدم نمایش پیام‌های اطلاعاتی.
-v, --verbose: خروجی پرجزئیات (Verbose).
-h, --help: چاپ متن راهنما.

مثال‌ها (EXAMPLES)

به‌روزرسانی عادی:

# update-smart-drivedb
/usr/share/smartmontools/drivedb.h 7.2/5225 updated to 7.2/5237

بازگشت به نسخه قبلی:

# update-smart-drivedb --force \
  --file /usr/share/smartmontools/drivedb.h.old
/usr/share/smartmontools/drivedb.h 7.2/5237 downgraded to 7.2/5225

دانلود پایگاه‌داده از trunk در SVN به دایرکتوری جاری:

$ update-smart-drivedb --trunk --no-verify -s - -u trac drivedb-trunk.h
drivedb-trunk.h 7.3/5254 newly installed (NOT VERIFIED)

وضعیت خروج (EXIT STATUS)

اگر پایگاه‌داده با موفقیت به‌روزرسانی شده باشد یا از قبل به‌روز باشد، وضعیت خروج ۰ است. در صورت بروز خطا، وضعیت خروج ۱ است.

فایل‌ها (FILES)

/usr/bin/update-smart-drivedb: مسیر کامل این اسکریپت.
/usr/bin/smartctl: برای بررسی نحو پایگاه‌داده جدید درایو استفاده می‌شود.
/usr/share/smartmontools/drivedb.h: پایگاه‌داده فعلی درایو.
/usr/share/smartmontools/drivedb.h.raw: پایگاه‌داده فعلی درایو با رشتهٔ بازنشدهٔ SVN Id.
/usr/share/smartmontools/drivedb.h.raw.asc: فایل امضا.
/usr/share/smartmontools/drivedb.h.*old*: فایل‌های قبلی.
/usr/share/smartmontools/drivedb.h.*error*: فایل‌های جدید در صورتی که به دلیل خطا رد شوند.
/usr/share/smartmontools/drivedb.h.lastcheck: فایل خالی ایجادشده در صورتی که فایل دانلودشده یکسان باشد.

نویسندگان (AUTHORS)

Christian Franke.
این صفحه راهنما در ابتدا توسط Hannes von Haugwitz <hannes@vonhaugwitz.com> نوشته شده است.

گزارش باگ‌ها (REPORTING BUGS)

برای ارسال گزارش باگ، یک تیکت در ویکی smartmontools ایجاد کنید:
https://www.smartmontools.org.
همچنین می‌توانید اطلاعات را به فهرست ایمیل پشتیبانی smartmontools ارسال کنید:
https://listi.jpberlin.de/mailman/listinfo/smartmontools-support.

همچنین ببینید (SEE ALSO)

smartctl(8), smartd(8).

نسخه بسته (PACKAGE VERSION)

smartmontools-7.5 2025-04-30 r5714
$Id: update-smart-drivedb.8.in 5605 2024-03-29 17:12:50Z chrfranke $