cijoe-pkg-liblightnvm 0.0.13

CIJOE: liblightnvm package

cijoe-pkg-liblightnvm: cijoe testcases and testplans for liblightnvm

Install

The package is distributed via PyPi, run the following to command to install:

Install cijoe-pkg-liblightnvm system-wide via the pip:

sudo pip install cijoe-pkg-liblightnvm

Or install it user-level:

pip install --user cijoe-pkg-liblightnvm

Note

When doing user-level install, then include the pip binary install path in your PATH definition. For example PATH="$PATH:$HOME/.local/bin"

Create environment definition for CIJOE

Run CIJOE interactively and define the target environment:

# Start cijoe
cijoe

# Use refence definitions as a template for defining your environment
cat $CIJ_ENVS/refenv-u1604.sh > target_env.sh
tail -n +2 $CIJ_ENVS/refenv-liblightnvm.sh >> target_env.sh

# Open up your favorite editor and modify accordingly
vim target_env.sh

Create virtual environment definition for CIJOE

Run CIJOE interactively and define the target environment:

# Start cijoe
cijoe

# Use refence definitions as a template for defining your environment
cat $CIJ_ENVS/refenv-u1604.sh > target_env.sh

# The following is the qemu variables to define
tail -n +2 $CIJ_ENVS/qemu.sh >> target_env.sh

# Lastly, the variables used by liblightnvm testcases
tail -n +2 $CIJ_ENVS/refenv-liblightnvm.sh >> target_env.sh

# Open up your favorite editor and modify accordingly
vim target_env.sh

Running tests

Start the test-runner and view the report:

# Create directory to store results
RESULTS=$(mktemp -d trun.XXXXXX -p /tmp)

# Run using the testplan for Open-Channel 2.0 devices
cij_runner \
    $CIJ_TESTPLANS/OCSSD_S20_IOCTL.plan \
    target_env.sh \
    --output $RESULTS

# Create test report
cij_reporter $RESULTS

# Inspect the test-report
xdg-open $RESULTS/report.html

If you find bugs or need help then feel free to submit an Issue. If you want to get involved head over to the GitHub page to get the source code and submit a Pull request with your changes.