4c6e4d4963
The NVMe over Fabrics target library now exposes a simple function call that polls the acceptor once, and the application handles registration of the poller. Also rename the transport function pointers related to the acceptor so they better reflect their purpose. Change-Id: I5fa0d516586bf17e73afeb88ff3c2d5b0d46794d Signed-off-by: Daniel Verkamp <daniel.verkamp@intel.com>
130 lines
3.8 KiB
C
130 lines
3.8 KiB
C
/*-
|
|
* BSD LICENSE
|
|
*
|
|
* Copyright (c) Intel Corporation.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* * Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* * Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
* * Neither the name of Intel Corporation nor the names of its
|
|
* contributors may be used to endorse or promote products derived
|
|
* from this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef SPDK_NVMF_TRANSPORT_H
|
|
#define SPDK_NVMF_TRANSPORT_H
|
|
|
|
#include <stdint.h>
|
|
|
|
struct nvmf_session;
|
|
struct spdk_nvmf_conn;
|
|
struct spdk_nvmf_request;
|
|
struct spdk_nvmf_discovery_log_page_entry;
|
|
struct spdk_nvmf_listen_addr;
|
|
struct spdk_nvmf_request;
|
|
|
|
struct spdk_nvmf_transport {
|
|
/**
|
|
* Name of the transport.
|
|
*/
|
|
const char *name;
|
|
|
|
/**
|
|
* Initialize the transport.
|
|
*/
|
|
int (*transport_init)(uint16_t max_queue_depth, uint32_t max_io_size,
|
|
uint32_t in_capsule_data_size);
|
|
|
|
/**
|
|
* Shut down the transport.
|
|
*/
|
|
int (*transport_fini)(void);
|
|
|
|
/**
|
|
* Start accepting connections on the transport.
|
|
*/
|
|
int (*acceptor_init)(void);
|
|
|
|
/**
|
|
* Check for new connections on the transport.
|
|
*/
|
|
void (*acceptor_poll)(void);
|
|
|
|
/**
|
|
* Stop accepting connections on the transport.
|
|
*/
|
|
void (*acceptor_fini)(void);
|
|
|
|
/**
|
|
* Initialize the transport for the given session
|
|
*/
|
|
int (*session_init)(struct nvmf_session *session, struct spdk_nvmf_conn *conn);
|
|
|
|
/**
|
|
* Deinitiallize the transport for the given session
|
|
*/
|
|
void (*session_fini)(struct nvmf_session *session);
|
|
|
|
/*
|
|
* Signal request completion, which sends a response
|
|
* to the originator. A request can either
|
|
* be completed or released, but not both.
|
|
*/
|
|
int (*req_complete)(struct spdk_nvmf_request *req);
|
|
|
|
/*
|
|
* Signal that the request can be released without sending
|
|
* a response. A request can either be completed or release,
|
|
* but not both.
|
|
*/
|
|
int (*req_release)(struct spdk_nvmf_request *req);
|
|
|
|
/*
|
|
* Deinitialize a connection.
|
|
*/
|
|
void (*conn_fini)(struct spdk_nvmf_conn *conn);
|
|
|
|
/*
|
|
* Poll a connection for events.
|
|
*/
|
|
int (*conn_poll)(struct spdk_nvmf_conn *conn);
|
|
|
|
/**
|
|
* Fill out a discovery log entry for a specific listen address.
|
|
*/
|
|
void (*listen_addr_discover)(struct spdk_nvmf_listen_addr *listen_addr,
|
|
struct spdk_nvmf_discovery_log_page_entry *entry);
|
|
};
|
|
|
|
int spdk_nvmf_transport_init(void);
|
|
int spdk_nvmf_transport_fini(void);
|
|
const struct spdk_nvmf_transport *spdk_nvmf_transport_get(const char *name);
|
|
|
|
int spdk_nvmf_acceptor_init(void);
|
|
void spdk_nvmf_acceptor_poll(void);
|
|
void spdk_nvmf_acceptor_fini(void);
|
|
|
|
extern const struct spdk_nvmf_transport spdk_nvmf_transport_rdma;
|
|
|
|
#endif /* SPDK_NVMF_TRANSPORT_H */
|