1/* SPDX-License-Identifier: GPL-2.0 */
2/*
3 * Internal Shared Memory
4 *
5 * Definitions for the ISM module
6 *
7 * Copyright IBM Corp. 2022
8 */
9#ifndef _ISM_H
10#define _ISM_H
11
12#include <linux/workqueue.h>
13
14struct ism_dmb {
15 u64 dmb_tok;
16 u64 rgid;
17 u32 dmb_len;
18 u32 sba_idx;
19 u32 vlan_valid;
20 u32 vlan_id;
21 void *cpu_addr;
22 dma_addr_t dma_addr;
23};
24
25/* Unless we gain unexpected popularity, this limit should hold for a while */
26#define MAX_CLIENTS 8
27#define ISM_NR_DMBS 1920
28
29struct ism_dev {
30 spinlock_t lock; /* protects the ism device */
31 struct list_head list;
32 struct pci_dev *pdev;
33
34 struct ism_sba *sba;
35 dma_addr_t sba_dma_addr;
36 DECLARE_BITMAP(sba_bitmap, ISM_NR_DMBS);
37 u8 *sba_client_arr; /* entries are indices into 'clients' array */
38 void *priv[MAX_CLIENTS];
39
40 struct ism_eq *ieq;
41 dma_addr_t ieq_dma_addr;
42
43 struct device dev;
44 u64 local_gid;
45 int ieq_idx;
46
47 struct ism_client *subs[MAX_CLIENTS];
48};
49
50struct ism_event {
51 u32 type;
52 u32 code;
53 u64 tok;
54 u64 time;
55 u64 info;
56};
57
58struct ism_client {
59 const char *name;
60 void (*add)(struct ism_dev *dev);
61 void (*remove)(struct ism_dev *dev);
62 void (*handle_event)(struct ism_dev *dev, struct ism_event *event);
63 /* Parameter dmbemask contains a bit vector with updated DMBEs, if sent
64 * via ism_move_data(). Callback function must handle all active bits
65 * indicated by dmbemask.
66 */
67 void (*handle_irq)(struct ism_dev *dev, unsigned int bit, u16 dmbemask);
68 /* Private area - don't touch! */
69 u8 id;
70};
71
72int ism_register_client(struct ism_client *client);
73int ism_unregister_client(struct ism_client *client);
74static inline void *ism_get_priv(struct ism_dev *dev,
75 struct ism_client *client) {
76 return dev->priv[client->id];
77}
78
79static inline void ism_set_priv(struct ism_dev *dev, struct ism_client *client,
80 void *priv) {
81 dev->priv[client->id] = priv;
82}
83
84int ism_register_dmb(struct ism_dev *dev, struct ism_dmb *dmb,
85 struct ism_client *client);
86int ism_unregister_dmb(struct ism_dev *dev, struct ism_dmb *dmb);
87int ism_move(struct ism_dev *dev, u64 dmb_tok, unsigned int idx, bool sf,
88 unsigned int offset, void *data, unsigned int size);
89u8 *ism_get_seid(void);
90
91const struct smcd_ops *ism_get_smcd_ops(void);
92
93#endif /* _ISM_H */
94

source code of linux/include/linux/ism.h