1 /* Copyright (C) 2010 - 2013 UNISYS CORPORATION
2  * 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 General Public License as published by
6  * the Free Software Foundation; either version 2 of the License, or (at
7  * your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, GOOD TITLE or
12  * NON INFRINGEMENT.  See the GNU General Public License for more
13  * details.
14  */
15 
16 #ifndef __VBUSCHANNEL_H__
17 #define __VBUSCHANNEL_H__
18 
19 /*  The vbus channel is the channel area provided via the BUS_CREATE controlvm
20  *  message for each virtual bus.  This channel area is provided to both server
21  *  and client ends of the bus.  The channel header area is initialized by
22  *  the server, and the remaining information is filled in by the client.
23  *  We currently use this for the client to provide various information about
24  *  the client devices and client drivers for the server end to see.
25  */
26 #include <linux/uuid.h>
27 #include "vbusdeviceinfo.h"
28 #include "channel.h"
29 
30 /* {193b331b-c58f-11da-95a9-00e08161165f} */
31 #define SPAR_VBUS_CHANNEL_PROTOCOL_UUID \
32 		UUID_LE(0x193b331b, 0xc58f, 0x11da, \
33 				0x95, 0xa9, 0x0, 0xe0, 0x81, 0x61, 0x16, 0x5f)
34 static const uuid_le spar_vbus_channel_protocol_uuid =
35 	SPAR_VBUS_CHANNEL_PROTOCOL_UUID;
36 
37 #define SPAR_VBUS_CHANNEL_PROTOCOL_SIGNATURE ULTRA_CHANNEL_PROTOCOL_SIGNATURE
38 
39 /* Must increment this whenever you insert or delete fields within this channel
40 * struct.  Also increment whenever you change the meaning of fields within this
41 * channel struct so as to break pre-existing software.  Note that you can
42 * usually add fields to the END of the channel struct withOUT needing to
43 * increment this. */
44 #define SPAR_VBUS_CHANNEL_PROTOCOL_VERSIONID 1
45 
46 #define SPAR_VBUS_CHANNEL_OK_CLIENT(ch)       \
47 	spar_check_channel_client(ch,				\
48 				   spar_vbus_channel_protocol_uuid,	\
49 				   "vbus",				\
50 				   sizeof(struct spar_vbus_channel_protocol),\
51 				   SPAR_VBUS_CHANNEL_PROTOCOL_VERSIONID, \
52 				   SPAR_VBUS_CHANNEL_PROTOCOL_SIGNATURE)
53 
54 #define SPAR_VBUS_CHANNEL_OK_SERVER(actual_bytes)    \
55 	(spar_check_channel_server(spar_vbus_channel_protocol_uuid,	\
56 				   "vbus",				\
57 				   sizeof(struct ultra_vbus_channel_protocol),\
58 				   actual_bytes))
59 
60 #pragma pack(push, 1)		/* both GCC and VC now allow this pragma */
61 struct spar_vbus_headerinfo {
62 	u32 struct_bytes;	/* size of this struct in bytes */
63 	u32 device_info_struct_bytes;	/* sizeof(ULTRA_VBUS_DEVICEINFO) */
64 	u32 dev_info_count;	/* num of items in DevInfo member */
65 	/* (this is the allocated size) */
66 	u32 chp_info_offset;	/* byte offset from beginning of this struct */
67 	/* to the ChpInfo struct (below) */
68 	u32 bus_info_offset;	/* byte offset from beginning of this struct */
69 	/* to the BusInfo struct (below) */
70 	u32 dev_info_offset;	/* byte offset from beginning of this struct */
71 	/* to the DevInfo array (below) */
72 	u8 reserved[104];
73 };
74 
75 struct spar_vbus_channel_protocol {
76 	struct channel_header channel_header;	/* initialized by server */
77 	struct spar_vbus_headerinfo hdr_info;	/* initialized by server */
78 	/* the remainder of this channel is filled in by the client */
79 	struct ultra_vbus_deviceinfo chp_info;
80 	/* describes client chipset device and driver */
81 	struct ultra_vbus_deviceinfo bus_info;
82 	/* describes client bus device and driver */
83 	struct ultra_vbus_deviceinfo dev_info[0];
84 	/* describes client device and driver for each device on the bus */
85 };
86 
87 #define VBUS_CH_SIZE_EXACT(MAXDEVICES) \
88 	(sizeof(ULTRA_VBUS_CHANNEL_PROTOCOL) + ((MAXDEVICES) * \
89 						sizeof(ULTRA_VBUS_DEVICEINFO)))
90 #define VBUS_CH_SIZE(MAXDEVICES) COVER(VBUS_CH_SIZE_EXACT(MAXDEVICES), 4096)
91 
92 #pragma pack(pop)
93 
94 #endif
95