use the nvmf lib to add an nvmf example which doesn't use the spdk app framework. It can show how to use the nvmf lib to build your own nvmf target. We encouage you to use the RPC cmds so this example will not supply the configuration file. You can read the README.md to get the steps how to build your nvmf target and test the IO status. Change-Id: I8d175934f7364d40fb44d36e85c31d8ea5063654 Signed-off-by: JinYu <jin.yu@intel.com> Reviewed-on: https://review.gerrithub.io/c/spdk/spdk/+/468457 Community-CI: Broadcom SPDK FC-NVMe CI <spdk-ci.pdl@broadcom.com> Tested-by: SPDK CI Jenkins <sys_sgci@intel.com> Reviewed-by: Ben Walker <benjamin.walker@intel.com> Reviewed-by: Changpeng Liu <changpeng.liu@intel.com> Reviewed-by: GangCao <gang.cao@intel.com>
31 lines
1.6 KiB
Markdown
31 lines
1.6 KiB
Markdown
NVMe-oF target without SPDK event framework
|
|
============================================================================================================
|
|
|
|
# Overview
|
|
This example is used to show how to use the nvmf lib. In this example we want to encourage user
|
|
to use RPC cmd so we would only support RPC style.
|
|
|
|
# Usage:
|
|
This example's usage is very similar with nvmf_tgt, difference is that you must use the RPC cmd
|
|
to setup the nvmf target.
|
|
|
|
First, start this example app. You can use the -m to specify how many cores you want to use.
|
|
The other parameters you can use -h to show.
|
|
./nvmf -m 0xf -r /var/tmp/spdk.sock
|
|
|
|
Then, you need to use the RPC cmd to config the nvmf target. You can use the -h to get how many
|
|
RPC cmd you can use. As this example is about nvmf so I think you can focus on the nvmf cmds and
|
|
the bdev cmds.
|
|
./scripts/rpc.py -h
|
|
|
|
Next, You should use the RPC cmd to setup nvmf target.
|
|
./scripts/rpc.py nvmf_create_transport -t RDMA -g nvmf_example
|
|
./scripts/rpc.py nvmf_create_subsystem -t nvmf_example -s SPDK00000000000001 -a -m 32 nqn.2016-06.io.spdk:cnode1
|
|
./scripts/rpc.py bdev_malloc_create -b Malloc1 128 512
|
|
./scripts/rpc.py nvmf_subsystem_add_ns -t nvmf_example nqn.2016-06.io.spdk:cnode1 Malloc1
|
|
./scripts/rpc.py nvmf_subsystem_add_listener -t rdma -f Ipv4 -a 192.168.0.10 -s 4420 -p nvmf_example nqn.2016-06.io.spdk:cnode1
|
|
|
|
Last, start the initiator to connect the nvmf example target and test the IOs
|
|
$ROOT_SPDK/example/nvme/perf/perf -q 64 -o 4095 -w randrw -M 30 -l -t 60 \
|
|
-r "trtype:RDMA adrfam:IPv4 traddr:192.168.0.10 trsvcid:4420 subnqn:nqn.2016-06.io.spdk:cnode1"
|