.TH "sigtool" "1" "February 12, 2007" "ClamAV 1.5.4" "Clam AntiVirus"

.SH "نام (NAME)"
.LP
sigtool \- ابزار مدیریت امضا و پایگاه‌داده

.SH "خلاصه دستور (SYNOPSIS)"
.LP
sigtool [گزینه‌ها]

.SH "توضیحات (DESCRIPTION)"
.LP
ابزار
.B sigtool
می‌تواند برای تولید چک‌سام‌های MD5، تبدیل داده‌ها به فرمت هگزادسیمال، فهرست کردن امضاهای ویروس و ساخت، باز کردن، آزمایش و اعتبارسنجی پایگاه‌های داده CVD و اسکریپت‌های به‌روزرسانی استفاده شود.

.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.LP
.TP
\fB\-h, \-\-help\fR
نمایش اطلاعات راهنما و خروج.
.TP
\fB\-V, \-\-version\fR
چاپ شماره نسخه و خروج.
.TP
\fB\-\-quiet\fR
حالت بی‌صدا، فقط پیام‌های خطا نمایش داده می‌شوند.
.TP
\fB\-\-debug\fR
فعال کردن پیام‌های اشکال‌زدایی.
.TP
\fB\-\-stdout\fR
نوشتن تمام پیام‌ها در خروجی استاندارد (stdout).
.TP
\fB\-\-tempdir=DIRECTORY\fR
ایجاد فایل‌های موقت در DIRECTORY. دایرکتوری باید برای کاربری که sigtool را اجرا می‌کند قابل نوشتن باشد.
.TP
\fB\-\-leave\-temps\fR
عدم حذف فایل‌های موقت.
.TP
\fB\-\-datadir=DIR\fR
استفاده از DIR به عنوان دایرکتوری پیش‌فرض پایگاه‌داده برای تمامی عملیات‌ها.

.SH "دستورات کار با امضاها (COMMANDS FOR WORKING WITH SIGNATURES)"
.LP
.TP
\fB\-l[FILE], \-\-list\-sigs[=FILE]\fR
فهرست کردن نام تمام امضاها از دایرکتوری محلی پایگاه‌داده (پیش‌فرض) یا از FILE.
.TP
\fB\-fREGEX, \-\-find\-sigs=REGEX\fR
یافتن و نمایش امضاهایی از دایرکتوری محلی پایگاه‌داده که با REGEX مشخص‌شده مطابقت دارند. کل بدنه امضا (نام، رشته هگز و غیره) بررسی می‌شود.
.TP
\fB\-\-decode\-sigs=REGEX\fR
رمزگشایی امضاهای خوانده‌شده از ورودی استاندارد (برای مثال هدایت‌شده از طریق پایپ از \-\-find\-sigs).
.TP
\fB\-\-test\-sigs=DATABASE TARGET_FILE\fR
آزمایش تمام امضاهای موجود در DATABASE در برابر TARGET_FILE. این گزینه تنها در صورتی نتایج معتبر ارائه می‌دهد که فایل هدف همان فایل نهایی باشد که امضاها برای آن ایجاد شده‌اند (پس از استخراج، نرمال‌سازی و غیره).

.SH "دستورات تولید امضا (COMMANDS TO GENERATE SIGNATURES)"
.LP
.TP
\fB\-\-md5 [FILES]\fR
تولید چک‌سام MD5 از ورودی استاندارد یا امضاهای MD5 برای FILES.
.TP
\fB\-\-sha1 [FILES]\fR
تولید چک‌سام SHA1 از ورودی استاندارد یا امضاهای SHA1 برای FILES.
.TP
\fB\-\-sha2-256 [FILES]\fR
تولید چک‌سام SHA2-256 از ورودی استاندارد یا امضاهای SHA2-256 برای FILES.
گزینه قبلی \-\-sha256 منسوخ شده است و ممکن است در نسخه‌های آینده حذف شود.
.TP
\fB\-\-mdb [FILES]\fR
تولید امضاهای .mdb (هش بخش‌های PE) برای FILES.
.TP
\fB\-\-imp [FILES]\fR
تولید امضاهای .imp (هش جدول آدرس‌های واردات PE) برای FILES.
.TP
\fB\-\-fuzzy\-img [FILES]\fR
تولید هش فازی تصویر برای هر فایل.

