1/* SPDX-License-Identifier: GPL-2.0 */
  2/*
  3 *  Shared Memory Communications over RDMA (SMC-R) and RoCE
  4 *
  5 *  Definitions for LLC (link layer control) message handling
  6 *
  7 *  Copyright IBM Corp. 2016
  8 *
  9 *  Author(s):  Klaus Wacker <Klaus.Wacker@de.ibm.com>
 10 *              Ursula Braun <ubraun@linux.vnet.ibm.com>
 11 */
 12
 13#ifndef SMC_LLC_H
 14#define SMC_LLC_H
 15
 16#include "smc_wr.h"
 17
 18#define SMC_LLC_FLAG_RESP		0x80
 19
 20#define SMC_LLC_WAIT_FIRST_TIME		(5 * HZ)
 21#define SMC_LLC_WAIT_TIME		(2 * HZ)
 22#define SMC_LLC_TESTLINK_DEFAULT_TIME	(30 * HZ)
 23
 24enum smc_llc_reqresp {
 25	SMC_LLC_REQ,
 26	SMC_LLC_RESP
 27};
 28
 29enum smc_llc_msg_type {
 30	SMC_LLC_CONFIRM_LINK		= 0x01,
 31	SMC_LLC_ADD_LINK		= 0x02,
 32	SMC_LLC_ADD_LINK_CONT		= 0x03,
 33	SMC_LLC_DELETE_LINK		= 0x04,
 34	SMC_LLC_REQ_ADD_LINK		= 0x05,
 35	SMC_LLC_CONFIRM_RKEY		= 0x06,
 36	SMC_LLC_TEST_LINK		= 0x07,
 37	SMC_LLC_CONFIRM_RKEY_CONT	= 0x08,
 38	SMC_LLC_DELETE_RKEY		= 0x09,
 39	/* V2 types */
 40	SMC_LLC_CONFIRM_LINK_V2		= 0x21,
 41	SMC_LLC_ADD_LINK_V2		= 0x22,
 42	SMC_LLC_DELETE_LINK_V2		= 0x24,
 43	SMC_LLC_REQ_ADD_LINK_V2		= 0x25,
 44	SMC_LLC_CONFIRM_RKEY_V2		= 0x26,
 45	SMC_LLC_TEST_LINK_V2		= 0x27,
 46	SMC_LLC_DELETE_RKEY_V2		= 0x29,
 47};
 48
 49#define smc_link_downing(state) \
 50	(cmpxchg(state, SMC_LNK_ACTIVE, SMC_LNK_INACTIVE) == SMC_LNK_ACTIVE)
 51
 52/* LLC DELETE LINK Request Reason Codes */
 53#define SMC_LLC_DEL_LOST_PATH		0x00010000
 54#define SMC_LLC_DEL_OP_INIT_TERM	0x00020000
 55#define SMC_LLC_DEL_PROG_INIT_TERM	0x00030000
 56#define SMC_LLC_DEL_PROT_VIOL		0x00040000
 57#define SMC_LLC_DEL_NO_ASYM_NEEDED	0x00050000
 58/* LLC DELETE LINK Response Reason Codes */
 59#define SMC_LLC_DEL_NOLNK	0x00100000  /* Unknown Link ID (no link) */
 60#define SMC_LLC_DEL_NOLGR	0x00200000  /* Unknown Link Group */
 61
 62/* returns a usable link of the link group, or NULL */
 63static inline struct smc_link *smc_llc_usable_link(struct smc_link_group *lgr)
 64{
 65	int i;
 66
 67	for (i = 0; i < SMC_LINKS_PER_LGR_MAX; i++)
 68		if (smc_link_usable(&lgr->lnk[i]))
 69			return &lgr->lnk[i];
 70	return NULL;
 71}
 72
 73/* set the termination reason code for the link group */
 74static inline void smc_llc_set_termination_rsn(struct smc_link_group *lgr,
 75					       u32 rsn)
 76{
 77	if (!lgr->llc_termination_rsn)
 78		lgr->llc_termination_rsn = rsn;
 79}
 80
 81/* transmit */
 82int smc_llc_send_confirm_link(struct smc_link *lnk,
 83			      enum smc_llc_reqresp reqresp);
 84int smc_llc_send_add_link(struct smc_link *link, u8 mac[], u8 gid[],
 85			  struct smc_link *link_new,
 86			  enum smc_llc_reqresp reqresp);
 87int smc_llc_send_delete_link(struct smc_link *link, u8 link_del_id,
 88			     enum smc_llc_reqresp reqresp, bool orderly,
 89			     u32 reason);
 90void smc_llc_srv_delete_link_local(struct smc_link *link, u8 del_link_id);
 91void smc_llc_lgr_init(struct smc_link_group *lgr, struct smc_sock *smc);
 92void smc_llc_lgr_clear(struct smc_link_group *lgr);
 93int smc_llc_link_init(struct smc_link *link);
 94void smc_llc_link_active(struct smc_link *link);
 95void smc_llc_link_clear(struct smc_link *link, bool log);
 96int smc_llc_do_confirm_rkey(struct smc_link *send_link,
 97			    struct smc_buf_desc *rmb_desc);
 98int smc_llc_do_delete_rkey(struct smc_link_group *lgr,
 99			   struct smc_buf_desc *rmb_desc);
100int smc_llc_flow_initiate(struct smc_link_group *lgr,
101			  enum smc_llc_flowtype type);
102void smc_llc_flow_stop(struct smc_link_group *lgr, struct smc_llc_flow *flow);
103int smc_llc_eval_conf_link(struct smc_llc_qentry *qentry,
104			   enum smc_llc_reqresp type);
105void smc_llc_link_set_uid(struct smc_link *link);
106void smc_llc_save_peer_uid(struct smc_llc_qentry *qentry);
107struct smc_llc_qentry *smc_llc_wait(struct smc_link_group *lgr,
108				    struct smc_link *lnk,
109				    int time_out, u8 exp_msg);
110struct smc_llc_qentry *smc_llc_flow_qentry_clr(struct smc_llc_flow *flow);
111void smc_llc_flow_qentry_del(struct smc_llc_flow *flow);
112void smc_llc_send_link_delete_all(struct smc_link_group *lgr, bool ord,
113				  u32 rsn);
114int smc_llc_cli_add_link(struct smc_link *link, struct smc_llc_qentry *qentry);
115int smc_llc_srv_add_link(struct smc_link *link,
116			 struct smc_llc_qentry *req_qentry);
117void smc_llc_add_link_local(struct smc_link *link);
118int smc_llc_init(void) __init;
119
120#endif /* SMC_LLC_H */