نام (NAME)

afl-cmin.bash - ابزار بهینه‌سازی و کمینه‌سازی پیکره آزمون (corpus minimization) در AFL++

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

afl-cmin.bash [ گزینه‌ها ] -- /path/to/target_app [ ... ]

گزینه‌ها (OPTIONS)

پارامترهای الزامی:
  -i dir        - دایرکتوری ورودی حاوی پیکره اولیه آزمون
  -o dir        - دایرکتوری خروجی برای پرونده‌های کمینه‌شده
تنظیمات کنترل اجرا:
  -T tasks      - تعداد فرآیندهای موازی برای ایجاد (پیش‌فرض: 1، "all"=nproc)
  -f file       - پرونده خوانده‌شده توسط برنامه تحت فازینگ (پیش‌فرض: stdin)
  -m megs       - محدودیت حافظه برای فرآیند فرزند (پیش‌فرض: none مگابایت)
  -t msec       - محدودیت زمان اجرا برای فرآیند فرزند (پیش‌فرض: 5000 میلی‌ثانیه)
  -O            - استفاده از ابزار دقیق فقط باینری (حالت FRIDA)
  -Q            - استفاده از ابزار دقیق فقط باینری (حالت QEMU)
  -U            - استفاده از ابزار دقیق مبتنی بر Unicorn (حالت Unicorn)
  -X            - استفاده از حالت Nyx
تنظیمات کمینه‌سازی:
  -A            - مجاز دانستن ورودی‌های دچار فروپاشی (crash) و اتمام مهلت زمانی (timeout)
  -C            - نگه‌داشتن ورودی‌های دچار فروپاشی و رد کردن سایر موارد
  -e            - حل صرفاً برای پوشش لبه‌ها، نادیده گرفتن تعداد دفعات برخورد (hit counts)
برای نکات بیشتر، لطفاً به README.md مراجعه کنید.
این اسکریپت نمی‌تواند نام پرونده‌هایی که به فاصله ' ' ختم می‌شوند را بخواند.
متغیرهای محیطی مورد استفاده:
AFL_KEEP_TRACES: باقی گذاشتن دایرکتوری موقت <out_dir>/.traces
AFL_NO_FORKSRV: اجرای برنامه هدف از طریق execve به‌جای استفاده از forkserver
AFL_PATH: آخرین محل برای جستجو و یافتن باینری afl-showmap
AFL_SKIP_BIN_CHECK: صرف‌نظر از بررسی باینری برنامه هدف
AFL_CUSTOM_MUTATOR_LIBRARY: کتابخانه جهش‌دهنده سفارشی (post_process و send)
AFL_PYTHON_MODULE: ماژول پایتون جهش‌دهنده سفارشی (post_process و send)

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

پروژه AFL++ توسط Michal "lcamtuf" Zalewski نوشته شده است و توسط Marc "van Hauser" Heuse <mh@mh-sec.de>، Dominik Maier <domenukk@gmail.com>، Andrea Fioraldi <andreafioraldi@gmail.com> و Heiko "hexcoder-" Eissfeldt <heiko.eissfeldt@hexco.de> نگهداری می‌شود. صفحه خانگی AFL++ در نشانی زیر در دسترس است: https://github.com/AFLplusplus/AFLplusplus

مجوز (LICENSE)

پروژه AFL++ تحت مجوز AGPL-3.0-or-later منتشر شده است، همراه با بخش‌های اصلی تحت Apache-2.0؛ یک مجوز تجاری اختیاری نیز در دسترس است. مشاهده کنید: https://github.com/AFLplusplus/AFLplusplus/blob/stable/LICENSING.md