From: Karel Kočí <cynerd@email.cz>
Date: Thu, 21 May 2015 23:58:57 +0000 (+0200)
Subject: Add simple readme
X-Git-Tag: v201509~135
X-Git-Url: https://rtime.felk.cvut.cz/gitweb/linux-conf-perf.git/commitdiff_plain/a553aba5abd8b314f17e71ea694196ee54012254

Add simple readme
---

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ed06eb9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,39 @@
+# linux-conf-perf
+This is tool for automatic performance analysis.
+It calculates impact on performance per symbol.
+
+TOOL IS IN DEVELOPMENT AND NOT WORKING PROPERLY
+
+### Folders
+* `scripts` In this folder are all python scripts
+	* `pase_kconfig` Contains program for extracting dependences from Kconfig files to format for PicoSAT.
+	* `write_config` Fixes configuration and compares it against generated one.
+	* `permute_conf` Interactive program for setting measure base.
+	* `shared` Shared files
+	* `novaboot` Script Novaboot
+	* `picosat-959` Program PicoSAT
+* `jobfiles` In this folder are placed files generated with local scripts.
+* `output` Contains output of executed boots.
+* `result` In this folder are expected to be files with values from benchmarks.
+* `log` To this folder are logged all program outputs.
+* `linux` Submodule of linux kernel
+* `buildroot` Submodule of Buildroot
+
+### Configuration files
+Main configuration is in file `conf.py` and has python syntax.
+Important settings are commented inside file.
+Configuration must be done before executing `make run` or `make init`.
+
+### Usage
+Before any other steps, create Linux configuration and setup boot target with benchmark.
+You can run `make test` for testing if setup is correct.
+
+For configuration of measured symbols, run `make mpermute_conf`.
+
+To execute tests, run `make run`.
+
+Output of benchmarks must be analyzed after execution of all different configurations.
+Files in folder `output` contains benchmark outputs. You should ensure, that values for
+benchmark are extracted and saved to folder `result` to file with same name as source.
+
+Final evaluation is done by `make evaluate`.