1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
# Open CAS Framework
[](https://open-cas-logs.s3.us-east-2.amazonaws.com/master-status/build/build.html)
[](https://open-cas-logs.s3.us-east-2.amazonaws.com/master-status/tests/index.html)
[](https://scan.coverity.com/projects/open-cas-ocf)
[](https://codecov.io/gh/Open-CAS/ocf)
[](LICENSE)
Open CAS Framework (OCF) is high performance block storage caching meta-library
written in C. It's entirely platform and system independent, accessing system API
through user provided environment wrappers layer. OCF tightly integrates with the
rest of software stack, providing flawless, high performance, low latency caching
utility.
# In this readme:
* [Documentation](#documentation)
* [Source Code](#source-code)
* [Deployment](#deployment)
* [Examples](#examples)
* [Unit Tests](#unit-tests)
* [Build Test](#build-test)
* [Functional Tests](#functional-tests)
* [Contributing](#contributing)
* [Security](#security)
## Documentation
OCF documentation is available on [GitHub Pages](https://open-cas.github.io/getting_started_ocf.html).
Doxygen API documentation is available [here](http://open-cas.github.io/doxygen/ocf).
## Source Code
Source code is available in the official OCF GitHub repository:
~~~{.sh}
git clone https://github.com/Open-CAS/ocf.git
cd ocf
~~~
## Deployment
OCF doesn't compile as separate library. It's designed to be included into another
software stack. For this purpose OCF provides Makefile with two useful targets for
deploying its source into target directories. Assuming OCFDIR is OCF directory, and
SRCDIR and INCDIR are respectively your source and include directories, use following
commands to deploy OCF into your project:
~~~{.sh}
make -C $OCFDIF src O=$SRCDIR
make -C $OCFDIF inc O=$INCDIR
~~~
By default this will not copy OCF source files but create symbolic links to them,
to avoid source duplication and allow for easy OCF code modification. If you prefer
to copy OCF source files (e.g. you don't want to distribute whole OCF repository
as your submodule) you can use following commands:
~~~{.sh}
make -C $OCFDIF src O=$SRCDIR CMD=cp
make -C $OCFDIF inc O=$INCDIR CMD=cp
~~~
## Examples
OCF is shipped with examples, which are complete, compillable and working
programs, containing lot of comments that explain basics of caching. They
are great starting point for everyone who wants to start working with OCF.
Examples can be found in directory `example/`.
Each example contains Makefile which can be used to compile it.
## Unit Tests
OCF is shipped with dedicated unit test framework based on Cmocka.
To run unit tests you need to install following packages:
- Cmake (>= 3.8.1)
- Cmocka (>= 1.1.1)
- ctags (>= 5.8)
To run unit tests use following command:
~~~{.sh}
./tests/unit/framework/run_unit_tests.py
~~~
## Build Test
OCF repository contains basic build test. It uses default POSIX environment.
To run this test, use following commands:
~~~{.sh}
cd tests/build/
make
~~~
## Functional Tests
OCF repository contains dedicated functional test framework written in python and executed via pytest. With the use of ctypes it is possible to call, wrap ocf functions and use C compatible data types.
To run functional tests you need to install the following:
- python3 (>=3.6.7)
- pytest (Install with `pip3 install pytest`)
To run all functional tests (in compliance with the configuration file) compile using makefile located in `./tests/functional/Makefile` and then use the following command:
~~~{.sh}
pytest
~~~
## Contributing
Feel like making OCF better? Don't hesitate to submit a pull request!
You can find more information about our contribution process
[here](https://open-cas.github.io/contributing.html).
In case of any questions feel free to contact [maintainer](mailto:robert.baldyga@intel.com).
## Security
To report a potential security vulnerability please follow the instructions
[here](https://open-cas.github.io/contributing.html#reporting-a-potential-security-vulnerability)
|
