From: Przemyslaw Skibinski Date: Wed, 16 Nov 2016 09:53:06 +0000 (+0100) Subject: updated programs\README.md X-Git-Tag: upstream/1.9.3~42^2^2~2 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=632ab3b8d411b8da88ea8963992d2b8d2db5a7e9;p=platform%2Fupstream%2Flz4.git updated programs\README.md --- diff --git a/appveyor.yml b/appveyor.yml index d1245c8..2885e30 100644 --- a/appveyor.yml +++ b/appveyor.yml @@ -102,7 +102,7 @@ test_script: - ECHO *** && ECHO Testing %COMPILER% %PLATFORM% %CONFIGURATION% && ECHO *** - - if [%COMPILER%]==[unknown] ( + - if not [%COMPILER%]==[unknown] ( CD programs && lz4 -h && lz4 -i1b lz4.exe && @@ -120,7 +120,6 @@ artifacts: deploy: - provider: GitHub artifact: bin\lz4_x64.zip - release: lz4_x64-v$(appveyor_build_version) auth_token: secure: w6UJaGie0qbZvffr/fqyhO/Vj8rMiQWnv9a8qm3gxfngdHDTMT42wYupqJpIExId force_update: true @@ -128,11 +127,10 @@ deploy: on: COMPILER: gcc PLATFORM: "mingw64" - #appveyor_repo_tag: true + appveyor_repo_tag: true - provider: GitHub artifact: bin\lz4_x86.zip - release: lz4_x86-v$(appveyor_build_version) auth_token: secure: w6UJaGie0qbZvffr/fqyhO/Vj8rMiQWnv9a8qm3gxfngdHDTMT42wYupqJpIExId force_update: true @@ -140,4 +138,4 @@ deploy: on: COMPILER: gcc PLATFORM: "mingw32" - #appveyor_repo_tag: true + appveyor_repo_tag: true diff --git a/lib/dll/example/README.md b/lib/dll/example/README.md index 6f2b402..216c1e9 100644 --- a/lib/dll/example/README.md +++ b/lib/dll/example/README.md @@ -11,6 +11,19 @@ The static and dynamic LZ4 libraries - `static\liblz4_static.lib` : The static LZ4 library +#### Usage of Command Line Interface + +Command Line Interface (CLI) supports gzip-like arguments. +By default CLI takes an input file and compresses it to an output file: +``` +Usage: lz4 [arg] [input] [output] +``` +The full list of commands for CLI can be obtained with `-h` or `-H`. +The ratio can be improved with commands from `-3` to `-16` but higher levels also have slower compression. +CLI supports aggregation of parameters i.e. `-b1`, `-e18`, and `-i1` can be joined into `-b1e18i1`. +CLI includes in-memory compression benchmark module with compression levels starting from `-b` and ending with `-e` with iteration time of `-i` seconds. + + #### The example of usage of static and dynamic LZ4 libraries with gcc/MinGW Use `cd example` and `make` to build `fullbench-dll` and `fullbench-lib`. diff --git a/programs/README.md b/programs/README.md index b67408f..2ad0449 100644 --- a/programs/README.md +++ b/programs/README.md @@ -21,7 +21,7 @@ It makes benchmark more precise as it eliminates I/O overhead. The benchmark measures ratio, compressed size, compression and decompression speed. One can select compression levels starting from `-b` and ending with `-e`. -The `-i` parameter selects a number of iterations used for each of tested levels. +The `-i` parameter selects a number of seconds used for each of tested levels. @@ -39,6 +39,7 @@ Arguments : -d : decompression (default for .lz4 extension) -z : force compression -f : overwrite output without prompting +--rm : remove source file(s) after successful de/compression -h/-H : display help/long help and exit Advanced arguments : @@ -48,18 +49,20 @@ Advanced arguments : -c : force write to standard output, even if it is the console -t : test compressed file integrity -m : multiple input files (implies automatic output filenames) + -r : operate recursively on directories (sets also -m) -l : compress using Legacy format (Linux kernel compression) - -B# : Block size [4-7](default : 7) + -B# : Block size [4-7] (default : 7) -BD : Block dependency (improve compression ratio) --no-frame-crc : disable stream checksum (default:enabled) --content-size : compressed frame includes original size (default:not present) --[no-]sparse : sparse mode (default:enabled on file, disabled on stdout) Benchmark arguments : -Benchmark arguments : -b# : benchmark file(s), using # compression level (default : 1) - -e# : test all compression levels from -bX to # (default: 1) - -i# : iteration loops [1-9](default : 3), benchmark mode only - ``` + -e# : test all compression levels from -bX to # (default : 1) + -i# : minimum evaluation time in seconds (default : 3s) + -B# : cut file into independent blocks of size # bytes [32+] + or predefined block size [4-7] (default: 7) +``` #### License