.SH "دستورات نرمال‌سازی فایل‌ها (COMMANDS TO NORMALIZE FILES)"
.LP
.TP
\fB\-\-html\-normalise=FILE\fR
ایجاد فایل‌های HTML نرمال‌شده comment.html ،nocomment.html و script.html در دایرکتوری کاری جاری.
.TP
\fB\-\-ascii\-normalise=FILE\fR
ایجاد فایل متنی نرمال‌شده از منبع اسکی (ASCII).
.TP
\fB\-\-utf16\-decode=FILE\fR
رمزگشایی داده‌های کدگذاری‌شده با UTF16.

.SH "دستورات تجزیه و تحلیل فایل (COMMANDS FOR FILE ANALYSIS)"
.LP
.TP
\fB\-\-vba=FILE\fR
استخراج ماکروهای VBA/Word6 از سند مایکروسافت آفیس مشخص‌شده.
.TP
\fB\-\-vba\-hex=FILE\fR
استخراج ماکروهای Word6 از سند مایکروسافت آفیس مشخص‌شده و نمایش مقادیر هگز متناظر.
.TP
\fB\-\-print\-certs=FILE\fR
چاپ جزئیات Authenticode از یک فایل PE.
.TP
\fB\-\-hex\-dump\fR
خواندن داده‌ها از ورودی استاندارد و نوشتن رشته هگز در خروجی استاندارد.

.SH "دستورات کار با فایل‌های CVD (COMMANDS FOR WORKING WITH CVDS)"
.LP
.TP
\fB\-i, \-\-info\fR
چاپ اطلاعات یک CVD و اعتبارسنجی MD5 و امضای دیجیتال.
.TP
\fB\-\-build=FILE, \-b FILE\fR
ساخت یک فایل CVD. سوییچ \-s یا \-\-server برای پایگاه‌های داده امضاشده ویروس (.cvd) یا \-\-unsigned برای فایل‌های امضانشده (.cud) الزامی است.
.TP
\fB\-\-max\-bad\-sigs=NUMBER\fR
حداکثر تعداد امضاهای نامطابق هنگام ساخت یک CVD. پیش‌فرض: 3000
.TP
\fB\-\-flevel\fR
مشخص کردن flevel سفارشی. پیش‌فرض: 77
.TP
\fB\-\-cvd\-version\fR
مشخص کردن شماره نسخه مورد استفاده برای ساخت. پیش‌فرض استفاده از مقدار 1+ نسخه فعلی CVD در \-\-datadir است. اگر هیچ فایل داده‌ای یافت نشود، رفتار پیش‌فرض درخواست شماره نسخه از کاربر است که این سوییچ مانع از این درخواست می‌شود.
نکته: اگر یک CVD در \-\-datadir یافت شود، نسخه 1+ آن استفاده شده و این مقدار نادیده گرفته می‌شود.
.TP
\fB\-\-no\-cdiff\fR
عدم ایجاد فایل .cdiff هنگام ساخت فایل پایگاه‌داده جدید.
.TP
\fB\-\-hybrid\fR
ایجاد فایل پایگاه‌داده ترکیبی (استاندارد و بایت‌کد).
.TP
\fB\-\-unsigned\fR
ایجاد فایل پایگاه‌داده بدون امضای دیجیتال (.cud).
.TP
\fB\-\-server=ADDR\fR
آدرس سرویس امضای ClamAV (تنها برای نگهدارندگان پایگاه‌داده ویروس).
.TP
\fB\-\-unpack=FILE, \-u FILE\fR
باز کردن بسته FILE (CVD) در دایرکتوری جاری.
.TP
\fB\-\-unpack\-current\fR
باز کردن بسته یک فایل CVD محلی (main یا daily) در دایرکتوری جاری.
.TP
\fB\-\-fips\-limits\fR
اعمال محدودیت‌های مشابه FIPS بر استفاده از الگوریتم‌های هش برای اهداف رمزنگاری. این گزینه امضاهای FP از نوع MD5 و SHA1 را غیرفعال کرده و برای تأیید اصالت CVD نیازمند فایل‌های '.sign' خواهد بود.

