Add VMBus protocol version 4.0. and 5.0 to support Windows 10 and newer HyperV hosts. For VMBus 4.0 and newer HyperV, the netvsc gpadl teardown must be done after vmbus close. Submitted by: whu MFC after: 2 weeks Sponsored by: Microsoft
235 lines
7.7 KiB
C
235 lines
7.7 KiB
C
/*-
|
|
* Copyright (c) 2016 Microsoft Corp.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice unmodified, this list of conditions, and the following
|
|
* disclaimer.
|
|
* 2. 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.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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.
|
|
*
|
|
* $FreeBSD$
|
|
*/
|
|
|
|
#ifndef _VMBUS_H_
|
|
#define _VMBUS_H_
|
|
|
|
#include <sys/param.h>
|
|
#include <sys/bus.h>
|
|
|
|
/*
|
|
* VMBUS version is 32 bit, upper 16 bit for major_number and lower
|
|
* 16 bit for minor_number.
|
|
*
|
|
* 0.13 -- Windows Server 2008
|
|
* 1.1 -- Windows 7
|
|
* 2.4 -- Windows 8
|
|
* 3.0 -- Windows 8.1
|
|
* 4.0 -- Windows 10
|
|
* 5.0 -- Newer Windows 10
|
|
*/
|
|
#define VMBUS_VERSION_WS2008 ((0 << 16) | (13))
|
|
#define VMBUS_VERSION_WIN7 ((1 << 16) | (1))
|
|
#define VMBUS_VERSION_WIN8 ((2 << 16) | (4))
|
|
#define VMBUS_VERSION_WIN8_1 ((3 << 16) | (0))
|
|
#define VMBUS_VERSION_WIN10 ((4 << 16) | (0))
|
|
#define VMBUS_VERSION_WIN10_V5 ((5 << 16) | (0))
|
|
|
|
#define VMBUS_VERSION_MAJOR(ver) (((uint32_t)(ver)) >> 16)
|
|
#define VMBUS_VERSION_MINOR(ver) (((uint32_t)(ver)) & 0xffff)
|
|
|
|
#define VMBUS_CHAN_POLLHZ_MIN 100 /* 10ms interval */
|
|
#define VMBUS_CHAN_POLLHZ_MAX 1000000 /* 1us interval */
|
|
|
|
/*
|
|
* GPA stuffs.
|
|
*/
|
|
struct vmbus_gpa_range {
|
|
uint32_t gpa_len;
|
|
uint32_t gpa_ofs;
|
|
uint64_t gpa_page[0];
|
|
} __packed;
|
|
|
|
/* This is actually vmbus_gpa_range.gpa_page[1] */
|
|
struct vmbus_gpa {
|
|
uint32_t gpa_len;
|
|
uint32_t gpa_ofs;
|
|
uint64_t gpa_page;
|
|
} __packed;
|
|
|
|
#define VMBUS_CHANPKT_SIZE_SHIFT 3
|
|
|
|
#define VMBUS_CHANPKT_GETLEN(pktlen) \
|
|
(((int)(pktlen)) << VMBUS_CHANPKT_SIZE_SHIFT)
|
|
|
|
struct vmbus_chanpkt_hdr {
|
|
uint16_t cph_type; /* VMBUS_CHANPKT_TYPE_ */
|
|
uint16_t cph_hlen; /* header len, in 8 bytes */
|
|
uint16_t cph_tlen; /* total len, in 8 bytes */
|
|
uint16_t cph_flags; /* VMBUS_CHANPKT_FLAG_ */
|
|
uint64_t cph_xactid;
|
|
} __packed;
|
|
|
|
#define VMBUS_CHANPKT_TYPE_INBAND 0x0006
|
|
#define VMBUS_CHANPKT_TYPE_RXBUF 0x0007
|
|
#define VMBUS_CHANPKT_TYPE_GPA 0x0009
|
|
#define VMBUS_CHANPKT_TYPE_COMP 0x000b
|
|
|
|
#define VMBUS_CHANPKT_FLAG_NONE 0
|
|
#define VMBUS_CHANPKT_FLAG_RC 0x0001 /* report completion */
|
|
|
|
#define VMBUS_CHANPKT_CONST_DATA(pkt) \
|
|
(const void *)((const uint8_t *)(pkt) + \
|
|
VMBUS_CHANPKT_GETLEN((pkt)->cph_hlen))
|
|
|
|
/* Include padding */
|
|
#define VMBUS_CHANPKT_DATALEN(pkt) \
|
|
(VMBUS_CHANPKT_GETLEN((pkt)->cph_tlen) -\
|
|
VMBUS_CHANPKT_GETLEN((pkt)->cph_hlen))
|
|
|
|
struct vmbus_rxbuf_desc {
|
|
uint32_t rb_len;
|
|
uint32_t rb_ofs;
|
|
} __packed;
|
|
|
|
struct vmbus_chanpkt_rxbuf {
|
|
struct vmbus_chanpkt_hdr cp_hdr;
|
|
uint16_t cp_rxbuf_id;
|
|
uint16_t cp_rsvd;
|
|
uint32_t cp_rxbuf_cnt;
|
|
struct vmbus_rxbuf_desc cp_rxbuf[];
|
|
} __packed;
|
|
|
|
struct vmbus_chan_br {
|
|
void *cbr;
|
|
bus_addr_t cbr_paddr;
|
|
int cbr_txsz;
|
|
int cbr_rxsz;
|
|
};
|
|
|
|
struct vmbus_channel;
|
|
struct vmbus_xact;
|
|
struct vmbus_xact_ctx;
|
|
struct hyperv_guid;
|
|
struct task;
|
|
struct taskqueue;
|
|
|
|
typedef void (*vmbus_chan_callback_t)(struct vmbus_channel *, void *);
|
|
|
|
static __inline struct vmbus_channel *
|
|
vmbus_get_channel(device_t dev)
|
|
{
|
|
return device_get_ivars(dev);
|
|
}
|
|
|
|
/*
|
|
* vmbus_chan_open_br()
|
|
*
|
|
* Return values:
|
|
* 0 Succeeded.
|
|
* EISCONN Failed, and the memory passed through 'br' is still
|
|
* connected. Callers must _not_ free the the memory
|
|
* passed through 'br', if this error happens.
|
|
* other values Failed. The memory passed through 'br' is no longer
|
|
* connected. Callers are free to do anything with the
|
|
* memory passed through 'br'.
|
|
*
|
|
*
|
|
*
|
|
* vmbus_chan_close_direct()
|
|
*
|
|
* NOTE:
|
|
* Callers of this function _must_ make sure to close all sub-channels before
|
|
* closing the primary channel.
|
|
*
|
|
* Return values:
|
|
* 0 Succeeded.
|
|
* EISCONN Failed, and the memory associated with the bufring
|
|
* is still connected. Callers must _not_ free the the
|
|
* memory associated with the bufring, if this error
|
|
* happens.
|
|
* other values Failed. The memory associated with the bufring is
|
|
* no longer connected. Callers are free to do anything
|
|
* with the memory associated with the bufring.
|
|
*/
|
|
int vmbus_chan_open(struct vmbus_channel *chan,
|
|
int txbr_size, int rxbr_size, const void *udata, int udlen,
|
|
vmbus_chan_callback_t cb, void *cbarg);
|
|
int vmbus_chan_open_br(struct vmbus_channel *chan,
|
|
const struct vmbus_chan_br *cbr, const void *udata,
|
|
int udlen, vmbus_chan_callback_t cb, void *cbarg);
|
|
void vmbus_chan_close(struct vmbus_channel *chan);
|
|
int vmbus_chan_close_direct(struct vmbus_channel *chan);
|
|
void vmbus_chan_intr_drain(struct vmbus_channel *chan);
|
|
void vmbus_chan_run_task(struct vmbus_channel *chan,
|
|
struct task *task);
|
|
void vmbus_chan_set_orphan(struct vmbus_channel *chan,
|
|
struct vmbus_xact_ctx *);
|
|
void vmbus_chan_unset_orphan(struct vmbus_channel *chan);
|
|
const void *vmbus_chan_xact_wait(const struct vmbus_channel *chan,
|
|
struct vmbus_xact *xact, size_t *resp_len, bool can_sleep);
|
|
|
|
int vmbus_chan_gpadl_connect(struct vmbus_channel *chan,
|
|
bus_addr_t paddr, int size, uint32_t *gpadl);
|
|
int vmbus_chan_gpadl_disconnect(struct vmbus_channel *chan,
|
|
uint32_t gpadl);
|
|
|
|
void vmbus_chan_cpu_set(struct vmbus_channel *chan, int cpu);
|
|
void vmbus_chan_cpu_rr(struct vmbus_channel *chan);
|
|
void vmbus_chan_set_readbatch(struct vmbus_channel *chan, bool on);
|
|
|
|
struct vmbus_channel **
|
|
vmbus_subchan_get(struct vmbus_channel *pri_chan,
|
|
int subchan_cnt);
|
|
void vmbus_subchan_rel(struct vmbus_channel **subchan,
|
|
int subchan_cnt);
|
|
void vmbus_subchan_drain(struct vmbus_channel *pri_chan);
|
|
|
|
int vmbus_chan_recv(struct vmbus_channel *chan, void *data, int *dlen,
|
|
uint64_t *xactid);
|
|
int vmbus_chan_recv_pkt(struct vmbus_channel *chan,
|
|
struct vmbus_chanpkt_hdr *pkt, int *pktlen);
|
|
|
|
int vmbus_chan_send(struct vmbus_channel *chan, uint16_t type,
|
|
uint16_t flags, void *data, int dlen, uint64_t xactid);
|
|
int vmbus_chan_send_sglist(struct vmbus_channel *chan,
|
|
struct vmbus_gpa sg[], int sglen, void *data, int dlen,
|
|
uint64_t xactid);
|
|
int vmbus_chan_send_prplist(struct vmbus_channel *chan,
|
|
struct vmbus_gpa_range *prp, int prp_cnt, void *data,
|
|
int dlen, uint64_t xactid);
|
|
|
|
uint32_t vmbus_chan_id(const struct vmbus_channel *chan);
|
|
uint32_t vmbus_chan_subidx(const struct vmbus_channel *chan);
|
|
bool vmbus_chan_is_primary(const struct vmbus_channel *chan);
|
|
bool vmbus_chan_is_revoked(const struct vmbus_channel *chan);
|
|
const struct hyperv_guid *
|
|
vmbus_chan_guid_inst(const struct vmbus_channel *chan);
|
|
int vmbus_chan_prplist_nelem(int br_size, int prpcnt_max,
|
|
int dlen_max);
|
|
bool vmbus_chan_rx_empty(const struct vmbus_channel *chan);
|
|
bool vmbus_chan_tx_empty(const struct vmbus_channel *chan);
|
|
struct taskqueue *
|
|
vmbus_chan_mgmt_tq(const struct vmbus_channel *chan);
|
|
|
|
void vmbus_chan_poll_enable(struct vmbus_channel *chan,
|
|
u_int pollhz);
|
|
void vmbus_chan_poll_disable(struct vmbus_channel *chan);
|
|
|
|
#endif /* !_VMBUS_H_ */
|