adds app

.gitignore

@@ -0,0 +1 @@
+/target

.travis.yml

@@ -0,0 +1,21 @@
+sudo: false
+
+os: linux
+dist: trusty
+
+language: rust
+
+rust:
+  - stable
+  - beta
+  - nightly
+
+matrix:
+  allow_failures:
+    - rust: nightly
+
+cache: cargo
+
+env:
+  global:
+    - CARGO_BUILD_JOBS="2"

Cargo.toml

@@ -0,0 +1,18 @@
+[package]
+name = "strace-analyzer"
+version = "0.3.0"
+authors = ["Christian Krause <[email protected]>"]
+description = "analyze strace output"
+license = "GPL-3.0-or-later"
+readme = "README.md"
+documentation = "https://github.com/wookietreiber/strace-analyzer"
+homepage = "https://github.com/wookietreiber/strace-analyzer"
+repository = "https://github.com/wookietreiber/strace-analyzer"
+keywords = ["strace"]
+categories = ["command-line-utilities"]
+
+[dependencies]
+bytesize = "^1"
+clap = "^2"
+lazy_static = "^1"
+regex = "^1"

README.md

@@ -3,5 +3,96 @@ strace analyzer
 
 Analyzes [strace][] output.
 
+Pre-built packages can be downloaded from the [GitHub releases page][releases].
 
+
+building
+--------
+
+build dependencies:
+
+- [rust][]
+
+```bash
+git clone https://github.com/wookietreiber/strace-analyzer.git
+cd strace-analyzer
+cargo build --release
+install -Dm755 target/release/strace-analyzer ~/bin/strace-analyzer
+```
+
+
+usage
+-----
+
+Create logs:
+
+```bash
+strace -s 0 -ff -o cmd.strace cmd
+```
+
+Analyze logs, with `xxx` being the first process ID, the analysis will follow
+forked processes automatically:
+
+```
+strace-analyzer cmd.strace.xxx
+```
+
+
+caveats
+-------
+
+-   does only work with traces created with the usage example above, there is
+    no support for logs that contain output of multiple process ids
+
+
+issues, features, use-cases, wish list
+--------------------------------------
+
+-   If you think of a new (possibly high-level) analysis use case or how to
+    improve an existing one, please [open an issue][newissue]. If you have an
+    idea on how the output should look like, feel free to include a sketch of
+    an example.
+
+-   If you recognize missing file associations in the output, i.e. bare file
+    descriptor numbers without a note as to why it could not be identified,
+    please [open an issue][newissue] and provide access to that particular,
+    complete strace log, so I am able to identify the problem.
+
+    If you know that a particular file should be included, because you know
+    that file has been opened, it would be of great help if you would name
+    these files in the issue.
+
+
+features that will not be implemented
+-------------------------------------
+
+In the spirit of the Unix philosohpy of **do one thing and do it well**,
+strace-analyzer will **not** do any of the following:
+
+-   *filtering*, use tools like [grep][] or [awk][], e.g.:
+
+    ```bash
+    strace-analyzer cmd.strace.1835 | grep pattern
+    strace-analyzer cmd.strace.1835 | awk '/pattern/'
+    ```
+
+-   *sorting*, use the [sort][] command line utility, e.g.:
+
+    ```bash
+    strace-analyzer cmd.strace.27049 | sort -k9
+    ```
+
+-   pretty *tabular output*, use the [column][] command line utility, e.g.:
+
+    ```bash
+    strace-analyzer read strace.log.27049 | column -t
+    ```
+
+
+[awk]: http://man7.org/linux/man-pages/man1/gawk.1.html "gawk man page"
+[column]: http://man7.org/linux/man-pages/man1/column.1.html "column man page"
+[grep]: http://man7.org/linux/man-pages/man1/grep.1.html "grep man page"
+[releases]: https://github.com/wookietreiber/strace-analyzer/releases "pre-built strace-analyzer releases"
+[rust]: https://www.rust-lang.org/ "rust programming language home page"
+[sort]: http://man7.org/linux/man-pages/man1/sort.1.html "sort man page"
 [strace]: http://sourceforge.net/projects/strace/ "strace home page"