1 /*
2 * Copyright (c) 2008 Silicon Graphics, Inc. All Rights Reserved.
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU Lesser General Public License as published by
6 * the Free Software Foundation; either version 2.1 of the License, or
7 * (at your option) any later version.
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17 */
18
19 #ifndef __GRULIB_H__
20 #define __GRULIB_H__
21
22 #define GRU_BASENAME "gru"
23 #define GRU_FULLNAME "/dev/gru"
24 #define GRU_IOCTL_NUM 'G'
25
26 /*
27 * Maximum number of GRU segments that a user can have open
28 * ZZZ temp - set high for testing. Revisit.
29 */
30 #define GRU_MAX_OPEN_CONTEXTS 32
31
32 /* Set Number of Request Blocks */
33 #define GRU_CREATE_CONTEXT _IOWR(GRU_IOCTL_NUM, 1, void *)
34
35 /* Set Context Options */
36 #define GRU_SET_CONTEXT_OPTION _IOWR(GRU_IOCTL_NUM, 4, void *)
37
38 /* Fetch exception detail */
39 #define GRU_USER_GET_EXCEPTION_DETAIL _IOWR(GRU_IOCTL_NUM, 6, void *)
40
41 /* For user call_os handling - normally a TLB fault */
42 #define GRU_USER_CALL_OS _IOWR(GRU_IOCTL_NUM, 8, void *)
43
44 /* For user unload context */
45 #define GRU_USER_UNLOAD_CONTEXT _IOWR(GRU_IOCTL_NUM, 9, void *)
46
47 /* For dumpping GRU chiplet state */
48 #define GRU_DUMP_CHIPLET_STATE _IOWR(GRU_IOCTL_NUM, 11, void *)
49
50 /* For getting gseg statistics */
51 #define GRU_GET_GSEG_STATISTICS _IOWR(GRU_IOCTL_NUM, 12, void *)
52
53 /* For user TLB flushing (primarily for tests) */
54 #define GRU_USER_FLUSH_TLB _IOWR(GRU_IOCTL_NUM, 50, void *)
55
56 /* Get some config options (primarily for tests & emulator) */
57 #define GRU_GET_CONFIG_INFO _IOWR(GRU_IOCTL_NUM, 51, void *)
58
59 /* Various kernel self-tests */
60 #define GRU_KTEST _IOWR(GRU_IOCTL_NUM, 52, void *)
61
62 #define CONTEXT_WINDOW_BYTES(th) (GRU_GSEG_PAGESIZE * (th))
63 #define THREAD_POINTER(p, th) (p + GRU_GSEG_PAGESIZE * (th))
64 #define GSEG_START(cb) ((void *)((unsigned long)(cb) & ~(GRU_GSEG_PAGESIZE - 1)))
65
66 struct gru_get_gseg_statistics_req {
67 unsigned long gseg;
68 struct gru_gseg_statistics stats;
69 };
70
71 /*
72 * Structure used to pass TLB flush parameters to the driver
73 */
74 struct gru_create_context_req {
75 unsigned long gseg;
76 unsigned int data_segment_bytes;
77 unsigned int control_blocks;
78 unsigned int maximum_thread_count;
79 unsigned int options;
80 unsigned char tlb_preload_count;
81 };
82
83 /*
84 * Structure used to pass unload context parameters to the driver
85 */
86 struct gru_unload_context_req {
87 unsigned long gseg;
88 };
89
90 /*
91 * Structure used to set context options
92 */
93 enum {sco_gseg_owner, sco_cch_req_slice, sco_blade_chiplet};
94 struct gru_set_context_option_req {
95 unsigned long gseg;
96 int op;
97 int val0;
98 long val1;
99 };
100
101 /*
102 * Structure used to pass TLB flush parameters to the driver
103 */
104 struct gru_flush_tlb_req {
105 unsigned long gseg;
106 unsigned long vaddr;
107 size_t len;
108 };
109
110 /*
111 * Structure used to pass TLB flush parameters to the driver
112 */
113 enum {dcs_pid, dcs_gid};
114 struct gru_dump_chiplet_state_req {
115 unsigned int op;
116 unsigned int gid;
117 int ctxnum;
118 char data_opt;
119 char lock_cch;
120 char flush_cbrs;
121 char fill[10];
122 pid_t pid;
123 void *buf;
124 size_t buflen;
125 /* ---- output --- */
126 unsigned int num_contexts;
127 };
128
129 #define GRU_DUMP_MAGIC 0x3474ab6c
130 struct gru_dump_context_header {
131 unsigned int magic;
132 unsigned int gid;
133 unsigned char ctxnum;
134 unsigned char cbrcnt;
135 unsigned char dsrcnt;
136 pid_t pid;
137 unsigned long vaddr;
138 int cch_locked;
139 unsigned long data[0];
140 };
141
142 /*
143 * GRU configuration info (temp - for testing)
144 */
145 struct gru_config_info {
146 int cpus;
147 int blades;
148 int nodes;
149 int chiplets;
150 int fill[16];
151 };
152
153 #endif /* __GRULIB_H__ */