نام (NAME)

ssdeep - محاسبه درهم‌سازی تکه‌ای برانگیخته با بافت (درهم‌سازی فازی)

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

ssdeep [-m <file>] [-k <file>] [-vdprgsblcxa] [-t val] [FILES]
ssdeep [-V|h]

توضیحات (DESCRIPTION)

یک امضا بر اساس درهم‌سازی تکه‌ای برانگیخته با بافت (context triggered piecewise hashes) برای هر فایل ورودی محاسبه می‌کند که درهم‌سازی فازی (fuzzy hash) نیز نامیده می‌شود. در صورت درخواست، برنامه این امضاها را با یک فایل از امضاهای شناخته‌شده تطبیق داده و هرگونه تطابق احتمالی را گزارش می‌کند. همچنین می‌تواند یک یا چند فایل از امضاها را بررسی کرده و هرگونه تطابق را در آن فایل‌ها بیابد. خروجی در خروجی استاندارد و خطاها در خطای استاندارد نوشته می‌شوند.

-m <file>

فایل مشخص‌شده از درهم‌ساز‌های شناخته‌شده را برای تطبیق بارگیری می‌کند. این فایل باید از خروجی‌های قبلی برنامه باشد. برنامه سپس هر ورودی در FILES را درهم‌سازی کرده و این امضاها را با امضاهای شناخته‌شده مقایسه می‌کند. هر تطابقی که امتیازش بالاتر از مقدار آستانه باشد نمایش داده می‌شود. این پرچم می‌تواند چندین بار برای بارگیری امضاهای شناخته‌شدهٔ بیشتر استفاده شود. از این پرچم نمی‌توان همراه با پرچم‌های -k یا -x استفاده کرد.

-k <file>

فایل مشخص‌شده از درهم‌ساز‌های شناخته‌شده را برای تطبیق بارگیری می‌کند. این فایل باید از خروجی‌های قبلی برنامه باشد. سپس برنامه با هر ورودی در FILES نیز مانند مجموعه‌ای از درهم‌ساز‌های شناخته‌شده رفتار می‌کند. درهم‌ساز‌ها در این FILES با درهم‌ساز‌های شناخته‌شدهٔ این فایل مقایسه می‌شوند. تطابق‌هایی که امتیازی بالاتر از مقدار آستانه داشته باشند نمایش داده می‌شوند. هم فایل مشخص‌شده در اینجا و هم FILES ورودی باید حاوی درهم‌ساز‌های فازی باشند. این پرچم می‌تواند چندین بار برای بارگیری امضاهای شناخته‌شدهٔ بیشتر استفاده شود. از این پرچم نمی‌توان همراه با پرچم‌های -m، -d یا -p استفاده کرد.

-v

حالت پرگو (verbose). نام هر فایل هنگام درهم‌سازی در خطای استاندارد چاپ می‌شود.

-d

برای هر ورودی در FILES یک امضا محاسبه کرده و آن را با مجموعهٔ امضاهای شناخته‌شده مقایسه می‌کند. تطابق‌هایی که امتیازی بالاتر از مقدار آستانه داشته باشند نمایش داده می‌شوند. امضای محاسبه‌شده سپس به مجموعهٔ امضاهای شناخته‌شده اضافه می‌شود. از این پرچم نمی‌توان همراه با پرچم‌های -k یا -x استفاده کرد.

-p

مانند پرچم -d عمل می‌کند، اما تمام تطابق‌ها را برای هر فایل نمایش می‌دهد؛ یعنی برای دو فایل A و B که امتیاز تطابق آن‌ها بالاتر از آستانه باشد، “A matches B” و “B matches A” را نمایش می‌دهد. از این پرچم نمی‌توان همراه با پرچم‌های -k یا -x استفاده کرد.

-r

حالت بازگشتی را فعال می‌کند. تمام زیردایرکتوری‌ها پیمایش می‌شوند. لطفاً توجه داشته باشید که از حالت بازگشتی نمی‌توان برای بررسی تمام فایل‌های دارای یک پسوند خاص استفاده کرد. برای مثال، فراخوانی برنامه با -r *.txt تمام فایل‌های موجود در دایرکتوری‌هایی را بررسی می‌کند که نامشان به .txt ختم می‌شود. اگر می‌خواهید تمام فایل‌های دارای پسوند .txt در یک درخت دایرکتوری را پردازش کنید، از دستور find(1) استفاده کنید.

