yara(1)                     General Commands Manual                    yara(1)

<?><?><?> (NAME)
       yara - <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       yara [OPTION]... [NAMESPACE:]RULES_FILE... FILE | DIR | PID

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> yara <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> DIR <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> PID <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?> RULES_FILE
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> yara(1) <?><?><?><?><?><?><?> <?><?>:

           --atom-quality-table
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?> (atom quality table).

       -C  --compiled-rules
              <?><?><?><?> RULES_FILE <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?> <?><?> <?><?> <?><?><?> <?><?> yarac
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       -c  --count
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?>.

       -d  --define=identifier=value
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>.
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

           --fail-on-warnings
              <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?>. <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              --no-warnings <?><?><?> <?><?><?><?> <?><?><?><?><?>.

       -f  --fast-scan
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?>.

       -i identifier --identifier=identifier
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> identifier
              <?><?> <?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

           --max-process-memory-chunk=size
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> size (<?><?> <?><?><?>
              <?><?><?><?>) <?><?><?><?><?><?><?><?>.

       -l number --max-rules=number
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> number <?><?>
              <?><?><?><?><?><?>.

           --max-strings-per-rule=number
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              (<?><?><?><?><?><?><?>=10000).

       -x  --module-data=module=file
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>.

       -n  --negate
              <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> (<?><?><?><?>).

       -w  --no-warnings
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       -m  --print-meta
              <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (metadata)
              <?><?><?><?><?> <?><?> <?><?><?><?><?>.

       -D  --print-module-data
              <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>.

       -M  --module-names
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>.

       -e  --print-namespace
              <?><?><?> <?><?><?><?> <?><?><?> (namespace) <?><?><?><?><?>
              <?><?> <?><?><?><?><?>.

       -S  --print-stats
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       -s  --print-strings
              <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?>.

       -L  --print-string-length
              <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>.

       -X  --print-xor-key
              <?><?><?> <?><?><?><?> xor <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?>.

       -g  --print-tags
              <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?>.

       -r  --recursive
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (symlinks)
              <?><?><?><?><?> <?><?><?><?><?><?><?>.

           --scan-list
              <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> FILE<?> <?><?> <?><?> <?><?>
              <?><?> <?><?><?><?>.

       -z size --skip-larger=size
              <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> size <?><?><?><?><?><?><?><?>
              (<?><?> <?><?><?> <?><?><?><?>) <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.

       -k slots --stack-size=slots
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?> slots.

           --strict-escape
              <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              (escape statements) <?><?><?><?> <?><?><?><?><?>.

       -t tag --tag=tag
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> tag
              <?><?> <?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       -p number --threads=number
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> number <?><?><?><?> (thread)
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>.

       -a seconds --timeout=seconds
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?> seconds (<?><?> <?><?><?> <?><?><?><?><?>).

       -v  --version
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       $ yara /foo/bar/rules .

              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              /foo/bar/rules <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?>. <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       $ yara -t Packer -t Compiler /foo/bar/rules bazfile

              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              /foo/bar/rules <?><?> <?><?><?> bazfile.  <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> Packer <?><?> Compiler
              <?><?><?><?><?>.

       $ cat /foo/bar/rules | yara -r /foo

              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> /foo <?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>.
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       $ yara -d mybool=true -d myint=5 -d mystring="my string" /foo/bar/rules
       bazfile

              <?><?> <?><?><?><?><?> <?><?><?><?><?> mybool<?> myint <?>
              mystring <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       $ yara -x cuckoo=cuckoo_json_report /foo/bar/rules bazfile

              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              /foo/bar/rules <?><?> <?><?><?> bazfile <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?> cuckoo_json_report
              <?><?> <?><?><?><?><?> cuckoo.


<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Victor M. Alvarez <plusvic@gmail.com>;<vmalvarez@virustotal.com>

Victor M. Alvarez        22 <?><?><?><?><?><?><?> 2008                 yara(1)