Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
grulib.h
Go to the documentation of this file.
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 
67  unsigned long gseg;
69 };
70 
71 /*
72  * Structure used to pass TLB flush parameters to the driver
73  */
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  */
87  unsigned long gseg;
88 };
89 
90 /*
91  * Structure used to set context options
92  */
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  */
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};
115  unsigned int op;
116  unsigned int gid;
117  int ctxnum;
118  char data_opt;
119  char lock_cch;
121  char fill[10];
123  void *buf;
124  size_t buflen;
125  /* ---- output --- */
126  unsigned int num_contexts;
127 };
128 
129 #define GRU_DUMP_MAGIC 0x3474ab6c
131  unsigned int magic;
132  unsigned int gid;
133  unsigned char ctxnum;
134  unsigned char cbrcnt;
135  unsigned char dsrcnt;
137  unsigned long vaddr;
139  unsigned long data[0];
140 };
141 
142 /*
143  * GRU configuration info (temp - for testing)
144  */
146  int cpus;
147  int blades;
148  int nodes;
149  int chiplets;
150  int fill[16];
151 };
152 
153 #endif /* __GRULIB_H__ */