.TH yara 1 "22 سپتامبر 2008" "Victor M. Alvarez" .SH "نام (NAME)" yara \- یافتن فایل‌های منطبق با الگوها و قوانین نوشته‌شده در یک زبان با کاربرد خاص .SH "خلاصه دستور (SYNOPSIS)" .B yara [OPTION]... [NAMESPACE:]RULES_FILE... FILE | DIR | PID .SH "توضیحات (DESCRIPTION)" دستور yara فایل داده‌شده، تمام فایل‌های موجود در دایرکتوری DIR یا فرایند مشخص‌شده با PID را برای یافتن تطابق با الگوها و قوانین ارائه‌شده در یک زبان با کاربرد خاص بررسی می‌کند. این قوانین از یک یا چند RULES_FILE خوانده می‌شوند. .PP گزینه‌های .IR yara (1) عبارتند از: .TP .B " --atom-quality-table" مسیر فایلی شامل جدول کیفیت اتم (atom quality table). .TP .B \-C " --compiled-rules" فایل RULES_FILE شامل قوانینی است که از پیش با yarac کامپایل شده‌اند. .TP .B \-c " --count" تنها تعداد تطابق‌ها را چاپ می‌کند. .TP .BI "\-d --define"=identifier=value تعریف یک متغیر خارجی. این گزینه می‌تواند چندین بار استفاده شود. .TP .B " --fail-on-warnings" در نظر گرفتن هشدارها به عنوان خطا. در صورت استفادهٔ هم‌زمان با .B --no-warnings هیچ اثری ندارد. .TP .B \-f " --fast-scan" افزایش سرعت بررسی با جستجوی تنها اولین رخداد از هر الگو. .TP .BI \-i " identifier" " --identifier=" identifier تنها قوانین با نام .I identifier را چاپ کرده و بقیه را نادیده می‌گیرد. این گزینه می‌تواند چندین بار استفاده شود. .TP .BI " --max-process-memory-chunk=" size هنگام بررسی حافظهٔ فرایند، داده‌ها را در تکه‌هایی به اندازهٔ مشخص‌شده با .I size (بر حسب بایت) می‌خواند. .TP .BI \-l " number" " --max-rules=" number متوقف کردن بررسی پس از تطابق به تعداد .I number از قوانین. .TP .BI " --max-strings-per-rule=" number تنظیم حداکثر تعداد رشته‌ها در هر قانون (پیش‌فرض=10000). .TP .BI "\-x --module-data"=module=file ارسال محتوای فایل به عنوان دادهٔ اضافی به ماژول. این گزینه می‌تواند چندین بار استفاده شود. .TP .B \-n " --negate" چاپ قوانینی که صدق نمی‌کنند (نقیض). .TP .B \-w " --no-warnings" غیرفعال کردن هشدارها. .TP .B \-m " --print-meta" چاپ فراداده‌های (metadata) مرتبط با قانون. .TP .B \-D " --print-module-data" چاپ داده‌های ماژول. .TP .B \-M " --module-names" نمایش نام ماژول‌ها. .TP .B \-e " --print-namespace" چاپ فضای نام (namespace) مرتبط با قانون. .TP .B \-S " --print-stats" چاپ آمار قوانین. .TP .B \-s " --print-strings" چاپ رشته‌های یافت‌شده در فایل. .TP .B \-L " --print-string-length" چاپ طول رشته‌های یافت‌شده در فایل. .TP .B \-X " --print-xor-key" چاپ کلید xor رشته‌های منطبق‌شده. .TP .B \-g " --print-tags" چاپ برچسب‌های مرتبط با قانون. .TP .B \-r " --recursive" بررسی بازگشتی فایل‌ها در دایرکتوری‌ها. پیوندهای نمادین (symlinks) دنبال می‌شوند. .TP .BI " --scan-list" بررسی فایل‌های فهرست‌شده در FILE، در هر خط یک مورد. .TP .BI \-z " size" " --skip-larger=" size هنگام بررسی یک دایرکتوری، از فایل‌های بزرگ‌تر از .I size مشخص‌شده (بر حسب بایت) صرف‌نظر می‌کند. .TP .BI \-k " slots" " --stack-size=" slots تنظیم حداکثر اندازهٔ پشته به تعداد مشخص‌شده با .I slots. .TP .BI " --strict-escape" چاپ هشدار در صورتی که قوانین شامل عبارات گریز (escape statements) مبهم باشند. .TP .BI \-t " tag" " --tag=" tag تنها قوانین با برچسب .I tag را چاپ کرده و بقیه را نادیده می‌گیرد. این گزینه می‌تواند چندین بار استفاده شود. .TP .BI \-p " number" " --threads=" number استفاده از تعداد مشخص‌شده با .I number رشته (thread) برای بررسی یک دایرکتوری. .TP .BI \-a " seconds" " --timeout=" seconds متوقف کردن بررسی پس از گذشت مدت‌زمان مشخص‌شده به .I seconds (بر حسب ثانیه). .TP .B \-v " --version" نمایش اطلاعات نسخه. .SH "مثال‌ها (EXAMPLES)" $ yara /foo/bar/rules . .RS .PP اعمال قوانین موجود در .I /foo/bar/rules بر روی تمام فایل‌های دایرکتوری جاری. زیردایرکتوری‌ها بررسی نمی‌شوند. .RE .PP $ yara -t Packer -t Compiler /foo/bar/rules bazfile .RS .PP اعمال قوانین موجود در .I /foo/bar/rules بر روی .I bazfile. تنها قوانینی گزارش می‌شوند که دارای برچسب .I Packer یا .I Compiler باشند. .RE .PP $ cat /foo/bar/rules | yara -r /foo .RS .PP بررسی تمام فایل‌های درون دایرکتوری .I /foo و زیردایرکتوری‌های آن. قوانین از ورودی استاندارد خوانده می‌شوند. .RE .PP $ yara -d mybool=true -d myint=5 -d mystring="my string" /foo/bar/rules bazfile .RS .PP سه متغیر خارجی .IR mybool ، .I myint و .I mystring را تعریف می‌کند. .RE .PP $ yara -x cuckoo=cuckoo_json_report /foo/bar/rules bazfile .RS .PP اعمال قوانین موجود در .I /foo/bar/rules بر روی .I bazfile هم‌زمان با ارسال محتوای .I cuckoo_json_report به ماژول cuckoo. .RE .SH "نویسندگان (AUTHORS)" Victor M. Alvarez ;