2 * vgaarb.c: Implements the VGA arbitration. For details refer to
3 * Documentation/vgaarbiter.txt
6 * (C) Copyright 2005 Benjamin Herrenschmidt <benh@kernel.crashing.org>
7 * (C) Copyright 2007 Paulo R. Zanoni <przanoni@gmail.com>
8 * (C) Copyright 2007, 2009 Tiago Vignatti <vignatti@freedesktop.org>
10 * Permission is hereby granted, free of charge, to any person obtaining a
11 * copy of this software and associated documentation files (the "Software"),
12 * to deal in the Software without restriction, including without limitation
13 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
14 * and/or sell copies of the Software, and to permit persons to whom the
15 * Software is furnished to do so, subject to the following conditions:
17 * The above copyright notice and this permission notice (including the next
18 * paragraph) shall be included in all copies or substantial portions of the
21 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
24 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
26 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
32 #include <linux/module.h>
33 #include <linux/kernel.h>
34 #include <linux/pci.h>
35 #include <linux/errno.h>
36 #include <linux/init.h>
37 #include <linux/list.h>
38 #include <linux/sched.h>
39 #include <linux/wait.h>
40 #include <linux/spinlock.h>
41 #include <linux/poll.h>
42 #include <linux/miscdevice.h>
43 #include <linux/slab.h>
45 #include <linux/uaccess.h>
47 #include <linux/vgaarb.h>
49 static void vga_arbiter_notify_clients(void);
51 * We keep a list of all vga devices in the system to speed
52 * up the various operations of the arbiter
55 struct list_head list
;
57 unsigned int decodes
; /* what does it decodes */
58 unsigned int owns
; /* what does it owns */
59 unsigned int locks
; /* what does it locks */
60 unsigned int io_lock_cnt
; /* legacy IO lock count */
61 unsigned int mem_lock_cnt
; /* legacy MEM lock count */
62 unsigned int io_norm_cnt
; /* normal IO count */
63 unsigned int mem_norm_cnt
; /* normal MEM count */
64 bool bridge_has_one_vga
;
65 /* allow IRQ enable/disable hook */
67 void (*irq_set_state
)(void *cookie
, bool enable
);
68 unsigned int (*set_vga_decode
)(void *cookie
, bool decode
);
71 static LIST_HEAD(vga_list
);
72 static int vga_count
, vga_decode_count
;
73 static bool vga_arbiter_used
;
74 static DEFINE_SPINLOCK(vga_lock
);
75 static DECLARE_WAIT_QUEUE_HEAD(vga_wait_queue
);
78 static const char *vga_iostate_to_str(unsigned int iostate
)
80 /* Ignore VGA_RSRC_IO and VGA_RSRC_MEM */
81 iostate
&= VGA_RSRC_LEGACY_IO
| VGA_RSRC_LEGACY_MEM
;
83 case VGA_RSRC_LEGACY_IO
| VGA_RSRC_LEGACY_MEM
:
85 case VGA_RSRC_LEGACY_IO
:
87 case VGA_RSRC_LEGACY_MEM
:
93 static int vga_str_to_iostate(char *buf
, int str_size
, int *io_state
)
95 /* we could in theory hand out locks on IO and mem
96 * separately to userspace but it can cause deadlocks */
97 if (strncmp(buf
, "none", 4) == 0) {
98 *io_state
= VGA_RSRC_NONE
;
102 /* XXX We're not chekcing the str_size! */
103 if (strncmp(buf
, "io+mem", 6) == 0)
105 else if (strncmp(buf
, "io", 2) == 0)
107 else if (strncmp(buf
, "mem", 3) == 0)
111 *io_state
= VGA_RSRC_LEGACY_IO
| VGA_RSRC_LEGACY_MEM
;
115 #ifndef __ARCH_HAS_VGA_DEFAULT_DEVICE
116 /* this is only used a cookie - it should not be dereferenced */
117 static struct pci_dev
*vga_default
;
120 static void vga_arb_device_card_gone(struct pci_dev
*pdev
);
122 /* Find somebody in our list */
123 static struct vga_device
*vgadev_find(struct pci_dev
*pdev
)
125 struct vga_device
*vgadev
;
127 list_for_each_entry(vgadev
, &vga_list
, list
)
128 if (pdev
== vgadev
->pdev
)
133 /* Returns the default VGA device (vgacon's babe) */
134 #ifndef __ARCH_HAS_VGA_DEFAULT_DEVICE
135 struct pci_dev
*vga_default_device(void)
141 static inline void vga_irq_set_state(struct vga_device
*vgadev
, bool state
)
143 if (vgadev
->irq_set_state
)
144 vgadev
->irq_set_state(vgadev
->cookie
, state
);
148 /* If we don't ever use VGA arb we should avoid
149 turning off anything anywhere due to old X servers getting
150 confused about the boot device not being VGA */
151 static void vga_check_first_use(void)
153 /* we should inform all GPUs in the system that
154 * VGA arb has occurred and to try and disable resources
156 if (!vga_arbiter_used
) {
157 vga_arbiter_used
= true;
158 vga_arbiter_notify_clients();
162 static struct vga_device
*__vga_tryget(struct vga_device
*vgadev
,
165 unsigned int wants
, legacy_wants
, match
;
166 struct vga_device
*conflict
;
167 unsigned int pci_bits
;
170 /* Account for "normal" resources to lock. If we decode the legacy,
171 * counterpart, we need to request it as well
173 if ((rsrc
& VGA_RSRC_NORMAL_IO
) &&
174 (vgadev
->decodes
& VGA_RSRC_LEGACY_IO
))
175 rsrc
|= VGA_RSRC_LEGACY_IO
;
176 if ((rsrc
& VGA_RSRC_NORMAL_MEM
) &&
177 (vgadev
->decodes
& VGA_RSRC_LEGACY_MEM
))
178 rsrc
|= VGA_RSRC_LEGACY_MEM
;
180 pr_debug("%s: %d\n", __func__
, rsrc
);
181 pr_debug("%s: owns: %d\n", __func__
, vgadev
->owns
);
183 /* Check what resources we need to acquire */
184 wants
= rsrc
& ~vgadev
->owns
;
186 /* We already own everything, just mark locked & bye bye */
190 /* We don't need to request a legacy resource, we just enable
191 * appropriate decoding and go
193 legacy_wants
= wants
& VGA_RSRC_LEGACY_MASK
;
194 if (legacy_wants
== 0)
197 /* Ok, we don't, let's find out how we need to kick off */
198 list_for_each_entry(conflict
, &vga_list
, list
) {
199 unsigned int lwants
= legacy_wants
;
200 unsigned int change_bridge
= 0;
202 /* Don't conflict with myself */
203 if (vgadev
== conflict
)
206 /* Check if the architecture allows a conflict between those
207 * 2 devices or if they are on separate domains
209 if (!vga_conflicts(vgadev
->pdev
, conflict
->pdev
))
212 /* We have a possible conflict. before we go further, we must
213 * check if we sit on the same bus as the conflicting device.
214 * if we don't, then we must tie both IO and MEM resources
215 * together since there is only a single bit controlling
216 * VGA forwarding on P2P bridges
218 if (vgadev
->pdev
->bus
!= conflict
->pdev
->bus
) {
220 lwants
= VGA_RSRC_LEGACY_IO
| VGA_RSRC_LEGACY_MEM
;
223 /* Check if the guy has a lock on the resource. If he does,
224 * return the conflicting entry
226 if (conflict
->locks
& lwants
)
229 /* Ok, now check if he owns the resource we want. We don't need
230 * to check "decodes" since it should be impossible to own
231 * own legacy resources you don't decode unless I have a bug
234 WARN_ON(conflict
->owns
& ~conflict
->decodes
);
235 match
= lwants
& conflict
->owns
;
239 /* looks like he doesn't have a lock, we can steal
246 if (!conflict
->bridge_has_one_vga
) {
247 vga_irq_set_state(conflict
, false);
248 flags
|= PCI_VGA_STATE_CHANGE_DECODES
;
249 if (lwants
& (VGA_RSRC_LEGACY_MEM
|VGA_RSRC_NORMAL_MEM
))
250 pci_bits
|= PCI_COMMAND_MEMORY
;
251 if (lwants
& (VGA_RSRC_LEGACY_IO
|VGA_RSRC_NORMAL_IO
))
252 pci_bits
|= PCI_COMMAND_IO
;
256 flags
|= PCI_VGA_STATE_CHANGE_BRIDGE
;
258 pci_set_vga_state(conflict
->pdev
, false, pci_bits
, flags
);
259 conflict
->owns
&= ~lwants
;
260 /* If he also owned non-legacy, that is no longer the case */
261 if (lwants
& VGA_RSRC_LEGACY_MEM
)
262 conflict
->owns
&= ~VGA_RSRC_NORMAL_MEM
;
263 if (lwants
& VGA_RSRC_LEGACY_IO
)
264 conflict
->owns
&= ~VGA_RSRC_NORMAL_IO
;
268 /* ok dude, we got it, everybody conflicting has been disabled, let's
269 * enable us. Make sure we don't mark a bit in "owns" that we don't
270 * also have in "decodes". We can lock resources we don't decode but
276 if (!vgadev
->bridge_has_one_vga
) {
277 flags
|= PCI_VGA_STATE_CHANGE_DECODES
;
278 if (wants
& (VGA_RSRC_LEGACY_MEM
|VGA_RSRC_NORMAL_MEM
))
279 pci_bits
|= PCI_COMMAND_MEMORY
;
280 if (wants
& (VGA_RSRC_LEGACY_IO
|VGA_RSRC_NORMAL_IO
))
281 pci_bits
|= PCI_COMMAND_IO
;
283 if (!!(wants
& VGA_RSRC_LEGACY_MASK
))
284 flags
|= PCI_VGA_STATE_CHANGE_BRIDGE
;
286 pci_set_vga_state(vgadev
->pdev
, true, pci_bits
, flags
);
288 if (!vgadev
->bridge_has_one_vga
) {
289 vga_irq_set_state(vgadev
, true);
291 vgadev
->owns
|= (wants
& vgadev
->decodes
);
293 vgadev
->locks
|= (rsrc
& VGA_RSRC_LEGACY_MASK
);
294 if (rsrc
& VGA_RSRC_LEGACY_IO
)
295 vgadev
->io_lock_cnt
++;
296 if (rsrc
& VGA_RSRC_LEGACY_MEM
)
297 vgadev
->mem_lock_cnt
++;
298 if (rsrc
& VGA_RSRC_NORMAL_IO
)
299 vgadev
->io_norm_cnt
++;
300 if (rsrc
& VGA_RSRC_NORMAL_MEM
)
301 vgadev
->mem_norm_cnt
++;
306 static void __vga_put(struct vga_device
*vgadev
, unsigned int rsrc
)
308 unsigned int old_locks
= vgadev
->locks
;
310 pr_debug("%s\n", __func__
);
312 /* Update our counters, and account for equivalent legacy resources
315 if ((rsrc
& VGA_RSRC_NORMAL_IO
) && vgadev
->io_norm_cnt
> 0) {
316 vgadev
->io_norm_cnt
--;
317 if (vgadev
->decodes
& VGA_RSRC_LEGACY_IO
)
318 rsrc
|= VGA_RSRC_LEGACY_IO
;
320 if ((rsrc
& VGA_RSRC_NORMAL_MEM
) && vgadev
->mem_norm_cnt
> 0) {
321 vgadev
->mem_norm_cnt
--;
322 if (vgadev
->decodes
& VGA_RSRC_LEGACY_MEM
)
323 rsrc
|= VGA_RSRC_LEGACY_MEM
;
325 if ((rsrc
& VGA_RSRC_LEGACY_IO
) && vgadev
->io_lock_cnt
> 0)
326 vgadev
->io_lock_cnt
--;
327 if ((rsrc
& VGA_RSRC_LEGACY_MEM
) && vgadev
->mem_lock_cnt
> 0)
328 vgadev
->mem_lock_cnt
--;
330 /* Just clear lock bits, we do lazy operations so we don't really
331 * have to bother about anything else at this point
333 if (vgadev
->io_lock_cnt
== 0)
334 vgadev
->locks
&= ~VGA_RSRC_LEGACY_IO
;
335 if (vgadev
->mem_lock_cnt
== 0)
336 vgadev
->locks
&= ~VGA_RSRC_LEGACY_MEM
;
338 /* Kick the wait queue in case somebody was waiting if we actually
341 if (old_locks
!= vgadev
->locks
)
342 wake_up_all(&vga_wait_queue
);
345 int vga_get(struct pci_dev
*pdev
, unsigned int rsrc
, int interruptible
)
347 struct vga_device
*vgadev
, *conflict
;
352 vga_check_first_use();
353 /* The one who calls us should check for this, but lets be sure... */
355 pdev
= vga_default_device();
360 spin_lock_irqsave(&vga_lock
, flags
);
361 vgadev
= vgadev_find(pdev
);
362 if (vgadev
== NULL
) {
363 spin_unlock_irqrestore(&vga_lock
, flags
);
367 conflict
= __vga_tryget(vgadev
, rsrc
);
368 spin_unlock_irqrestore(&vga_lock
, flags
);
369 if (conflict
== NULL
)
373 /* We have a conflict, we wait until somebody kicks the
374 * work queue. Currently we have one work queue that we
375 * kick each time some resources are released, but it would
376 * be fairly easy to have a per device one so that we only
377 * need to attach to the conflicting device
379 init_waitqueue_entry(&wait
, current
);
380 add_wait_queue(&vga_wait_queue
, &wait
);
381 set_current_state(interruptible
?
383 TASK_UNINTERRUPTIBLE
);
384 if (signal_pending(current
)) {
389 remove_wait_queue(&vga_wait_queue
, &wait
);
390 set_current_state(TASK_RUNNING
);
394 EXPORT_SYMBOL(vga_get
);
396 int vga_tryget(struct pci_dev
*pdev
, unsigned int rsrc
)
398 struct vga_device
*vgadev
;
402 vga_check_first_use();
404 /* The one who calls us should check for this, but lets be sure... */
406 pdev
= vga_default_device();
409 spin_lock_irqsave(&vga_lock
, flags
);
410 vgadev
= vgadev_find(pdev
);
411 if (vgadev
== NULL
) {
415 if (__vga_tryget(vgadev
, rsrc
))
418 spin_unlock_irqrestore(&vga_lock
, flags
);
421 EXPORT_SYMBOL(vga_tryget
);
423 void vga_put(struct pci_dev
*pdev
, unsigned int rsrc
)
425 struct vga_device
*vgadev
;
428 /* The one who calls us should check for this, but lets be sure... */
430 pdev
= vga_default_device();
433 spin_lock_irqsave(&vga_lock
, flags
);
434 vgadev
= vgadev_find(pdev
);
437 __vga_put(vgadev
, rsrc
);
439 spin_unlock_irqrestore(&vga_lock
, flags
);
441 EXPORT_SYMBOL(vga_put
);
443 /* Rules for using a bridge to control a VGA descendant decoding:
444 if a bridge has only one VGA descendant then it can be used
445 to control the VGA routing for that device.
446 It should always use the bridge closest to the device to control it.
447 If a bridge has a direct VGA descendant, but also have a sub-bridge
448 VGA descendant then we cannot use that bridge to control the direct VGA descendant.
449 So for every device we register, we need to iterate all its parent bridges
450 so we can invalidate any devices using them properly.
452 static void vga_arbiter_check_bridge_sharing(struct vga_device
*vgadev
)
454 struct vga_device
*same_bridge_vgadev
;
455 struct pci_bus
*new_bus
, *bus
;
456 struct pci_dev
*new_bridge
, *bridge
;
458 vgadev
->bridge_has_one_vga
= true;
460 if (list_empty(&vga_list
))
463 /* okay iterate the new devices bridge hierarachy */
464 new_bus
= vgadev
->pdev
->bus
;
466 new_bridge
= new_bus
->self
;
469 /* go through list of devices already registered */
470 list_for_each_entry(same_bridge_vgadev
, &vga_list
, list
) {
471 bus
= same_bridge_vgadev
->pdev
->bus
;
474 /* see if the share a bridge with this device */
475 if (new_bridge
== bridge
) {
476 /* if their direct parent bridge is the same
477 as any bridge of this device then it can't be used
479 same_bridge_vgadev
->bridge_has_one_vga
= false;
482 /* now iterate the previous devices bridge hierarchy */
483 /* if the new devices parent bridge is in the other devices
484 hierarchy then we can't use it to control this device */
488 if (bridge
== vgadev
->pdev
->bus
->self
)
489 vgadev
->bridge_has_one_vga
= false;
495 new_bus
= new_bus
->parent
;
500 * Currently, we assume that the "initial" setup of the system is
501 * not sane, that is we come up with conflicting devices and let
502 * the arbiter's client decides if devices decodes or not legacy
505 static bool vga_arbiter_add_pci_device(struct pci_dev
*pdev
)
507 struct vga_device
*vgadev
;
510 struct pci_dev
*bridge
;
513 /* Only deal with VGA class devices */
514 if ((pdev
->class >> 8) != PCI_CLASS_DISPLAY_VGA
)
517 /* Allocate structure */
518 vgadev
= kmalloc(sizeof(struct vga_device
), GFP_KERNEL
);
519 if (vgadev
== NULL
) {
520 pr_err("vgaarb: failed to allocate pci device\n");
521 /* What to do on allocation failure ? For now, let's
522 * just do nothing, I'm not sure there is anything saner
528 memset(vgadev
, 0, sizeof(*vgadev
));
530 /* Take lock & check for duplicates */
531 spin_lock_irqsave(&vga_lock
, flags
);
532 if (vgadev_find(pdev
) != NULL
) {
538 /* By default, assume we decode everything */
539 vgadev
->decodes
= VGA_RSRC_LEGACY_IO
| VGA_RSRC_LEGACY_MEM
|
540 VGA_RSRC_NORMAL_IO
| VGA_RSRC_NORMAL_MEM
;
542 /* by default mark it as decoding */
544 /* Mark that we "own" resources based on our enables, we will
545 * clear that below if the bridge isn't forwarding
547 pci_read_config_word(pdev
, PCI_COMMAND
, &cmd
);
548 if (cmd
& PCI_COMMAND_IO
)
549 vgadev
->owns
|= VGA_RSRC_LEGACY_IO
;
550 if (cmd
& PCI_COMMAND_MEMORY
)
551 vgadev
->owns
|= VGA_RSRC_LEGACY_MEM
;
553 /* Check if VGA cycles can get down to us */
559 pci_read_config_word(bridge
, PCI_BRIDGE_CONTROL
,
561 if (!(l
& PCI_BRIDGE_CTL_VGA
)) {
569 /* Deal with VGA default device. Use first enabled one
570 * by default if arch doesn't have it's own hook
572 #ifndef __ARCH_HAS_VGA_DEFAULT_DEVICE
573 if (vga_default
== NULL
&&
574 ((vgadev
->owns
& VGA_RSRC_LEGACY_MASK
) == VGA_RSRC_LEGACY_MASK
))
575 vga_default
= pci_dev_get(pdev
);
578 vga_arbiter_check_bridge_sharing(vgadev
);
580 /* Add to the list */
581 list_add(&vgadev
->list
, &vga_list
);
583 pr_info("vgaarb: device added: PCI:%s,decodes=%s,owns=%s,locks=%s\n",
585 vga_iostate_to_str(vgadev
->decodes
),
586 vga_iostate_to_str(vgadev
->owns
),
587 vga_iostate_to_str(vgadev
->locks
));
589 spin_unlock_irqrestore(&vga_lock
, flags
);
592 spin_unlock_irqrestore(&vga_lock
, flags
);
597 static bool vga_arbiter_del_pci_device(struct pci_dev
*pdev
)
599 struct vga_device
*vgadev
;
603 spin_lock_irqsave(&vga_lock
, flags
);
604 vgadev
= vgadev_find(pdev
);
605 if (vgadev
== NULL
) {
610 if (vga_default
== pdev
) {
611 pci_dev_put(vga_default
);
615 if (vgadev
->decodes
& (VGA_RSRC_LEGACY_IO
| VGA_RSRC_LEGACY_MEM
))
618 /* Remove entry from list */
619 list_del(&vgadev
->list
);
621 /* Notify userland driver that the device is gone so it discards
622 * it's copies of the pci_dev pointer
624 vga_arb_device_card_gone(pdev
);
626 /* Wake up all possible waiters */
627 wake_up_all(&vga_wait_queue
);
629 spin_unlock_irqrestore(&vga_lock
, flags
);
634 /* this is called with the lock */
635 static inline void vga_update_device_decodes(struct vga_device
*vgadev
,
639 struct vga_device
*new_vgadev
, *conflict
;
641 old_decodes
= vgadev
->decodes
;
642 vgadev
->decodes
= new_decodes
;
644 pr_info("vgaarb: device changed decodes: PCI:%s,olddecodes=%s,decodes=%s:owns=%s\n",
645 pci_name(vgadev
->pdev
),
646 vga_iostate_to_str(old_decodes
),
647 vga_iostate_to_str(vgadev
->decodes
),
648 vga_iostate_to_str(vgadev
->owns
));
651 /* if we own the decodes we should move them along to
653 if ((vgadev
->owns
& old_decodes
) && (vga_count
> 1)) {
654 /* set us to own nothing */
655 vgadev
->owns
&= ~old_decodes
;
656 list_for_each_entry(new_vgadev
, &vga_list
, list
) {
657 if ((new_vgadev
!= vgadev
) &&
658 (new_vgadev
->decodes
& VGA_RSRC_LEGACY_MASK
)) {
659 pr_info("vgaarb: transferring owner from PCI:%s to PCI:%s\n", pci_name(vgadev
->pdev
), pci_name(new_vgadev
->pdev
));
660 conflict
= __vga_tryget(new_vgadev
, VGA_RSRC_LEGACY_MASK
);
662 __vga_put(new_vgadev
, VGA_RSRC_LEGACY_MASK
);
668 /* change decodes counter */
669 if (old_decodes
!= new_decodes
) {
670 if (new_decodes
& (VGA_RSRC_LEGACY_IO
| VGA_RSRC_LEGACY_MEM
))
675 pr_debug("vgaarb: decoding count now is: %d\n", vga_decode_count
);
678 static void __vga_set_legacy_decoding(struct pci_dev
*pdev
, unsigned int decodes
, bool userspace
)
680 struct vga_device
*vgadev
;
683 decodes
&= VGA_RSRC_LEGACY_MASK
;
685 spin_lock_irqsave(&vga_lock
, flags
);
686 vgadev
= vgadev_find(pdev
);
690 /* don't let userspace futz with kernel driver decodes */
691 if (userspace
&& vgadev
->set_vga_decode
)
694 /* update the device decodes + counter */
695 vga_update_device_decodes(vgadev
, decodes
);
697 /* XXX if somebody is going from "doesn't decode" to "decodes" state
698 * here, additional care must be taken as we may have pending owner
699 * ship of non-legacy region ...
702 spin_unlock_irqrestore(&vga_lock
, flags
);
705 void vga_set_legacy_decoding(struct pci_dev
*pdev
, unsigned int decodes
)
707 __vga_set_legacy_decoding(pdev
, decodes
, false);
709 EXPORT_SYMBOL(vga_set_legacy_decoding
);
711 /* call with NULL to unregister */
712 int vga_client_register(struct pci_dev
*pdev
, void *cookie
,
713 void (*irq_set_state
)(void *cookie
, bool state
),
714 unsigned int (*set_vga_decode
)(void *cookie
, bool decode
))
717 struct vga_device
*vgadev
;
720 spin_lock_irqsave(&vga_lock
, flags
);
721 vgadev
= vgadev_find(pdev
);
725 vgadev
->irq_set_state
= irq_set_state
;
726 vgadev
->set_vga_decode
= set_vga_decode
;
727 vgadev
->cookie
= cookie
;
731 spin_unlock_irqrestore(&vga_lock
, flags
);
735 EXPORT_SYMBOL(vga_client_register
);
738 * Char driver implementation
742 * open : open user instance of the arbitrer. by default, it's
743 * attached to the default VGA device of the system.
745 * close : close user instance, release locks
747 * read : return a string indicating the status of the target.
748 * an IO state string is of the form {io,mem,io+mem,none},
749 * mc and ic are respectively mem and io lock counts (for
750 * debugging/diagnostic only). "decodes" indicate what the
751 * card currently decodes, "owns" indicates what is currently
752 * enabled on it, and "locks" indicates what is locked by this
753 * card. If the card is unplugged, we get "invalid" then for
754 * card_ID and an -ENODEV error is returned for any command
755 * until a new card is targeted
757 * "<card_ID>,decodes=<io_state>,owns=<io_state>,locks=<io_state> (ic,mc)"
759 * write : write a command to the arbiter. List of commands is:
761 * target <card_ID> : switch target to card <card_ID> (see below)
762 * lock <io_state> : acquires locks on target ("none" is invalid io_state)
763 * trylock <io_state> : non-blocking acquire locks on target
764 * unlock <io_state> : release locks on target
765 * unlock all : release all locks on target held by this user
766 * decodes <io_state> : set the legacy decoding attributes for the card
768 * poll : event if something change on any card (not just the target)
770 * card_ID is of the form "PCI:domain:bus:dev.fn". It can be set to "default"
771 * to go back to the system default card (TODO: not implemented yet).
772 * Currently, only PCI is supported as a prefix, but the userland API may
773 * support other bus types in the future, even if the current kernel
774 * implementation doesn't.
778 * The driver keeps track of which user has what locks on which card. It
779 * supports stacking, like the kernel one. This complexifies the implementation
780 * a bit, but makes the arbiter more tolerant to userspace problems and able
781 * to properly cleanup in all cases when a process dies.
782 * Currently, a max of 16 cards simultaneously can have locks issued from
783 * userspace for a given user (file descriptor instance) of the arbiter.
785 * If the device is hot-unplugged, there is a hook inside the module to notify
786 * they being added/removed in the system and automatically added/removed in
790 #define MAX_USER_CARDS CONFIG_VGA_ARB_MAX_GPUS
791 #define PCI_INVALID_CARD ((struct pci_dev *)-1UL)
794 * Each user has an array of these, tracking which cards have locks
796 struct vga_arb_user_card
{
797 struct pci_dev
*pdev
;
798 unsigned int mem_cnt
;
802 struct vga_arb_private
{
803 struct list_head list
;
804 struct pci_dev
*target
;
805 struct vga_arb_user_card cards
[MAX_USER_CARDS
];
809 static LIST_HEAD(vga_user_list
);
810 static DEFINE_SPINLOCK(vga_user_lock
);
814 * This function gets a string in the format: "PCI:domain:bus:dev.fn" and
815 * returns the respective values. If the string is not in this format,
818 static int vga_pci_str_to_vars(char *buf
, int count
, unsigned int *domain
,
819 unsigned int *bus
, unsigned int *devfn
)
822 unsigned int slot
, func
;
825 n
= sscanf(buf
, "PCI:%x:%x:%x.%x", domain
, bus
, &slot
, &func
);
829 *devfn
= PCI_DEVFN(slot
, func
);
834 static ssize_t
vga_arb_read(struct file
*file
, char __user
* buf
,
835 size_t count
, loff_t
*ppos
)
837 struct vga_arb_private
*priv
= file
->private_data
;
838 struct vga_device
*vgadev
;
839 struct pci_dev
*pdev
;
845 lbuf
= kmalloc(1024, GFP_KERNEL
);
849 /* Shields against vga_arb_device_card_gone (pci_dev going
850 * away), and allows access to vga list
852 spin_lock_irqsave(&vga_lock
, flags
);
854 /* If we are targeting the default, use it */
856 if (pdev
== NULL
|| pdev
== PCI_INVALID_CARD
) {
857 spin_unlock_irqrestore(&vga_lock
, flags
);
858 len
= sprintf(lbuf
, "invalid");
862 /* Find card vgadev structure */
863 vgadev
= vgadev_find(pdev
);
864 if (vgadev
== NULL
) {
865 /* Wow, it's not in the list, that shouldn't happen,
866 * let's fix us up and return invalid card
868 if (pdev
== priv
->target
)
869 vga_arb_device_card_gone(pdev
);
870 spin_unlock_irqrestore(&vga_lock
, flags
);
871 len
= sprintf(lbuf
, "invalid");
875 /* Fill the buffer with infos */
876 len
= snprintf(lbuf
, 1024,
877 "count:%d,PCI:%s,decodes=%s,owns=%s,locks=%s(%d:%d)\n",
878 vga_decode_count
, pci_name(pdev
),
879 vga_iostate_to_str(vgadev
->decodes
),
880 vga_iostate_to_str(vgadev
->owns
),
881 vga_iostate_to_str(vgadev
->locks
),
882 vgadev
->io_lock_cnt
, vgadev
->mem_lock_cnt
);
884 spin_unlock_irqrestore(&vga_lock
, flags
);
887 /* Copy that to user */
890 rc
= copy_to_user(buf
, lbuf
, len
);
898 * TODO: To avoid parsing inside kernel and to improve the speed we may
899 * consider use ioctl here
901 static ssize_t
vga_arb_write(struct file
*file
, const char __user
* buf
,
902 size_t count
, loff_t
*ppos
)
904 struct vga_arb_private
*priv
= file
->private_data
;
905 struct vga_arb_user_card
*uc
= NULL
;
906 struct pci_dev
*pdev
;
908 unsigned int io_state
;
910 char *kbuf
, *curr_pos
;
911 size_t remaining
= count
;
917 kbuf
= kmalloc(count
+ 1, GFP_KERNEL
);
921 if (copy_from_user(kbuf
, buf
, count
)) {
926 kbuf
[count
] = '\0'; /* Just to make sure... */
928 if (strncmp(curr_pos
, "lock ", 5) == 0) {
932 pr_debug("client 0x%p called 'lock'\n", priv
);
934 if (!vga_str_to_iostate(curr_pos
, remaining
, &io_state
)) {
938 if (io_state
== VGA_RSRC_NONE
) {
944 if (priv
->target
== NULL
) {
949 vga_get_uninterruptible(pdev
, io_state
);
951 /* Update the client's locks lists... */
952 for (i
= 0; i
< MAX_USER_CARDS
; i
++) {
953 if (priv
->cards
[i
].pdev
== pdev
) {
954 if (io_state
& VGA_RSRC_LEGACY_IO
)
955 priv
->cards
[i
].io_cnt
++;
956 if (io_state
& VGA_RSRC_LEGACY_MEM
)
957 priv
->cards
[i
].mem_cnt
++;
964 } else if (strncmp(curr_pos
, "unlock ", 7) == 0) {
968 pr_debug("client 0x%p called 'unlock'\n", priv
);
970 if (strncmp(curr_pos
, "all", 3) == 0)
971 io_state
= VGA_RSRC_LEGACY_IO
| VGA_RSRC_LEGACY_MEM
;
973 if (!vga_str_to_iostate
974 (curr_pos
, remaining
, &io_state
)) {
979 if (io_state == VGA_RSRC_NONE) {
987 if (priv
->target
== NULL
) {
991 for (i
= 0; i
< MAX_USER_CARDS
; i
++) {
992 if (priv
->cards
[i
].pdev
== pdev
)
993 uc
= &priv
->cards
[i
];
999 if (io_state
& VGA_RSRC_LEGACY_IO
&& uc
->io_cnt
== 0)
1002 if (io_state
& VGA_RSRC_LEGACY_MEM
&& uc
->mem_cnt
== 0)
1005 vga_put(pdev
, io_state
);
1007 if (io_state
& VGA_RSRC_LEGACY_IO
)
1009 if (io_state
& VGA_RSRC_LEGACY_MEM
)
1014 } else if (strncmp(curr_pos
, "trylock ", 8) == 0) {
1018 pr_debug("client 0x%p called 'trylock'\n", priv
);
1020 if (!vga_str_to_iostate(curr_pos
, remaining
, &io_state
)) {
1025 if (io_state == VGA_RSRC_NONE) {
1031 pdev
= priv
->target
;
1032 if (priv
->target
== NULL
) {
1037 if (vga_tryget(pdev
, io_state
)) {
1038 /* Update the client's locks lists... */
1039 for (i
= 0; i
< MAX_USER_CARDS
; i
++) {
1040 if (priv
->cards
[i
].pdev
== pdev
) {
1041 if (io_state
& VGA_RSRC_LEGACY_IO
)
1042 priv
->cards
[i
].io_cnt
++;
1043 if (io_state
& VGA_RSRC_LEGACY_MEM
)
1044 priv
->cards
[i
].mem_cnt
++;
1055 } else if (strncmp(curr_pos
, "target ", 7) == 0) {
1056 struct pci_bus
*pbus
;
1057 unsigned int domain
, bus
, devfn
;
1058 struct vga_device
*vgadev
;
1062 pr_debug("client 0x%p called 'target'\n", priv
);
1063 /* if target is default */
1064 if (!strncmp(curr_pos
, "default", 7))
1065 pdev
= pci_dev_get(vga_default_device());
1067 if (!vga_pci_str_to_vars(curr_pos
, remaining
,
1068 &domain
, &bus
, &devfn
)) {
1072 pr_debug("vgaarb: %s ==> %x:%x:%x.%x\n", curr_pos
,
1073 domain
, bus
, PCI_SLOT(devfn
), PCI_FUNC(devfn
));
1075 pbus
= pci_find_bus(domain
, bus
);
1076 pr_debug("vgaarb: pbus %p\n", pbus
);
1078 pr_err("vgaarb: invalid PCI domain and/or bus address %x:%x\n",
1083 pdev
= pci_get_slot(pbus
, devfn
);
1084 pr_debug("vgaarb: pdev %p\n", pdev
);
1086 pr_err("vgaarb: invalid PCI address %x:%x\n",
1093 vgadev
= vgadev_find(pdev
);
1094 pr_debug("vgaarb: vgadev %p\n", vgadev
);
1095 if (vgadev
== NULL
) {
1096 pr_err("vgaarb: this pci device is not a vga device\n");
1102 priv
->target
= pdev
;
1103 for (i
= 0; i
< MAX_USER_CARDS
; i
++) {
1104 if (priv
->cards
[i
].pdev
== pdev
)
1106 if (priv
->cards
[i
].pdev
== NULL
) {
1107 priv
->cards
[i
].pdev
= pdev
;
1108 priv
->cards
[i
].io_cnt
= 0;
1109 priv
->cards
[i
].mem_cnt
= 0;
1113 if (i
== MAX_USER_CARDS
) {
1114 pr_err("vgaarb: maximum user cards (%d) number reached!\n",
1117 /* XXX: which value to return? */
1127 } else if (strncmp(curr_pos
, "decodes ", 8) == 0) {
1130 pr_debug("vgaarb: client 0x%p called 'decodes'\n", priv
);
1132 if (!vga_str_to_iostate(curr_pos
, remaining
, &io_state
)) {
1136 pdev
= priv
->target
;
1137 if (priv
->target
== NULL
) {
1142 __vga_set_legacy_decoding(pdev
, io_state
, true);
1146 /* If we got here, the message written is not part of the protocol! */
1155 static unsigned int vga_arb_fpoll(struct file
*file
, poll_table
* wait
)
1157 struct vga_arb_private
*priv
= file
->private_data
;
1159 pr_debug("%s\n", __func__
);
1163 poll_wait(file
, &vga_wait_queue
, wait
);
1167 static int vga_arb_open(struct inode
*inode
, struct file
*file
)
1169 struct vga_arb_private
*priv
;
1170 unsigned long flags
;
1172 pr_debug("%s\n", __func__
);
1174 priv
= kmalloc(sizeof(struct vga_arb_private
), GFP_KERNEL
);
1177 memset(priv
, 0, sizeof(*priv
));
1178 spin_lock_init(&priv
->lock
);
1179 file
->private_data
= priv
;
1181 spin_lock_irqsave(&vga_user_lock
, flags
);
1182 list_add(&priv
->list
, &vga_user_list
);
1183 spin_unlock_irqrestore(&vga_user_lock
, flags
);
1185 /* Set the client' lists of locks */
1186 priv
->target
= vga_default_device(); /* Maybe this is still null! */
1187 priv
->cards
[0].pdev
= priv
->target
;
1188 priv
->cards
[0].io_cnt
= 0;
1189 priv
->cards
[0].mem_cnt
= 0;
1195 static int vga_arb_release(struct inode
*inode
, struct file
*file
)
1197 struct vga_arb_private
*priv
= file
->private_data
;
1198 struct vga_arb_user_card
*uc
;
1199 unsigned long flags
;
1202 pr_debug("%s\n", __func__
);
1207 spin_lock_irqsave(&vga_user_lock
, flags
);
1208 list_del(&priv
->list
);
1209 for (i
= 0; i
< MAX_USER_CARDS
; i
++) {
1210 uc
= &priv
->cards
[i
];
1211 if (uc
->pdev
== NULL
)
1213 pr_debug("uc->io_cnt == %d, uc->mem_cnt == %d\n",
1214 uc
->io_cnt
, uc
->mem_cnt
);
1215 while (uc
->io_cnt
--)
1216 vga_put(uc
->pdev
, VGA_RSRC_LEGACY_IO
);
1217 while (uc
->mem_cnt
--)
1218 vga_put(uc
->pdev
, VGA_RSRC_LEGACY_MEM
);
1220 spin_unlock_irqrestore(&vga_user_lock
, flags
);
1227 static void vga_arb_device_card_gone(struct pci_dev
*pdev
)
1232 * callback any registered clients to let them know we have a
1233 * change in VGA cards
1235 static void vga_arbiter_notify_clients(void)
1237 struct vga_device
*vgadev
;
1238 unsigned long flags
;
1239 uint32_t new_decodes
;
1242 if (!vga_arbiter_used
)
1245 spin_lock_irqsave(&vga_lock
, flags
);
1246 list_for_each_entry(vgadev
, &vga_list
, list
) {
1251 if (vgadev
->set_vga_decode
) {
1252 new_decodes
= vgadev
->set_vga_decode(vgadev
->cookie
, new_state
);
1253 vga_update_device_decodes(vgadev
, new_decodes
);
1256 spin_unlock_irqrestore(&vga_lock
, flags
);
1259 static int pci_notify(struct notifier_block
*nb
, unsigned long action
,
1262 struct device
*dev
= data
;
1263 struct pci_dev
*pdev
= to_pci_dev(dev
);
1264 bool notify
= false;
1266 pr_debug("%s\n", __func__
);
1268 /* For now we're only intereted in devices added and removed. I didn't
1269 * test this thing here, so someone needs to double check for the
1270 * cases of hotplugable vga cards. */
1271 if (action
== BUS_NOTIFY_ADD_DEVICE
)
1272 notify
= vga_arbiter_add_pci_device(pdev
);
1273 else if (action
== BUS_NOTIFY_DEL_DEVICE
)
1274 notify
= vga_arbiter_del_pci_device(pdev
);
1277 vga_arbiter_notify_clients();
1281 static struct notifier_block pci_notifier
= {
1282 .notifier_call
= pci_notify
,
1285 static const struct file_operations vga_arb_device_fops
= {
1286 .read
= vga_arb_read
,
1287 .write
= vga_arb_write
,
1288 .poll
= vga_arb_fpoll
,
1289 .open
= vga_arb_open
,
1290 .release
= vga_arb_release
,
1291 .llseek
= noop_llseek
,
1294 static struct miscdevice vga_arb_device
= {
1295 MISC_DYNAMIC_MINOR
, "vga_arbiter", &vga_arb_device_fops
1298 static int __init
vga_arb_device_init(void)
1301 struct pci_dev
*pdev
;
1302 struct vga_device
*vgadev
;
1304 rc
= misc_register(&vga_arb_device
);
1306 pr_err("vgaarb: error %d registering device\n", rc
);
1308 bus_register_notifier(&pci_bus_type
, &pci_notifier
);
1310 /* We add all pci devices satisfying vga class in the arbiter by
1314 pci_get_subsys(PCI_ANY_ID
, PCI_ANY_ID
, PCI_ANY_ID
,
1315 PCI_ANY_ID
, pdev
)) != NULL
)
1316 vga_arbiter_add_pci_device(pdev
);
1318 pr_info("vgaarb: loaded\n");
1320 list_for_each_entry(vgadev
, &vga_list
, list
) {
1321 if (vgadev
->bridge_has_one_vga
)
1322 pr_info("vgaarb: bridge control possible %s\n", pci_name(vgadev
->pdev
));
1324 pr_info("vgaarb: no bridge control possible %s\n", pci_name(vgadev
->pdev
));
1328 subsys_initcall(vga_arb_device_init
);