<commit_before># cuckoo-osx-analyzer
My [GSoC project](http://www.google-melange.com/gsoc/project/details/google/gsoc2015/rodionovd/5649050225344512) aiming at building an OS X analyzer for [Cuckoo Sandbox](http://www.cuckoosandbox.org/) project.  

:warning: **WIP** :warning:  
----

### Usage


##### Guest machine setup


 0. Install `pt_deny_attach` kernel extension suggested by @phretor. That's an optional step, see [this comment](https://github.com/rodionovd/cuckoo-osx-analyzer/issues/6#issuecomment-101322097) for more details.

 1. Currently, this analyser uses `dtrace`, so the guest OS user must be able to launch this utility without a password prompt. This may be accomplished by modifying `/etc/sudoers` file:  

```diff
--- a/etc/sudoers
+++ b/etc/sudoers
@@ -43,3 +43,5 @@ root  ALL=(ALL) ALL
 # Samples
 # %users  ALL=/sbin/mount /cdrom,/sbin/umount /cdrom
 # %users  localhost=/sbin/shutdown -h now
+
+ username   ALL=(root) NOPASSWD: /usr/sbin/dtrace
```<commit_msg>README: add note about bootstrap_guest.sh<commit_after># cuckoo-osx-analyzer
My [GSoC project](http://www.google-melange.com/gsoc/project/details/google/gsoc2015/rodionovd/5649050225344512) aiming at building an OS X analyzer for [Cuckoo Sandbox](http://www.cuckoosandbox.org/) project.  

:warning: **WIP** :warning:  
----

### Usage


##### Guest machine setup

> You can also use [`bootstrap_guest.sh`](./scripts/bootstrap_guest.sh) script for setting your guest machine up.


 0. Install `pt_deny_attach` kernel extension suggested by @phretor. That's an optional step, see [this comment](https://github.com/rodionovd/cuckoo-osx-analyzer/issues/6#issuecomment-101322097) for more details.

 1. Currently, this analyser uses `dtrace`, so the guest OS user must be able to launch this utility without a password prompt. This may be accomplished by modifying `/etc/sudoers` file:  

```diff
--- a/etc/sudoers
+++ b/etc/sudoers
@@ -43,3 +43,5 @@ root  ALL=(ALL) ALL
 # Samples
 # %users  ALL=/sbin/mount /cdrom,/sbin/umount /cdrom
 # %users  localhost=/sbin/shutdown -h now
+
+ username   ALL=(root) NOPASSWD: /usr/sbin/dtrace
```
{'fraction_non_alphanumeric': 0.1411042944785276, 'fraction_numerical': 0.03586597451628126, 'mean_word_length': 4.247524752475248, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 4, 'https://': 2, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1933369', 'n_tokens_mistral': 811, 'n_tokens_neox': 725, 'n_words': 200}