• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /* visorchannel_funcs.c
2  *
3  * Copyright (C) 2010 - 2015 UNISYS CORPORATION
4  * All rights reserved.
5  *
6  * This program is free software; you can redistribute it and/or modify it
7  * under the terms and conditions of the GNU General Public License,
8  * version 2, as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, GOOD TITLE or
13  * NON INFRINGEMENT.  See the GNU General Public License for more
14  * details.
15  */
16 
17 /*
18  *  This provides s-Par channel communication primitives, which are
19  *  independent of the mechanism used to access the channel data.
20  */
21 
22 #include <linux/uuid.h>
23 #include <linux/io.h>
24 
25 #include "visorbus.h"
26 #include "controlvmchannel.h"
27 
28 #define MYDRVNAME "visorchannel"
29 
30 #define SPAR_CONSOLEVIDEO_CHANNEL_PROTOCOL_GUID \
31 	UUID_LE(0x3cd6e705, 0xd6a2, 0x4aa5,           \
32 		0xad, 0x5c, 0x7b, 0x8, 0x88, 0x9d, 0xff, 0xe2)
33 static const uuid_le spar_video_guid = SPAR_CONSOLEVIDEO_CHANNEL_PROTOCOL_GUID;
34 
35 struct visorchannel {
36 	u64 physaddr;
37 	ulong nbytes;
38 	void *mapped;
39 	bool requested;
40 	struct channel_header chan_hdr;
41 	uuid_le guid;
42 	bool needs_lock;	/* channel creator knows if more than one */
43 				/* thread will be inserting or removing */
44 	spinlock_t insert_lock; /* protect head writes in chan_hdr */
45 	spinlock_t remove_lock;	/* protect tail writes in chan_hdr */
46 
47 	struct {
48 		struct signal_queue_header req_queue;
49 		struct signal_queue_header rsp_queue;
50 		struct signal_queue_header event_queue;
51 		struct signal_queue_header ack_queue;
52 	} safe_uis_queue;
53 	uuid_le type;
54 	uuid_le inst;
55 };
56 
57 void
visorchannel_destroy(struct visorchannel * channel)58 visorchannel_destroy(struct visorchannel *channel)
59 {
60 	if (!channel)
61 		return;
62 	if (channel->mapped) {
63 		memunmap(channel->mapped);
64 		if (channel->requested)
65 			release_mem_region(channel->physaddr, channel->nbytes);
66 	}
67 	kfree(channel);
68 }
69 
70 u64
visorchannel_get_physaddr(struct visorchannel * channel)71 visorchannel_get_physaddr(struct visorchannel *channel)
72 {
73 	return channel->physaddr;
74 }
75 
76 ulong
visorchannel_get_nbytes(struct visorchannel * channel)77 visorchannel_get_nbytes(struct visorchannel *channel)
78 {
79 	return channel->nbytes;
80 }
81 
82 char *
visorchannel_uuid_id(uuid_le * guid,char * s)83 visorchannel_uuid_id(uuid_le *guid, char *s)
84 {
85 	sprintf(s, "%pUL", guid);
86 	return s;
87 }
88 
89 char *
visorchannel_id(struct visorchannel * channel,char * s)90 visorchannel_id(struct visorchannel *channel, char *s)
91 {
92 	return visorchannel_uuid_id(&channel->guid, s);
93 }
94 
95 char *
visorchannel_zoneid(struct visorchannel * channel,char * s)96 visorchannel_zoneid(struct visorchannel *channel, char *s)
97 {
98 	return visorchannel_uuid_id(&channel->chan_hdr.zone_uuid, s);
99 }
100 
101 u64
visorchannel_get_clientpartition(struct visorchannel * channel)102 visorchannel_get_clientpartition(struct visorchannel *channel)
103 {
104 	return channel->chan_hdr.partition_handle;
105 }
106 
107 int
visorchannel_set_clientpartition(struct visorchannel * channel,u64 partition_handle)108 visorchannel_set_clientpartition(struct visorchannel *channel,
109 				 u64 partition_handle)
110 {
111 	channel->chan_hdr.partition_handle = partition_handle;
112 	return 0;
113 }
114 
115 /**
116  * visorchannel_get_uuid() - queries the UUID of the designated channel
117  * @channel: the channel to query
118  *
119  * Return: the UUID of the provided channel
120  */
121 uuid_le
visorchannel_get_uuid(struct visorchannel * channel)122 visorchannel_get_uuid(struct visorchannel *channel)
123 {
124 	return channel->guid;
125 }
126 EXPORT_SYMBOL_GPL(visorchannel_get_uuid);
127 
128 int
visorchannel_read(struct visorchannel * channel,ulong offset,void * local,ulong nbytes)129 visorchannel_read(struct visorchannel *channel, ulong offset,
130 		  void *local, ulong nbytes)
131 {
132 	if (offset + nbytes > channel->nbytes)
133 		return -EIO;
134 
135 	memcpy(local, channel->mapped + offset, nbytes);
136 
137 	return 0;
138 }
139 
140 int
visorchannel_write(struct visorchannel * channel,ulong offset,void * local,ulong nbytes)141 visorchannel_write(struct visorchannel *channel, ulong offset,
142 		   void *local, ulong nbytes)
143 {
144 	size_t chdr_size = sizeof(struct channel_header);
145 	size_t copy_size;
146 
147 	if (offset + nbytes > channel->nbytes)
148 		return -EIO;
149 
150 	if (offset < chdr_size) {
151 		copy_size = min(chdr_size - offset, nbytes);
152 		memcpy(((char *)(&channel->chan_hdr)) + offset,
153 		       local, copy_size);
154 	}
155 
156 	memcpy(channel->mapped + offset, local, nbytes);
157 
158 	return 0;
159 }
160 
161 void __iomem  *
visorchannel_get_header(struct visorchannel * channel)162 visorchannel_get_header(struct visorchannel *channel)
163 {
164 	return (void __iomem *)&channel->chan_hdr;
165 }
166 
167 /*
168  * Return offset of a specific SIGNAL_QUEUE_HEADER from the beginning of a
169  * channel header
170  */
171 #define SIG_QUEUE_OFFSET(chan_hdr, q) \
172 	((chan_hdr)->ch_space_offset + \
173 	 ((q) * sizeof(struct signal_queue_header)))
174 
175 /*
176  * Return offset of a specific queue entry (data) from the beginning of a
177  * channel header
178  */
179 #define SIG_DATA_OFFSET(chan_hdr, q, sig_hdr, slot) \
180 	(SIG_QUEUE_OFFSET(chan_hdr, q) + (sig_hdr)->sig_base_offset + \
181 	    ((slot) * (sig_hdr)->signal_size))
182 
183 /*
184  * Write the contents of a specific field within a SIGNAL_QUEUE_HEADER back
185  * into host memory
186  */
187 #define SIG_WRITE_FIELD(channel, queue, sig_hdr, FIELD)			 \
188 	visorchannel_write(channel,					 \
189 			   SIG_QUEUE_OFFSET(&channel->chan_hdr, queue) +\
190 			   offsetof(struct signal_queue_header, FIELD), \
191 			   &((sig_hdr)->FIELD),			 \
192 			   sizeof((sig_hdr)->FIELD))
193 
194 static int
sig_read_header(struct visorchannel * channel,u32 queue,struct signal_queue_header * sig_hdr)195 sig_read_header(struct visorchannel *channel, u32 queue,
196 		struct signal_queue_header *sig_hdr)
197 {
198 	if (channel->chan_hdr.ch_space_offset < sizeof(struct channel_header))
199 		return -EINVAL;
200 
201 	/* Read the appropriate SIGNAL_QUEUE_HEADER into local memory. */
202 	return visorchannel_read(channel,
203 				 SIG_QUEUE_OFFSET(&channel->chan_hdr, queue),
204 				 sig_hdr, sizeof(struct signal_queue_header));
205 }
206 
207 static inline int
sig_read_data(struct visorchannel * channel,u32 queue,struct signal_queue_header * sig_hdr,u32 slot,void * data)208 sig_read_data(struct visorchannel *channel, u32 queue,
209 	      struct signal_queue_header *sig_hdr, u32 slot, void *data)
210 {
211 	int signal_data_offset = SIG_DATA_OFFSET(&channel->chan_hdr, queue,
212 						 sig_hdr, slot);
213 
214 	return visorchannel_read(channel, signal_data_offset,
215 				 data, sig_hdr->signal_size);
216 }
217 
218 static inline int
sig_write_data(struct visorchannel * channel,u32 queue,struct signal_queue_header * sig_hdr,u32 slot,void * data)219 sig_write_data(struct visorchannel *channel, u32 queue,
220 	       struct signal_queue_header *sig_hdr, u32 slot, void *data)
221 {
222 	int signal_data_offset = SIG_DATA_OFFSET(&channel->chan_hdr, queue,
223 						 sig_hdr, slot);
224 
225 	return visorchannel_write(channel, signal_data_offset,
226 				  data, sig_hdr->signal_size);
227 }
228 
229 static int
signalremove_inner(struct visorchannel * channel,u32 queue,void * msg)230 signalremove_inner(struct visorchannel *channel, u32 queue, void *msg)
231 {
232 	struct signal_queue_header sig_hdr;
233 	int error;
234 
235 	error = sig_read_header(channel, queue, &sig_hdr);
236 	if (error)
237 		return error;
238 
239 	if (sig_hdr.head == sig_hdr.tail)
240 		return -EIO;	/* no signals to remove */
241 
242 	sig_hdr.tail = (sig_hdr.tail + 1) % sig_hdr.max_slots;
243 
244 	error = sig_read_data(channel, queue, &sig_hdr, sig_hdr.tail, msg);
245 	if (error)
246 		return error;
247 
248 	sig_hdr.num_received++;
249 
250 	/*
251 	 * For each data field in SIGNAL_QUEUE_HEADER that was modified,
252 	 * update host memory.
253 	 */
254 	mb(); /* required for channel synch */
255 
256 	error = SIG_WRITE_FIELD(channel, queue, &sig_hdr, tail);
257 	if (error)
258 		return error;
259 	error = SIG_WRITE_FIELD(channel, queue, &sig_hdr, num_received);
260 	if (error)
261 		return error;
262 
263 	return 0;
264 }
265 
266 /**
267  * visorchannel_signalremove() - removes a message from the designated
268  *                               channel/queue
269  * @channel: the channel the message will be removed from
270  * @queue:   the queue the message will be removed from
271  * @msg:     the message to remove
272  *
273  * Return: integer error code indicating the status of the removal
274  */
275 int
visorchannel_signalremove(struct visorchannel * channel,u32 queue,void * msg)276 visorchannel_signalremove(struct visorchannel *channel, u32 queue, void *msg)
277 {
278 	int rc;
279 	unsigned long flags;
280 
281 	if (channel->needs_lock) {
282 		spin_lock_irqsave(&channel->remove_lock, flags);
283 		rc = signalremove_inner(channel, queue, msg);
284 		spin_unlock_irqrestore(&channel->remove_lock, flags);
285 	} else {
286 		rc = signalremove_inner(channel, queue, msg);
287 	}
288 
289 	return rc;
290 }
291 EXPORT_SYMBOL_GPL(visorchannel_signalremove);
292 
293 /**
294  * visorchannel_signalempty() - checks if the designated channel/queue
295  *                              contains any messages
296  * @channel: the channel to query
297  * @queue:   the queue in the channel to query
298  *
299  * Return: boolean indicating whether any messages in the designated
300  *         channel/queue are present
301  */
302 bool
visorchannel_signalempty(struct visorchannel * channel,u32 queue)303 visorchannel_signalempty(struct visorchannel *channel, u32 queue)
304 {
305 	unsigned long flags = 0;
306 	struct signal_queue_header sig_hdr;
307 	bool rc = false;
308 
309 	if (channel->needs_lock)
310 		spin_lock_irqsave(&channel->remove_lock, flags);
311 
312 	if (sig_read_header(channel, queue, &sig_hdr))
313 		rc = true;
314 	if (sig_hdr.head == sig_hdr.tail)
315 		rc = true;
316 	if (channel->needs_lock)
317 		spin_unlock_irqrestore(&channel->remove_lock, flags);
318 
319 	return rc;
320 }
321 EXPORT_SYMBOL_GPL(visorchannel_signalempty);
322 
323 static int
signalinsert_inner(struct visorchannel * channel,u32 queue,void * msg)324 signalinsert_inner(struct visorchannel *channel, u32 queue, void *msg)
325 {
326 	struct signal_queue_header sig_hdr;
327 	int error;
328 
329 	error = sig_read_header(channel, queue, &sig_hdr);
330 	if (error)
331 		return error;
332 
333 	sig_hdr.head = (sig_hdr.head + 1) % sig_hdr.max_slots;
334 	if (sig_hdr.head == sig_hdr.tail) {
335 		sig_hdr.num_overflows++;
336 		visorchannel_write(channel,
337 				   SIG_QUEUE_OFFSET(&channel->chan_hdr, queue) +
338 				   offsetof(struct signal_queue_header,
339 					    num_overflows),
340 				   &sig_hdr.num_overflows,
341 				   sizeof(sig_hdr.num_overflows));
342 		return -EIO;
343 	}
344 
345 	error = sig_write_data(channel, queue, &sig_hdr, sig_hdr.head, msg);
346 	if (error)
347 		return error;
348 
349 	sig_hdr.num_sent++;
350 
351 	/*
352 	 * For each data field in SIGNAL_QUEUE_HEADER that was modified,
353 	 * update host memory.
354 	 */
355 	mb(); /* required for channel synch */
356 
357 	error = SIG_WRITE_FIELD(channel, queue, &sig_hdr, head);
358 	if (error)
359 		return error;
360 	error = SIG_WRITE_FIELD(channel, queue, &sig_hdr, num_sent);
361 	if (error)
362 		return error;
363 
364 	return 0;
365 }
366 
367 /**
368  * visorchannel_create_guts() - creates the struct visorchannel abstraction
369  *                              for a data area in memory, but does NOT modify
370  *                              this data area
371  * @physaddr:      physical address of start of channel
372  * @channel_bytes: size of the channel in bytes; this may 0 if the channel has
373  *                 already been initialized in memory (which is true for all
374  *                 channels provided to guest environments by the s-Par
375  *                 back-end), in which case the actual channel size will be
376  *                 read from the channel header in memory
377  * @gfp:           gfp_t to use when allocating memory for the data struct
378  * @guid:          uuid that identifies channel type; this may 0 if the channel
379  *                 has already been initialized in memory (which is true for all
380  *                 channels provided to guest environments by the s-Par
381  *                 back-end), in which case the actual channel guid will be
382  *                 read from the channel header in memory
383  * @needs_lock:    must specify true if you have multiple threads of execution
384  *                 that will be calling visorchannel methods of this
385  *                 visorchannel at the same time
386  *
387  * Return: pointer to visorchannel that was created if successful,
388  *         otherwise NULL
389  */
390 static struct visorchannel *
visorchannel_create_guts(u64 physaddr,unsigned long channel_bytes,gfp_t gfp,uuid_le guid,bool needs_lock)391 visorchannel_create_guts(u64 physaddr, unsigned long channel_bytes,
392 			 gfp_t gfp, uuid_le guid, bool needs_lock)
393 {
394 	struct visorchannel *channel;
395 	int err;
396 	size_t size = sizeof(struct channel_header);
397 
398 	if (physaddr == 0)
399 		return NULL;
400 
401 	channel = kzalloc(sizeof(*channel), gfp);
402 	if (!channel)
403 		return NULL;
404 
405 	channel->needs_lock = needs_lock;
406 	spin_lock_init(&channel->insert_lock);
407 	spin_lock_init(&channel->remove_lock);
408 
409 	/*
410 	 * Video driver constains the efi framebuffer so it will get a
411 	 * conflict resource when requesting its full mem region. Since
412 	 * we are only using the efi framebuffer for video we can ignore
413 	 * this. Remember that we haven't requested it so we don't try to
414 	 * release later on.
415 	 */
416 	channel->requested = request_mem_region(physaddr, size, MYDRVNAME);
417 	if (!channel->requested) {
418 		if (uuid_le_cmp(guid, spar_video_guid)) {
419 			/* Not the video channel we care about this */
420 			goto err_destroy_channel;
421 		}
422 	}
423 
424 	channel->mapped = memremap(physaddr, size, MEMREMAP_WB);
425 	if (!channel->mapped) {
426 		release_mem_region(physaddr, size);
427 		goto err_destroy_channel;
428 	}
429 
430 	channel->physaddr = physaddr;
431 	channel->nbytes = size;
432 
433 	err = visorchannel_read(channel, 0, &channel->chan_hdr,
434 				sizeof(struct channel_header));
435 	if (err)
436 		goto err_destroy_channel;
437 
438 	/* we had better be a CLIENT of this channel */
439 	if (channel_bytes == 0)
440 		channel_bytes = (ulong)channel->chan_hdr.size;
441 	if (uuid_le_cmp(guid, NULL_UUID_LE) == 0)
442 		guid = channel->chan_hdr.chtype;
443 
444 	memunmap(channel->mapped);
445 	if (channel->requested)
446 		release_mem_region(channel->physaddr, channel->nbytes);
447 	channel->mapped = NULL;
448 	channel->requested = request_mem_region(channel->physaddr,
449 						channel_bytes, MYDRVNAME);
450 	if (!channel->requested) {
451 		if (uuid_le_cmp(guid, spar_video_guid)) {
452 			/* Different we care about this */
453 			goto err_destroy_channel;
454 		}
455 	}
456 
457 	channel->mapped = memremap(channel->physaddr, channel_bytes,
458 			MEMREMAP_WB);
459 	if (!channel->mapped) {
460 		release_mem_region(channel->physaddr, channel_bytes);
461 		goto err_destroy_channel;
462 	}
463 
464 	channel->nbytes = channel_bytes;
465 	channel->guid = guid;
466 	return channel;
467 
468 err_destroy_channel:
469 	visorchannel_destroy(channel);
470 	return NULL;
471 }
472 
473 struct visorchannel *
visorchannel_create(u64 physaddr,unsigned long channel_bytes,gfp_t gfp,uuid_le guid)474 visorchannel_create(u64 physaddr, unsigned long channel_bytes,
475 		    gfp_t gfp, uuid_le guid)
476 {
477 	return visorchannel_create_guts(physaddr, channel_bytes, gfp, guid,
478 					false);
479 }
480 
481 struct visorchannel *
visorchannel_create_with_lock(u64 physaddr,unsigned long channel_bytes,gfp_t gfp,uuid_le guid)482 visorchannel_create_with_lock(u64 physaddr, unsigned long channel_bytes,
483 			      gfp_t gfp, uuid_le guid)
484 {
485 	return visorchannel_create_guts(physaddr, channel_bytes, gfp, guid,
486 					true);
487 }
488 
489 /**
490  * visorchannel_signalinsert() - inserts a message into the designated
491  *                               channel/queue
492  * @channel: the channel the message will be added to
493  * @queue:   the queue the message will be added to
494  * @msg:     the message to insert
495  *
496  * Return: integer error code indicating the status of the insertion
497  */
498 int
visorchannel_signalinsert(struct visorchannel * channel,u32 queue,void * msg)499 visorchannel_signalinsert(struct visorchannel *channel, u32 queue, void *msg)
500 {
501 	int rc;
502 	unsigned long flags;
503 
504 	if (channel->needs_lock) {
505 		spin_lock_irqsave(&channel->insert_lock, flags);
506 		rc = signalinsert_inner(channel, queue, msg);
507 		spin_unlock_irqrestore(&channel->insert_lock, flags);
508 	} else {
509 		rc = signalinsert_inner(channel, queue, msg);
510 	}
511 
512 	return rc;
513 }
514 EXPORT_SYMBOL_GPL(visorchannel_signalinsert);
515