-g

فایل‌های مشابه را در خوشه‌ها گروه‌بندی می‌کند. این گزینه می‌تواند برای یافتن فایل‌های مشابهِ بیشتر مفید باشد؛ یعنی اگر در جستجوی فایل A باشید که با B مطابقت دارد، هر آنچه با B نیز مطابقت داشته باشد در این خوشه گنجانده خواهد شد.

-s

حالت خاموش (silent). تمام پیام‌های خطا نادیده گرفته می‌شوند.

-b

حالت ساده (bare) را فعال می‌کند. تمام اطلاعات دایرکتوری ابتدای نام‌ فایل‌های نمایش‌داده‌شده را حذف می‌کند. از این پرچم نمی‌توان در کنار پرچم -l استفاده کرد.

-l

مسیرهای نسبی فایل را فعال می‌کند. به‌جای چاپ مسیر مطلق برای هر فایل، مسیر نسبی فایل را همان‌طور که در خط فرمان مشخص شده نمایش می‌دهد. از این پرچم نمی‌توان در کنار پرچم -b استفاده کرد.

-c

حالت خروجی جداشده با کاما (comma separated) را فعال می‌کند. در هر یک از حالت‌های تطبیق -d، -p یا -m، نتایج را به‌صورت فایل ورودی، فایل شناخته‌شده، امتیاز تطبیق نمایش می‌دهد.

-x

تطبیق فایل امضا. هر ورودی در FILES باید حاوی امضاهایی باشد که توسط خروجی قبلی برنامه تولید شده‌اند. هر امضا بارگیری شده و با مجموعهٔ درهم‌ساز‌های شناخته‌شده مقایسه می‌شود. امتیازهای تطابق بالاتر از آستانه نمایش داده می‌شوند. سپس هر امضا به مجموعهٔ شناخته‌شده‌ها اضافه می‌شود. از این پرچم نمی‌توان همراه با پرچم‌های -m، -d یا -p استفاده کرد.

-a

تمام تطابق‌ها را در هر یک از حالت‌های تطبیق، صرف‌نظر از امتیاز، نمایش می‌دهد. استفاده از پرچم -a تمام نتایج را نمایش می‌دهد، حتی اگر امتیاز تطابق صفر باشد.

-t <val>

در هر یک از حالت‌های تطبیق، نتایج را تنها زمانی نمایش می‌دهد که امتیاز تطابق بزرگ‌تر از مقدار داده‌شده باشد. مقدار آستانه پیش‌فرض صفر است.

-h

نمایش صفحهٔ راهنما و خروج.

-V

نمایش شماره نسخه و خروج.

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

در صورت موفقیت مقدار 0 و در صورت بروز مشکل مقدار 1 را برمی‌گرداند. خطاهای خواندن، عدم دسترسی (permission denied)، و برخورد با دایرکتوری‌ها در زمانی که حالت بازگشتی فعال نیست، همچنان موفقیت‌آمیز در نظر گرفته می‌شوند. مشکلات شامل مواردی مانند ناتوانی در بارگیری فایل تطبیق، مشخص کردن هم‌زمان مسیرهای ساده و نسبی و غیره است.

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

برنامه ssdeep توسط Jesse Kornblum از Facebook نوشته شده است،
research@jessekornblum.com

کپی‌رایت و تکثیر (COPYRIGHT)

Copyright (C) 2002 Andrew Tridgell
Copyright (C) 2006, 2008, 2010 ManTech International Corporation
Copyright (C) 2012 Kyrus
Copyright (C) 2013 Helmut Grohne
Copyright (C) 2013, 2014 Facebook
Copyright (C) 2014 kikairoya
Copyright (C) 2014 Jesse Kornblum
Copyright (C) 2017 Tsukasa OI

این برنامه تحت شرایط مجوز General Public License مجاز شده است. برای جزئیات بیشتر به فایل COPYING مراجعه کنید.

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

این برنامه بر پایهٔ SpamSum اثر Dr. Andrews Tridgell ساخته شده است.
http://www.samba.org/ftp/unpacked/junkcode/spamsum