Update readme.txt after API changes. 12/73512/6
authorDariusz Michaluk <d.michaluk@samsung.com>
Wed, 8 Jun 2016 09:58:03 +0000 (11:58 +0200)
committerDariusz Michaluk <d.michaluk@samsung.com>
Wed, 8 Jun 2016 12:32:07 +0000 (14:32 +0200)
Change-Id: Icc18e8370c02e8d9aba507924b4f39bf45dad7f7

readme.txt

index b0fe7f2..664632f 100644 (file)
@@ -2,39 +2,35 @@ YACA - Yet Another Crypto API
 
 Basic information:
 
-Code Style (for now):
-       Tabs (8-chars) + spaces;
-       $ astyle -T8 <file>
+Code Style:
+       Tizen coding style (doc/coding-rules.txt)
 
 Project structure:
-       api/ - Public API (headers)
-
-       demos/ - Demo applications
-       doc/ - Documentation
-       examples/ - Usage examples
-
-       src/ - source
-
-       test/ - tests
+       api/yaca/  - Public API (headers)
+       doc/       - Documentation
+       examples/  - Usage examples
+       packaging/ - RPM spec file
+       src/       - Source
 
 General design:
        - All memory allocated by API should be freed with yaca_free()
-       - Contexts and keys should be freed with yaca_ctx_free()/yaca_key_free()
-       - Function names: yaca_<operation/object>_<function>; Ex: yaca_verify_init()
-       - Simplified/Simple functions don't have <operation/object> part
-       - Enums: YACA_<concept>_<value>; Ex: YACA_KEY_256BIT
+       - Contexts and keys should be freed with yaca_context_destroy()/yaca_key_destroy()
+       - Function names: yaca_<operation/object>_<function>; Ex: yaca_verify_initialize()
+       - Simplified/Simple functions don't have <operation/object> part, but have <simple> prefix
+       - Enums: YACA_<concept>_<value>; Ex: YACA_KEY_LENGTH_256BIT
        - Objects (context, key) end with _h
-       - Most functions return 0 on success, negative values on error
+       - Functions returns YACA_ERROR_NONE on success, negative values on error
 
 Simplified API:
-       - Is located in simple.h
-       - Currently, to use it - some functions from crypto.h and key.h are needed
-       - Symmetric ciphers (except for GCM) and message digests are only operations that are supported
+       - Is located in yaca_simple.h
+       - Currently, to use it - some functions from yaca_crypto.h and yaca_key.h are needed
+       - Symmetric ciphers (except for GCM and CCM),
+          message digests and signatures are only operations that are supported
        - All operations are single-shot and output is allocated by library
 
 API:
-       1) All contexts are created by appropriate init() functions
-       2) Keys are created by generate or import functions
+       - All contexts are created by appropriate _initialize() functions
+       - Keys are created by generate or import functions
 
 Examples:
        - It is possible to compile-check examples with "make" command