1 /* SPDX-License-Identifier: GPL-2.0 */
3 * vboxguest linux pci driver, char-dev and input-device code,
5 * Copyright (C) 2006-2016 Oracle Corporation
8 #include <linux/input.h>
9 #include <linux/kernel.h>
10 #include <linux/miscdevice.h>
11 #include <linux/module.h>
12 #include <linux/pci.h>
13 #include <linux/poll.h>
14 #include <linux/vbox_utils.h>
15 #include "vboxguest_core.h"
17 /** The device name. */
18 #define DEVICE_NAME "vboxguest"
19 /** The device name for the device node open to everyone. */
20 #define DEVICE_NAME_USER "vboxuser"
21 /** VirtualBox PCI vendor ID. */
22 #define VBOX_VENDORID 0x80ee
23 /** VMMDev PCI card product ID. */
24 #define VMMDEV_DEVICEID 0xcafe
26 /** Mutex protecting the global vbg_gdev pointer used by vbg_get/put_gdev. */
27 static DEFINE_MUTEX(vbg_gdev_mutex
);
28 /** Global vbg_gdev pointer used by vbg_get/put_gdev. */
29 static struct vbg_dev
*vbg_gdev
;
31 static int vbg_misc_device_open(struct inode
*inode
, struct file
*filp
)
33 struct vbg_session
*session
;
36 /* misc_open sets filp->private_data to our misc device */
37 gdev
= container_of(filp
->private_data
, struct vbg_dev
, misc_device
);
39 session
= vbg_core_open_session(gdev
, false);
41 return PTR_ERR(session
);
43 filp
->private_data
= session
;
47 static int vbg_misc_device_user_open(struct inode
*inode
, struct file
*filp
)
49 struct vbg_session
*session
;
52 /* misc_open sets filp->private_data to our misc device */
53 gdev
= container_of(filp
->private_data
, struct vbg_dev
,
56 session
= vbg_core_open_session(gdev
, false);
58 return PTR_ERR(session
);
60 filp
->private_data
= session
;
66 * Return: 0 on success, negated errno on failure.
67 * @inode: Pointer to inode info structure.
68 * @filp: Associated file pointer.
70 static int vbg_misc_device_close(struct inode
*inode
, struct file
*filp
)
72 vbg_core_close_session(filp
->private_data
);
73 filp
->private_data
= NULL
;
78 * Device I/O Control entry point.
79 * Return: 0 on success, negated errno on failure.
80 * @filp: Associated file pointer.
81 * @req: The request specified to ioctl().
82 * @arg: The argument specified to ioctl().
84 static long vbg_misc_device_ioctl(struct file
*filp
, unsigned int req
,
87 struct vbg_session
*session
= filp
->private_data
;
88 size_t returned_size
, size
;
89 struct vbg_ioctl_hdr hdr
;
94 if (copy_from_user(&hdr
, (void *)arg
, sizeof(hdr
)))
97 if (hdr
.version
!= VBG_IOCTL_HDR_VERSION
)
100 if (hdr
.size_in
< sizeof(hdr
) ||
101 (hdr
.size_out
&& hdr
.size_out
< sizeof(hdr
)))
104 size
= max(hdr
.size_in
, hdr
.size_out
);
105 if (_IOC_SIZE(req
) && _IOC_SIZE(req
) != size
)
111 * IOCTL_VMMDEV_REQUEST needs the buffer to be below 4G to avoid
112 * the need for a bounce-buffer and another copy later on.
114 is_vmmdev_req
= (req
& ~IOCSIZE_MASK
) == VBG_IOCTL_VMMDEV_REQUEST(0) ||
115 req
== VBG_IOCTL_VMMDEV_REQUEST_BIG
;
118 buf
= vbg_req_alloc(size
, VBG_IOCTL_HDR_TYPE_DEFAULT
);
120 buf
= kmalloc(size
, GFP_KERNEL
);
124 if (copy_from_user(buf
, (void *)arg
, hdr
.size_in
)) {
128 if (hdr
.size_in
< size
)
129 memset(buf
+ hdr
.size_in
, 0, size
- hdr
.size_in
);
131 ret
= vbg_core_ioctl(session
, req
, buf
);
135 returned_size
= ((struct vbg_ioctl_hdr
*)buf
)->size_out
;
136 if (returned_size
> size
) {
137 vbg_debug("%s: too much output data %zu > %zu\n",
138 __func__
, returned_size
, size
);
139 returned_size
= size
;
141 if (copy_to_user((void *)arg
, buf
, returned_size
) != 0)
146 vbg_req_free(buf
, size
);
153 /** The file_operations structures. */
154 static const struct file_operations vbg_misc_device_fops
= {
155 .owner
= THIS_MODULE
,
156 .open
= vbg_misc_device_open
,
157 .release
= vbg_misc_device_close
,
158 .unlocked_ioctl
= vbg_misc_device_ioctl
,
160 .compat_ioctl
= vbg_misc_device_ioctl
,
163 static const struct file_operations vbg_misc_device_user_fops
= {
164 .owner
= THIS_MODULE
,
165 .open
= vbg_misc_device_user_open
,
166 .release
= vbg_misc_device_close
,
167 .unlocked_ioctl
= vbg_misc_device_ioctl
,
169 .compat_ioctl
= vbg_misc_device_ioctl
,
174 * Called when the input device is first opened.
176 * Sets up absolute mouse reporting.
178 static int vbg_input_open(struct input_dev
*input
)
180 struct vbg_dev
*gdev
= input_get_drvdata(input
);
181 u32 feat
= VMMDEV_MOUSE_GUEST_CAN_ABSOLUTE
| VMMDEV_MOUSE_NEW_PROTOCOL
;
184 ret
= vbg_core_set_mouse_status(gdev
, feat
);
192 * Called if all open handles to the input device are closed.
194 * Disables absolute reporting.
196 static void vbg_input_close(struct input_dev
*input
)
198 struct vbg_dev
*gdev
= input_get_drvdata(input
);
200 vbg_core_set_mouse_status(gdev
, 0);
204 * Creates the kernel input device.
206 * Return: 0 on success, negated errno on failure.
208 static int vbg_create_input_device(struct vbg_dev
*gdev
)
210 struct input_dev
*input
;
212 input
= devm_input_allocate_device(gdev
->dev
);
216 input
->id
.bustype
= BUS_PCI
;
217 input
->id
.vendor
= VBOX_VENDORID
;
218 input
->id
.product
= VMMDEV_DEVICEID
;
219 input
->open
= vbg_input_open
;
220 input
->close
= vbg_input_close
;
221 input
->dev
.parent
= gdev
->dev
;
222 input
->name
= "VirtualBox mouse integration";
224 input_set_abs_params(input
, ABS_X
, VMMDEV_MOUSE_RANGE_MIN
,
225 VMMDEV_MOUSE_RANGE_MAX
, 0, 0);
226 input_set_abs_params(input
, ABS_Y
, VMMDEV_MOUSE_RANGE_MIN
,
227 VMMDEV_MOUSE_RANGE_MAX
, 0, 0);
228 input_set_capability(input
, EV_KEY
, BTN_MOUSE
);
229 input_set_drvdata(input
, gdev
);
233 return input_register_device(gdev
->input
);
236 static ssize_t
host_version_show(struct device
*dev
,
237 struct device_attribute
*attr
, char *buf
)
239 struct vbg_dev
*gdev
= dev_get_drvdata(dev
);
241 return sprintf(buf
, "%s\n", gdev
->host_version
);
244 static ssize_t
host_features_show(struct device
*dev
,
245 struct device_attribute
*attr
, char *buf
)
247 struct vbg_dev
*gdev
= dev_get_drvdata(dev
);
249 return sprintf(buf
, "%#x\n", gdev
->host_features
);
252 static DEVICE_ATTR_RO(host_version
);
253 static DEVICE_ATTR_RO(host_features
);
256 * Does the PCI detection and init of the device.
258 * Return: 0 on success, negated errno on failure.
260 static int vbg_pci_probe(struct pci_dev
*pci
, const struct pci_device_id
*id
)
262 struct device
*dev
= &pci
->dev
;
263 resource_size_t io
, io_len
, mmio
, mmio_len
;
264 struct vmmdev_memory
*vmmdev
;
265 struct vbg_dev
*gdev
;
268 gdev
= devm_kzalloc(dev
, sizeof(*gdev
), GFP_KERNEL
);
272 ret
= pci_enable_device(pci
);
274 vbg_err("vboxguest: Error enabling device: %d\n", ret
);
280 io
= pci_resource_start(pci
, 0);
281 io_len
= pci_resource_len(pci
, 0);
282 if (!io
|| !io_len
) {
283 vbg_err("vboxguest: Error IO-port resource (0) is missing\n");
284 goto err_disable_pcidev
;
286 if (devm_request_region(dev
, io
, io_len
, DEVICE_NAME
) == NULL
) {
287 vbg_err("vboxguest: Error could not claim IO resource\n");
289 goto err_disable_pcidev
;
292 mmio
= pci_resource_start(pci
, 1);
293 mmio_len
= pci_resource_len(pci
, 1);
294 if (!mmio
|| !mmio_len
) {
295 vbg_err("vboxguest: Error MMIO resource (1) is missing\n");
296 goto err_disable_pcidev
;
299 if (devm_request_mem_region(dev
, mmio
, mmio_len
, DEVICE_NAME
) == NULL
) {
300 vbg_err("vboxguest: Error could not claim MMIO resource\n");
302 goto err_disable_pcidev
;
305 vmmdev
= devm_ioremap(dev
, mmio
, mmio_len
);
307 vbg_err("vboxguest: Error ioremap failed; MMIO addr=%pap size=%pap\n",
309 goto err_disable_pcidev
;
312 /* Validate MMIO region version and size. */
313 if (vmmdev
->version
!= VMMDEV_MEMORY_VERSION
||
314 vmmdev
->size
< 32 || vmmdev
->size
> mmio_len
) {
315 vbg_err("vboxguest: Bogus VMMDev memory; version=%08x (expected %08x) size=%d (expected <= %d)\n",
316 vmmdev
->version
, VMMDEV_MEMORY_VERSION
,
317 vmmdev
->size
, (int)mmio_len
);
318 goto err_disable_pcidev
;
324 gdev
->misc_device
.minor
= MISC_DYNAMIC_MINOR
;
325 gdev
->misc_device
.name
= DEVICE_NAME
;
326 gdev
->misc_device
.fops
= &vbg_misc_device_fops
;
327 gdev
->misc_device_user
.minor
= MISC_DYNAMIC_MINOR
;
328 gdev
->misc_device_user
.name
= DEVICE_NAME_USER
;
329 gdev
->misc_device_user
.fops
= &vbg_misc_device_user_fops
;
331 ret
= vbg_core_init(gdev
, VMMDEV_EVENT_MOUSE_POSITION_CHANGED
);
333 goto err_disable_pcidev
;
335 ret
= vbg_create_input_device(gdev
);
337 vbg_err("vboxguest: Error creating input device: %d\n", ret
);
338 goto err_vbg_core_exit
;
341 ret
= devm_request_irq(dev
, pci
->irq
, vbg_core_isr
, IRQF_SHARED
,
344 vbg_err("vboxguest: Error requesting irq: %d\n", ret
);
345 goto err_vbg_core_exit
;
348 ret
= misc_register(&gdev
->misc_device
);
350 vbg_err("vboxguest: Error misc_register %s failed: %d\n",
352 goto err_vbg_core_exit
;
355 ret
= misc_register(&gdev
->misc_device_user
);
357 vbg_err("vboxguest: Error misc_register %s failed: %d\n",
358 DEVICE_NAME_USER
, ret
);
359 goto err_unregister_misc_device
;
362 mutex_lock(&vbg_gdev_mutex
);
367 mutex_unlock(&vbg_gdev_mutex
);
370 vbg_err("vboxguest: Error more then 1 vbox guest pci device\n");
371 goto err_unregister_misc_device_user
;
374 pci_set_drvdata(pci
, gdev
);
375 device_create_file(dev
, &dev_attr_host_version
);
376 device_create_file(dev
, &dev_attr_host_features
);
378 vbg_info("vboxguest: misc device minor %d, IRQ %d, I/O port %x, MMIO at %pap (size %pap)\n",
379 gdev
->misc_device
.minor
, pci
->irq
, gdev
->io_port
,
384 err_unregister_misc_device_user
:
385 misc_deregister(&gdev
->misc_device_user
);
386 err_unregister_misc_device
:
387 misc_deregister(&gdev
->misc_device
);
391 pci_disable_device(pci
);
396 static void vbg_pci_remove(struct pci_dev
*pci
)
398 struct vbg_dev
*gdev
= pci_get_drvdata(pci
);
400 mutex_lock(&vbg_gdev_mutex
);
402 mutex_unlock(&vbg_gdev_mutex
);
404 device_remove_file(gdev
->dev
, &dev_attr_host_features
);
405 device_remove_file(gdev
->dev
, &dev_attr_host_version
);
406 misc_deregister(&gdev
->misc_device_user
);
407 misc_deregister(&gdev
->misc_device
);
409 pci_disable_device(pci
);
412 struct vbg_dev
*vbg_get_gdev(void)
414 mutex_lock(&vbg_gdev_mutex
);
417 * Note on success we keep the mutex locked until vbg_put_gdev(),
418 * this stops vbg_pci_remove from removing the device from underneath
419 * vboxsf. vboxsf will only hold a reference for a short while.
424 mutex_unlock(&vbg_gdev_mutex
);
425 return ERR_PTR(-ENODEV
);
427 EXPORT_SYMBOL(vbg_get_gdev
);
429 void vbg_put_gdev(struct vbg_dev
*gdev
)
431 WARN_ON(gdev
!= vbg_gdev
);
432 mutex_unlock(&vbg_gdev_mutex
);
434 EXPORT_SYMBOL(vbg_put_gdev
);
437 * Callback for mouse events.
439 * This is called at the end of the ISR, after leaving the event spinlock, if
440 * VMMDEV_EVENT_MOUSE_POSITION_CHANGED was raised by the host.
442 * @gdev: The device extension.
444 void vbg_linux_mouse_event(struct vbg_dev
*gdev
)
448 /* Report events to the kernel input device */
449 gdev
->mouse_status_req
->mouse_features
= 0;
450 gdev
->mouse_status_req
->pointer_pos_x
= 0;
451 gdev
->mouse_status_req
->pointer_pos_y
= 0;
452 rc
= vbg_req_perform(gdev
, gdev
->mouse_status_req
);
454 input_report_abs(gdev
->input
, ABS_X
,
455 gdev
->mouse_status_req
->pointer_pos_x
);
456 input_report_abs(gdev
->input
, ABS_Y
,
457 gdev
->mouse_status_req
->pointer_pos_y
);
458 input_sync(gdev
->input
);
462 static const struct pci_device_id vbg_pci_ids
[] = {
463 { .vendor
= VBOX_VENDORID
, .device
= VMMDEV_DEVICEID
},
466 MODULE_DEVICE_TABLE(pci
, vbg_pci_ids
);
468 static struct pci_driver vbg_pci_driver
= {
470 .id_table
= vbg_pci_ids
,
471 .probe
= vbg_pci_probe
,
472 .remove
= vbg_pci_remove
,
475 module_pci_driver(vbg_pci_driver
);
477 MODULE_AUTHOR("Oracle Corporation");
478 MODULE_DESCRIPTION("Oracle VM VirtualBox Guest Additions for Linux Module");
479 MODULE_LICENSE("GPL");