xref: /illumos-gate/usr/src/uts/sun4v/sys/drctl.h (revision 89b2a9fbeabf42fa54594df0e5927bcc50a07cc9)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 
22 /*
23  * Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 
27 #ifndef _SYS_DRCTL_H
28 #define	_SYS_DRCTL_H
29 
30 #ifdef	__cplusplus
31 extern "C" {
32 #endif
33 
34 
35 #define	DRCTL_DEV "/devices/pseudo/drctl@0:drctl"
36 
37 typedef enum {
38 	DRCTL_CPU_CONFIG_REQUEST = 1,
39 	DRCTL_CPU_CONFIG_NOTIFY,
40 	DRCTL_CPU_UNCONFIG_REQUEST,
41 	DRCTL_CPU_UNCONFIG_NOTIFY,
42 	DRCTL_MEM_CONFIG_REQUEST,
43 	DRCTL_MEM_CONFIG_NOTIFY,
44 	DRCTL_MEM_UNCONFIG_REQUEST,
45 	DRCTL_MEM_UNCONFIG_NOTIFY,
46 	DRCTL_IO_CONFIG_REQUEST,
47 	DRCTL_IO_CONFIG_NOTIFY,
48 	DRCTL_IO_UNCONFIG_REQUEST,
49 	DRCTL_IO_UNCONFIG_NOTIFY
50 } drctl_cmds_t;
51 
52 /*
53  * Responses to/from the daemon for a reconfig request.
54  */
55 typedef enum {
56 	DRCTL_STATUS_INIT,		/* to daemon */
57 	DRCTL_STATUS_ALLOW,		/* from daemon */
58 	DRCTL_STATUS_DENY,		/* from daemon */
59 	DRCTL_STATUS_CONFIG_SUCCESS,	/* to daemon */
60 	DRCTL_STATUS_CONFIG_FAILURE	/* to daemon */
61 } drctl_status_t;
62 
63 /*
64  * Each resource descriptor consists of a common header
65  * followed by a resource-specific structure.
66  */
67 
68 typedef struct drctl_rsrc_cpu {
69 	int		id;
70 } drctl_rsrc_cpu_t;
71 
72 typedef struct drctl_rsrc_memory {
73 	uint64_t	size;
74 	uint64_t	addr;
75 } drctl_rsrc_mem_t;
76 
77 typedef struct drctl_rsrc_dev {
78 	char		path[1];
79 } drctl_rsrc_dev_t;
80 
81 typedef struct drctl_rsrc {
82 	drctl_status_t	status;
83 	uint64_t	offset;
84 	union {
85 		drctl_rsrc_cpu_t cpu;
86 		drctl_rsrc_mem_t mem;
87 		drctl_rsrc_dev_t dev;
88 	} un;
89 } drctl_rsrc_t;
90 
91 #define	res_cpu_id	un.cpu.id
92 #define	res_mem_size	un.mem.size
93 #define	res_mem_addr	un.mem.addr
94 #define	res_dev_path	un.dev.path
95 
96 /*
97  * Response structure passed back by drctl to its clients
98  * (resource-specific DR modules).
99  */
100 typedef enum {
101 	DRCTL_RESP_ERR,
102 	DRCTL_RESP_OK
103 } drctl_resp_type_t;
104 
105 typedef struct drctl_resp {
106 	drctl_resp_type_t resp_type;
107 	union {
108 		char err_msg[1];
109 		drctl_rsrc_t  resources[1];
110 	} un;
111 } drctl_resp_t;
112 
113 #define	resp_err_msg		un.err_msg
114 #define	resp_resources		un.resources
115 
116 /*
117  * Message sent to DR daemon
118  */
119 typedef struct drd_msg {
120 	uint_t		cmd;
121 	uint_t		count;
122 	int		flags;
123 	drctl_rsrc_t	data[1];
124 } drd_msg_t;
125 
126 typedef void *drctl_cookie_t;
127 
128 /*
129  * DR RSMs (resource-specific modules) call these functions to
130  * initialize or finalize a DR request.  A request may include
131  * multiple resources of the same type.  The _init call returns
132  * a cookie which must be supplied on by the corresponding
133  * _fini call.
134  */
135 extern int drctl_config_init(int, int,
136     drctl_rsrc_t *, int, drctl_resp_t **, size_t *, drctl_cookie_t);
137 extern int drctl_config_fini(drctl_cookie_t, drctl_rsrc_t *, int);
138 
139 /*
140  * Values for the 2nd arg (flags) of drctl_config_init
141  */
142 #define	DRCTL_FLAG_FORCE 1
143 
144 
145 #ifdef	__cplusplus
146 }
147 #endif
148 
149 #endif	/* _SYS_DRCTL_H */
150