drivers/staging/rdma/hfi1/verbs.h

   1 /*
   2  *
   3  * This file is provided under a dual BSD/GPLv2 license.  When using or
   4  * redistributing this file, you may do so under either license.
   5  *
   6  * GPL LICENSE SUMMARY
   7  *
   8  * Copyright(c) 2015 Intel Corporation.
   9  *
  10  * This program is free software; you can redistribute it and/or modify
  11  * it under the terms of version 2 of the GNU General Public License as
  12  * published by the Free Software Foundation.
  13  *
  14  * This program is distributed in the hope that it will be useful, but
  15  * WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17  * General Public License for more details.
  18  *
  19  * BSD LICENSE
  20  *
  21  * Copyright(c) 2015 Intel Corporation.
  22  *
  23  * Redistribution and use in source and binary forms, with or without
  24  * modification, are permitted provided that the following conditions
  25  * are met:
  26  *
  27  *  - Redistributions of source code must retain the above copyright
  28  *    notice, this list of conditions and the following disclaimer.
  29  *  - Redistributions in binary form must reproduce the above copyright
  30  *    notice, this list of conditions and the following disclaimer in
  31  *    the documentation and/or other materials provided with the
  32  *    distribution.
  33  *  - Neither the name of Intel Corporation nor the names of its
  34  *    contributors may be used to endorse or promote products derived
  35  *    from this software without specific prior written permission.
  36  *
  37  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  38  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  39  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  40  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  41  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  42  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  43  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  44  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  45  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  46  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  47  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  48  *
  49  */
  50
  51 #ifndef HFI1_VERBS_H
  52 #define HFI1_VERBS_H
  53
  54 #include <linux/types.h>
  55 #include <linux/seqlock.h>
  56 #include <linux/kernel.h>
  57 #include <linux/interrupt.h>
  58 #include <linux/kref.h>
  59 #include <linux/workqueue.h>
  60 #include <linux/kthread.h>
  61 #include <linux/completion.h>
  62 #include <rdma/ib_pack.h>
  63 #include <rdma/ib_user_verbs.h>
  64 #include <rdma/ib_mad.h>
  65 #include <rdma/rdma_vt.h>
  66 #include <rdma/rdmavt_qp.h>
  67 #include <rdma/rdmavt_cq.h>
  68
  69 struct hfi1_ctxtdata;
  70 struct hfi1_pportdata;
  71 struct hfi1_devdata;
  72 struct hfi1_packet;
  73
  74 #include "iowait.h"
  75
  76 #define HFI1_MAX_RDMA_ATOMIC     16
  77 #define HFI1_GUIDS_PER_PORT     5
  78
  79 /*
  80  * Increment this value if any changes that break userspace ABI
  81  * compatibility are made.
  82  */
  83 #define HFI1_UVERBS_ABI_VERSION       2
  84
  85 #define IB_SEQ_NAK      (3 << 29)
  86
  87 /* AETH NAK opcode values */
  88 #define IB_RNR_NAK                      0x20
  89 #define IB_NAK_PSN_ERROR                0x60
  90 #define IB_NAK_INVALID_REQUEST          0x61
  91 #define IB_NAK_REMOTE_ACCESS_ERROR      0x62
  92 #define IB_NAK_REMOTE_OPERATIONAL_ERROR 0x63
  93 #define IB_NAK_INVALID_RD_REQUEST       0x64
  94
  95 /* IB Performance Manager status values */
  96 #define IB_PMA_SAMPLE_STATUS_DONE       0x00
  97 #define IB_PMA_SAMPLE_STATUS_STARTED    0x01
  98 #define IB_PMA_SAMPLE_STATUS_RUNNING    0x02
  99
 100 /* Mandatory IB performance counter select values. */
 101 #define IB_PMA_PORT_XMIT_DATA   cpu_to_be16(0x0001)
 102 #define IB_PMA_PORT_RCV_DATA    cpu_to_be16(0x0002)
 103 #define IB_PMA_PORT_XMIT_PKTS   cpu_to_be16(0x0003)
 104 #define IB_PMA_PORT_RCV_PKTS    cpu_to_be16(0x0004)
 105 #define IB_PMA_PORT_XMIT_WAIT   cpu_to_be16(0x0005)
 106
 107 #define HFI1_VENDOR_IPG         cpu_to_be16(0xFFA0)
 108
 109 #define IB_BTH_REQ_ACK          BIT(31)
 110 #define IB_BTH_SOLICITED        BIT(23)
 111 #define IB_BTH_MIG_REQ          BIT(22)
 112
 113 #define IB_GRH_VERSION          6
 114 #define IB_GRH_VERSION_MASK     0xF
 115 #define IB_GRH_VERSION_SHIFT    28
 116 #define IB_GRH_TCLASS_MASK      0xFF
 117 #define IB_GRH_TCLASS_SHIFT     20
 118 #define IB_GRH_FLOW_MASK        0xFFFFF
 119 #define IB_GRH_FLOW_SHIFT       0
 120 #define IB_GRH_NEXT_HDR         0x1B
 121
 122 #define IB_DEFAULT_GID_PREFIX   cpu_to_be64(0xfe80000000000000ULL)
 123
 124 /* flags passed by hfi1_ib_rcv() */
 125 enum {
 126         HFI1_HAS_GRH = (1 << 0),
 127 };
 128
 129 struct ib_reth {
 130         __be64 vaddr;
 131         __be32 rkey;
 132         __be32 length;
 133 } __packed;
 134
 135 struct ib_atomic_eth {
 136         __be32 vaddr[2];        /* unaligned so access as 2 32-bit words */
 137         __be32 rkey;
 138         __be64 swap_data;
 139         __be64 compare_data;
 140 } __packed;
 141
 142 union ib_ehdrs {
 143         struct {
 144                 __be32 deth[2];
 145                 __be32 imm_data;
 146         } ud;
 147         struct {
 148                 struct ib_reth reth;
 149                 __be32 imm_data;
 150         } rc;
 151         struct {
 152                 __be32 aeth;
 153                 __be32 atomic_ack_eth[2];
 154         } at;
 155         __be32 imm_data;
 156         __be32 aeth;
 157         struct ib_atomic_eth atomic_eth;
 158 }  __packed;
 159
 160 struct hfi1_other_headers {
 161         __be32 bth[3];
 162         union ib_ehdrs u;
 163 } __packed;
 164
 165 /*
 166  * Note that UD packets with a GRH header are 8+40+12+8 = 68 bytes
 167  * long (72 w/ imm_data).  Only the first 56 bytes of the IB header
 168  * will be in the eager header buffer.  The remaining 12 or 16 bytes
 169  * are in the data buffer.
 170  */
 171 struct hfi1_ib_header {
 172         __be16 lrh[4];
 173         union {
 174                 struct {
 175                         struct ib_grh grh;
 176                         struct hfi1_other_headers oth;
 177                 } l;
 178                 struct hfi1_other_headers oth;
 179         } u;
 180 } __packed;
 181
 182 struct ahg_ib_header {
 183         struct sdma_engine *sde;
 184         u32 ahgdesc[2];
 185         u16 tx_flags;
 186         u8 ahgcount;
 187         u8 ahgidx;
 188         struct hfi1_ib_header ibh;
 189 };
 190
 191 struct hfi1_pio_header {
 192         __le64 pbc;
 193         struct hfi1_ib_header hdr;
 194 } __packed;
 195
 196 /*
 197  * used for force cacheline alignment for AHG
 198  */
 199 struct tx_pio_header {
 200         struct hfi1_pio_header phdr;
 201 } ____cacheline_aligned;
 202
 203 /*
 204  * hfi1 specific data structures that will be hidden from rvt after the queue
 205  * pair is made common
 206  */
 207 struct hfi1_qp_priv {
 208         struct ahg_ib_header *s_hdr; /* next packet header to send */
 209         struct sdma_engine *s_sde;   /* current sde */
 210         u8 s_sc;                     /* SC[0..4] for next packet */
 211         u8 r_adefered;               /* number of acks defered */
 212         struct iowait s_iowait;
 213         struct rvt_qp *owner;
 214 };
 215
 216 /*
 217  * This structure is used to hold commonly lookedup and computed values during
 218  * the send engine progress.
 219  */
 220 struct hfi1_pkt_state {
 221         struct hfi1_ibdev *dev;
 222         struct hfi1_ibport *ibp;
 223         struct hfi1_pportdata *ppd;
 224 };
 225
 226 #define HFI1_PSN_CREDIT  16
 227
 228 struct hfi1_opcode_stats {
 229         u64 n_packets;          /* number of packets */
 230         u64 n_bytes;            /* total number of bytes */
 231 };
 232
 233 struct hfi1_opcode_stats_perctx {
 234         struct hfi1_opcode_stats stats[256];
 235 };
 236
 237 static inline void inc_opstats(
 238         u32 tlen,
 239         struct hfi1_opcode_stats *stats)
 240 {
 241 #ifdef CONFIG_DEBUG_FS
 242         stats->n_bytes += tlen;
 243         stats->n_packets++;
 244 #endif
 245 }
 246
 247 struct hfi1_ibport {
 248         struct rvt_qp __rcu *qp[2];
 249         struct rvt_ibport rvp;
 250
 251         __be64 guids[HFI1_GUIDS_PER_PORT        - 1];   /* writable GUIDs */
 252
 253         /* the first 16 entries are sl_to_vl for !OPA */
 254         u8 sl_to_sc[32];
 255         u8 sc_to_sl[32];
 256 };
 257
 258 struct hfi1_ibdev {
 259         struct rvt_dev_info rdi; /* Must be first */
 260
 261         /* QP numbers are shared by all IB ports */
 262         /* protect wait lists */
 263         seqlock_t iowait_lock;
 264         struct list_head txwait;        /* list for wait verbs_txreq */
 265         struct list_head memwait;       /* list for wait kernel memory */
 266         struct list_head txreq_free;
 267         struct kmem_cache *verbs_txreq_cache;
 268         struct timer_list mem_timer;
 269
 270         u64 n_piowait;
 271         u64 n_txwait;
 272         u64 n_kmem_wait;
 273
 274 #ifdef CONFIG_DEBUG_FS
 275         /* per HFI debugfs */
 276         struct dentry *hfi1_ibdev_dbg;
 277         /* per HFI symlinks to above */
 278         struct dentry *hfi1_ibdev_link;
 279 #endif
 280 };
 281
 282 struct hfi1_verbs_counters {
 283         u64 symbol_error_counter;
 284         u64 link_error_recovery_counter;
 285         u64 link_downed_counter;
 286         u64 port_rcv_errors;
 287         u64 port_rcv_remphys_errors;
 288         u64 port_xmit_discards;
 289         u64 port_xmit_data;
 290         u64 port_rcv_data;
 291         u64 port_xmit_packets;
 292         u64 port_rcv_packets;
 293         u32 local_link_integrity_errors;
 294         u32 excessive_buffer_overrun_errors;
 295         u32 vl15_dropped;
 296 };
 297
 298 static inline struct hfi1_ibdev *to_idev(struct ib_device *ibdev)
 299 {
 300         struct rvt_dev_info *rdi;
 301
 302         rdi = container_of(ibdev, struct rvt_dev_info, ibdev);
 303         return container_of(rdi, struct hfi1_ibdev, rdi);
 304 }
 305
 306 static inline struct rvt_qp *iowait_to_qp(struct  iowait *s_iowait)
 307 {
 308         struct hfi1_qp_priv *priv;
 309
 310         priv = container_of(s_iowait, struct hfi1_qp_priv, s_iowait);
 311         return priv->owner;
 312 }
 313
 314 /*
 315  * Send if not busy or waiting for I/O and either
 316  * a RC response is pending or we can process send work requests.
 317  */
 318 static inline int hfi1_send_ok(struct rvt_qp *qp)
 319 {
 320         return !(qp->s_flags & (RVT_S_BUSY | RVT_S_ANY_WAIT_IO)) &&
 321                 (qp->s_hdrwords || (qp->s_flags & RVT_S_RESP_PENDING) ||
 322                  !(qp->s_flags & RVT_S_ANY_WAIT_SEND));
 323 }
 324
 325 /*
 326  * This must be called with s_lock held.
 327  */
 328 void hfi1_bad_pqkey(struct hfi1_ibport *ibp, __be16 trap_num, u32 key, u32 sl,
 329                     u32 qp1, u32 qp2, u16 lid1, u16 lid2);
 330 void hfi1_cap_mask_chg(struct rvt_dev_info *rdi, u8 port_num);
 331 void hfi1_sys_guid_chg(struct hfi1_ibport *ibp);
 332 void hfi1_node_desc_chg(struct hfi1_ibport *ibp);
 333 int hfi1_process_mad(struct ib_device *ibdev, int mad_flags, u8 port,
 334                      const struct ib_wc *in_wc, const struct ib_grh *in_grh,
 335                      const struct ib_mad_hdr *in_mad, size_t in_mad_size,
 336                      struct ib_mad_hdr *out_mad, size_t *out_mad_size,
 337                      u16 *out_mad_pkey_index);
 338
 339 /*
 340  * The PSN_MASK and PSN_SHIFT allow for
 341  * 1) comparing two PSNs
 342  * 2) returning the PSN with any upper bits masked
 343  * 3) returning the difference between to PSNs
 344  *
 345  * The number of significant bits in the PSN must
 346  * necessarily be at least one bit less than
 347  * the container holding the PSN.
 348  */
 349 #ifndef CONFIG_HFI1_VERBS_31BIT_PSN
 350 #define PSN_MASK 0xFFFFFF
 351 #define PSN_SHIFT 8
 352 #else
 353 #define PSN_MASK 0x7FFFFFFF
 354 #define PSN_SHIFT 1
 355 #endif
 356 #define PSN_MODIFY_MASK 0xFFFFFF
 357
 358 /* Number of bits to pay attention to in the opcode for checking qp type */
 359 #define OPCODE_QP_MASK 0xE0
 360
 361 /*
 362  * Compare the lower 24 bits of the msn values.
 363  * Returns an integer <, ==, or > than zero.
 364  */
 365 static inline int cmp_msn(u32 a, u32 b)
 366 {
 367         return (((int) a) - ((int) b)) << 8;
 368 }
 369
 370 /*
 371  * Compare two PSNs
 372  * Returns an integer <, ==, or > than zero.
 373  */
 374 static inline int cmp_psn(u32 a, u32 b)
 375 {
 376         return (((int) a) - ((int) b)) << PSN_SHIFT;
 377 }
 378
 379 /*
 380  * Return masked PSN
 381  */
 382 static inline u32 mask_psn(u32 a)
 383 {
 384         return a & PSN_MASK;
 385 }
 386
 387 /*
 388  * Return delta between two PSNs
 389  */
 390 static inline u32 delta_psn(u32 a, u32 b)
 391 {
 392         return (((int)a - (int)b) << PSN_SHIFT) >> PSN_SHIFT;
 393 }
 394
 395 struct verbs_txreq;
 396 void hfi1_put_txreq(struct verbs_txreq *tx);
 397
 398 int hfi1_verbs_send(struct rvt_qp *qp, struct hfi1_pkt_state *ps);
 399
 400 void hfi1_copy_sge(struct rvt_sge_state *ss, void *data, u32 length,
 401                    int release, int copy_last);
 402
 403 void hfi1_skip_sge(struct rvt_sge_state *ss, u32 length, int release);
 404
 405 void hfi1_cnp_rcv(struct hfi1_packet *packet);
 406
 407 void hfi1_uc_rcv(struct hfi1_packet *packet);
 408
 409 void hfi1_rc_rcv(struct hfi1_packet *packet);
 410
 411 void hfi1_rc_hdrerr(
 412         struct hfi1_ctxtdata *rcd,
 413         struct hfi1_ib_header *hdr,
 414         u32 rcv_flags,
 415         struct rvt_qp *qp);
 416
 417 u8 ah_to_sc(struct ib_device *ibdev, struct ib_ah_attr *ah_attr);
 418
 419 struct ib_ah *hfi1_create_qp0_ah(struct hfi1_ibport *ibp, u16 dlid);
 420
 421 void hfi1_rc_rnr_retry(unsigned long arg);
 422
 423 void hfi1_rc_send_complete(struct rvt_qp *qp, struct hfi1_ib_header *hdr);
 424
 425 void hfi1_rc_error(struct rvt_qp *qp, enum ib_wc_status err);
 426
 427 void hfi1_ud_rcv(struct hfi1_packet *packet);
 428
 429 int hfi1_lookup_pkey_idx(struct hfi1_ibport *ibp, u16 pkey);
 430
 431 int hfi1_rvt_get_rwqe(struct rvt_qp *qp, int wr_id_only);
 432
 433 void hfi1_migrate_qp(struct rvt_qp *qp);
 434
 435 int hfi1_check_modify_qp(struct rvt_qp *qp, struct ib_qp_attr *attr,
 436                          int attr_mask, struct ib_udata *udata);
 437
 438 void hfi1_modify_qp(struct rvt_qp *qp, struct ib_qp_attr *attr,
 439                     int attr_mask, struct ib_udata *udata);
 440
 441 int hfi1_check_send_wr(struct rvt_qp *qp, struct ib_send_wr *wr);
 442
 443 int hfi1_ruc_check_hdr(struct hfi1_ibport *ibp, struct hfi1_ib_header *hdr,
 444                        int has_grh, struct rvt_qp *qp, u32 bth0);
 445
 446 u32 hfi1_make_grh(struct hfi1_ibport *ibp, struct ib_grh *hdr,
 447                   struct ib_global_route *grh, u32 hwords, u32 nwords);
 448
 449 void hfi1_make_ruc_header(struct rvt_qp *qp, struct hfi1_other_headers *ohdr,
 450                           u32 bth0, u32 bth2, int middle);
 451
 452 void _hfi1_do_send(struct work_struct *work);
 453
 454 void hfi1_do_send(struct rvt_qp *qp);
 455
 456 void hfi1_send_complete(struct rvt_qp *qp, struct rvt_swqe *wqe,
 457                         enum ib_wc_status status);
 458
 459 void hfi1_send_rc_ack(struct hfi1_ctxtdata *, struct rvt_qp *qp, int is_fecn);
 460
 461 int hfi1_make_rc_req(struct rvt_qp *qp);
 462
 463 int hfi1_make_uc_req(struct rvt_qp *qp);
 464
 465 int hfi1_make_ud_req(struct rvt_qp *qp);
 466
 467 int hfi1_register_ib_device(struct hfi1_devdata *);
 468
 469 void hfi1_unregister_ib_device(struct hfi1_devdata *);
 470
 471 void hfi1_ib_rcv(struct hfi1_packet *packet);
 472
 473 unsigned hfi1_get_npkeys(struct hfi1_devdata *);
 474
 475 int hfi1_verbs_send_dma(struct rvt_qp *qp, struct hfi1_pkt_state *ps,
 476                         u64 pbc);
 477
 478 int hfi1_verbs_send_pio(struct rvt_qp *qp, struct hfi1_pkt_state *ps,
 479                         u64 pbc);
 480
 481 struct send_context *qp_to_send_context(struct rvt_qp *qp, u8 sc5);
 482
 483 extern const enum ib_wc_opcode ib_hfi1_wc_opcode[];
 484
 485 extern const u8 hdr_len_by_opcode[];
 486
 487 extern const int ib_rvt_state_ops[];
 488
 489 extern __be64 ib_hfi1_sys_image_guid;    /* in network order */
 490
 491 extern unsigned int hfi1_max_cqes;
 492
 493 extern unsigned int hfi1_max_cqs;
 494
 495 extern unsigned int hfi1_max_qp_wrs;
 496
 497 extern unsigned int hfi1_max_qps;
 498
 499 extern unsigned int hfi1_max_sges;
 500
 501 extern unsigned int hfi1_max_mcast_grps;
 502
 503 extern unsigned int hfi1_max_mcast_qp_attached;
 504
 505 extern unsigned int hfi1_max_srqs;
 506
 507 extern unsigned int hfi1_max_srq_sges;
 508
 509 extern unsigned int hfi1_max_srq_wrs;
 510
 511 extern const u32 ib_hfi1_rnr_table[];
 512
 513 #endif                          /* HFI1_VERBS_H */