Browse code

Add yara documentation to docs/signatures.*

Steven Morgan authored on 2015/08/12 01:53:09
Showing 2 changed files
1 1
Binary files a/docs/signatures.pdf and b/docs/signatures.pdf differ
... ...
@@ -777,7 +777,7 @@ Entertainment Pack FreeCell Game
777 777
     \subsection{Trusted and Revoked Certificates}
778 778
     Clamav 0.98 checks signed PE files for certificates and verifies each
779 779
     certificate in the chain against a database of trusted and revoked
780
-    certificates. The sinagure format is
780
+    certificates. The signature format is
781 781
 \begin{verbatim}
782 782
 Name;Trusted;Subject;Serial;Pubkey;Exponent;CodeSign;TimeSign;CertSign;
783 783
 NotBefore;Comment[;minFL[;maxFL]]
... ...
@@ -915,6 +915,24 @@ Eicar-Test-Signature:bc356bae4c42f19a3de16e333ba3569c
915 915
 	      (\_) in malware names, never use space, apostrophe or quote mark.
916 916
     \end{itemize}
917 917
 
918
+    \subsection{Using YARA rules in ClamAV}
919
+    ClamAV version 0.99 and above can process YARA rules. ClamAV virus database file names ending
920
+    with ``.yar'' or ``.yara'' are parsed as yara rule files. The link to the YARA rule grammar
921
+    documentation may be found at http://plusvic.github.io/yara/. There are currently a few 
922
+    limitations on using YARA rules within ClamAV:
923
+    \begin{itemize}
924
+        \item YARA modules are not yet supported by ClamAV. This includes the ``import''
925
+        keyword and any YARA module-specific keywords.
926
+        \item Global rules(``global'' keyword) are not supported by ClamAV.
927
+        \item External variables(``contains'' and ``matches'' keywords) are not supported.
928
+        \item YARA rules pre-compiled with the \emph{yarac} command are not supported.
929
+        \item As in the ClamAV logical and extended signature formats, YARA strings and segments
930
+        of strings separated by wild cards must represent at least two octets of data.
931
+        \item There is a maximum of 64 strings per YARA rule.
932
+        \item YARA rules in ClamAV must contain at least one literal, hexadecimal, or
933
+        regular expression string.
934
+    \end{itemize}
935
+
918 936
     \section{Special files}
919 937
 
920 938
     \subsection{HTML}