.SH "دستورات کار با فایل‌های پچ CDIFF (COMMANDS FOR WORKING WITH CDIFF PATCH FILES)"
.LP
.TP
\fB\-\-diff=OLD NEW, \-d OLD NEW\fR
ایجاد یک فایل diff برای CVDها یا INCDIRهای OLD و NEW.
.TP
\fB\-\-compare=OLD NEW, \-c OLD NEW\fR
این دستور دو فایل متنی را مقایسه کرده و تفاوت‌ها را در قالب cdiff چاپ می‌کند.
.TP
\fB\-\-run\-cdiff=FILE, \-r FILE\fR
اجرای اسکریپت به‌روزرسانی FILE در دایرکتوری جاری.
.TP
\fB\-\-verify\-cdiff=FILE, \-r FILE\fR
اعتبارسنجی DIFF در برابر CVD/INCDIR.

.SH "دستورات ایجاد و اعتبارسنجی امضاهای دیجیتال مجزا (COMMANDS FOR CREATING AND VERIFYING DETACHED DIGITAL SIGNATURES)"
.LP
.TP
\fB\-\-sign\fR
امضای یک فایل. نام فایل .sign حاصل به این صورت خواهد بود: dbname\-version.cvd.sign یا FILE.sign برای اهداف غیر CVD. این فایل در کنار فایل هدف ایجاد خواهد شد.
اگر یک فایل .sign از قبل وجود داشته باشد، امضای جدید به انتهای فایل اضافه می‌شود.
.TP
\fB\-\-key=FILE\fR
مشخص کردن کلید امضا.
.TP
\fB\-\-cert=FILE\fR
مشخص کردن گواهی امضا. می‌تواند بیش از یک بار برای افزودن گواهی‌های میانی و ریشه استفاده شود.
.TP
\fB\-\-append\fR
استفاده برای افزودن یک خط امضا به فایل .sign موجود. در غیر این صورت، فایل .sign موجود بازنویسی خواهد شد.
.TP
\fB\-\-verify\fR
یافتن و اعتبارسنجی یک امضای دیجیتال مجزا برای فایل داده‌شده.
نام فایل امضای دیجیتال باید به صورت dbname\-version.cvd.sign یا FILE.sign برای اهداف غیر CVD باشد.
این فایل باید در کنار فایل هدف قرار داشته باشد.
.TP
\fB\-\-cvdcertsdir=DIR\fR
مشخص کردن دایرکتوری حاوی گواهی ریشه CA مورد نیاز برای اعتبارسنجی امضا.
در صورت عدم ارائه، sigtool در دایرکتوری پیش‌فرض گواهی‌ها جستجو خواهد کرد.

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.LP
ابزار
.B sigtool
از متغیرهای محیطی زیر استفاده می‌کند:
.TP
\fBSIGNDUSER\fR
نام کاربری برای احراز هویت با سرور امضا هنگام ساخت پایگاه‌داده CVD امضاشده.
.TP
\fBSIGNDPASS\fR
رمز عبور برای احراز هویت با سرور امضا هنگام ساخت پایگاه‌داده CVD امضاشده.
.TP
\fBCVD_CERTS_DIR\fR
مشخص کردن دایرکتوری حاوی گواهی ریشه CA مورد نیاز برای اعتبارسنجی امضاهای دیجیتال مجزای CVD. در صورت عدم ارائه، sigtool در دایرکتوری پیش‌فرض جستجو خواهد کرد.

.SH "مثال‌ها (EXAMPLES)"
.LP
.TP
تولید رشته هگز از فایل آزمایشی و ذخیره آن در testfile.hex:

\fBcat testfile | sigtool \-\-hex\-dump > testfile.hex\fR

.SH "اعتبارات و تقدیرها (CREDITS)"
.LP
لطفاً برای اطلاعات مربوط به تقدیرها و اعتبارات به مستندات کامل مراجعه کنید.

.SH "نویسنده (AUTHOR)"
.LP
Tomasz Kojm <tkojm@clamav.net>

.SH "همچنین ببینید (SEE ALSO)"
.LP
.BR freshclam (1),
.BR freshclam.conf (5)