This is a good readme, the instructions for compiling and testing work. Reviewed-by: Daniel Axtens <dja@xxxxxxxxxx> Regards, Daniel Raphael Moreira Zinsly <rzinsly@xxxxxxxxxxxxx> writes: > Include a README file with the instructions to use the > testcases at selftests/powerpc/nx-gzip. > > Signed-off-by: Bulent Abali <abali@xxxxxxxxxx> > Signed-off-by: Raphael Moreira Zinsly <rzinsly@xxxxxxxxxxxxx> > --- > .../powerpc/nx-gzip/99-nx-gzip.rules | 1 + > .../testing/selftests/powerpc/nx-gzip/README | 44 +++++++++++++++++++ > 2 files changed, 45 insertions(+) > create mode 100644 tools/testing/selftests/powerpc/nx-gzip/99-nx-gzip.rules > create mode 100644 tools/testing/selftests/powerpc/nx-gzip/README > > diff --git a/tools/testing/selftests/powerpc/nx-gzip/99-nx-gzip.rules b/tools/testing/selftests/powerpc/nx-gzip/99-nx-gzip.rules > new file mode 100644 > index 000000000000..5a7118495cb3 > --- /dev/null > +++ b/tools/testing/selftests/powerpc/nx-gzip/99-nx-gzip.rules > @@ -0,0 +1 @@ > +SUBSYSTEM=="nxgzip", KERNEL=="nx-gzip", MODE="0666" > diff --git a/tools/testing/selftests/powerpc/nx-gzip/README b/tools/testing/selftests/powerpc/nx-gzip/README > new file mode 100644 > index 000000000000..ff0c817a65c5 > --- /dev/null > +++ b/tools/testing/selftests/powerpc/nx-gzip/README > @@ -0,0 +1,44 @@ > +Test the nx-gzip function: > +========================= > + > +Verify that following device exists: > + /dev/crypto/nx-gzip > +If you get a permission error run as sudo or set the device permissions: > + sudo chmod go+rw /dev/crypto/nx-gzip > +However, chmod may not survive across boots. You may create a udev file such > +as: > + /etc/udev/rules.d/99-nx-gzip.rules > + > + > +Then make and run: > +$ make > +gcc -O3 -I./inc -o gzfht_test gzfht_test.c gzip_vas.c > +gcc -O3 -I./inc -o gunz_test gunz_test.c gzip_vas.c > + > + > +Compress any file using Fixed Huffman mode. Output will have a .nx.gz suffix: > +$ ./gzfht_test gzip_vas.c > +file gzip_vas.c read, 5276 bytes > +compressed 5276 to 2564 bytes total, crc32 checksum = b937a37d > + > + > +Uncompress the previous output. Output will have a .nx.gunzip suffix: > +$ ./gunz_test gzip_vas.c.nx.gz > +gzHeader FLG 0 > +00 00 00 00 04 03 > +gzHeader MTIME, XFL, OS ignored > +computed checksum b937a37d isize 0000149c > +stored checksum b937a37d isize 0000149c > +decomp is complete: fclose > + > + > +Compare two files: > +$ sha1sum gzip_vas.c.nx.gz.nx.gunzip gzip_vas.c > +f041cd8581e8d920f79f6ce7f65411be5d026c2a gzip_vas.c.nx.gz.nx.gunzip > +f041cd8581e8d920f79f6ce7f65411be5d026c2a gzip_vas.c > + > + > +Note that the code here are intended for testing the nx-gzip hardware function. > +They are not intended for demonstrating performance or compression ratio. > +For more information and source code consider using: > +https://github.com/libnxz/power-gzip > -- > 2.21.0