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/cred.h>
9 #include <linux/input.h>
10 #include <linux/kernel.h>
11 #include <linux/miscdevice.h>
12 #include <linux/module.h>
13 #include <linux/pci.h>
14 #include <linux/poll.h>
15 #include <linux/vbox_utils.h>
16 #include "vboxguest_core.h"
18 /** The device name. */
19 #define DEVICE_NAME "vboxguest"
20 /** The device name for the device node open to everyone. */
21 #define DEVICE_NAME_USER "vboxuser"
22 /** VirtualBox PCI vendor ID. */
23 #define VBOX_VENDORID 0x80ee
24 /** VMMDev PCI card product ID. */
25 #define VMMDEV_DEVICEID 0xcafe
27 /** Mutex protecting the global vbg_gdev pointer used by vbg_get/put_gdev. */
28 static DEFINE_MUTEX(vbg_gdev_mutex
);
29 /** Global vbg_gdev pointer used by vbg_get/put_gdev. */
30 static struct vbg_dev
*vbg_gdev
;
32 static u32
vbg_misc_device_requestor(struct inode
*inode
)
34 u32 requestor
= VMMDEV_REQUESTOR_USERMODE
|
35 VMMDEV_REQUESTOR_CON_DONT_KNOW
|
36 VMMDEV_REQUESTOR_TRUST_NOT_GIVEN
;
38 if (from_kuid(current_user_ns(), current
->cred
->uid
) == 0)
39 requestor
|= VMMDEV_REQUESTOR_USR_ROOT
;
41 requestor
|= VMMDEV_REQUESTOR_USR_USER
;
43 if (in_egroup_p(inode
->i_gid
))
44 requestor
|= VMMDEV_REQUESTOR_GRP_VBOX
;
49 static int vbg_misc_device_open(struct inode
*inode
, struct file
*filp
)
51 struct vbg_session
*session
;
54 /* misc_open sets filp->private_data to our misc device */
55 gdev
= container_of(filp
->private_data
, struct vbg_dev
, misc_device
);
57 session
= vbg_core_open_session(gdev
, vbg_misc_device_requestor(inode
));
59 return PTR_ERR(session
);
61 filp
->private_data
= session
;
65 static int vbg_misc_device_user_open(struct inode
*inode
, struct file
*filp
)
67 struct vbg_session
*session
;
70 /* misc_open sets filp->private_data to our misc device */
71 gdev
= container_of(filp
->private_data
, struct vbg_dev
,
74 session
= vbg_core_open_session(gdev
, vbg_misc_device_requestor(inode
) |
75 VMMDEV_REQUESTOR_USER_DEVICE
);
77 return PTR_ERR(session
);
79 filp
->private_data
= session
;
85 * Return: 0 on success, negated errno on failure.
86 * @inode: Pointer to inode info structure.
87 * @filp: Associated file pointer.
89 static int vbg_misc_device_close(struct inode
*inode
, struct file
*filp
)
91 vbg_core_close_session(filp
->private_data
);
92 filp
->private_data
= NULL
;
97 * Device I/O Control entry point.
98 * Return: 0 on success, negated errno on failure.
99 * @filp: Associated file pointer.
100 * @req: The request specified to ioctl().
101 * @arg: The argument specified to ioctl().
103 static long vbg_misc_device_ioctl(struct file
*filp
, unsigned int req
,
106 struct vbg_session
*session
= filp
->private_data
;
107 size_t returned_size
, size
;
108 struct vbg_ioctl_hdr hdr
;
113 if (copy_from_user(&hdr
, (void *)arg
, sizeof(hdr
)))
116 if (hdr
.version
!= VBG_IOCTL_HDR_VERSION
)
119 if (hdr
.size_in
< sizeof(hdr
) ||
120 (hdr
.size_out
&& hdr
.size_out
< sizeof(hdr
)))
123 size
= max(hdr
.size_in
, hdr
.size_out
);
124 if (_IOC_SIZE(req
) && _IOC_SIZE(req
) != size
)
130 * IOCTL_VMMDEV_REQUEST needs the buffer to be below 4G to avoid
131 * the need for a bounce-buffer and another copy later on.
133 is_vmmdev_req
= (req
& ~IOCSIZE_MASK
) == VBG_IOCTL_VMMDEV_REQUEST(0) ||
134 req
== VBG_IOCTL_VMMDEV_REQUEST_BIG
;
137 buf
= vbg_req_alloc(size
, VBG_IOCTL_HDR_TYPE_DEFAULT
,
140 buf
= kmalloc(size
, GFP_KERNEL
);
144 *((struct vbg_ioctl_hdr
*)buf
) = hdr
;
145 if (copy_from_user(buf
+ sizeof(hdr
), (void *)arg
+ sizeof(hdr
),
146 hdr
.size_in
- sizeof(hdr
))) {
150 if (hdr
.size_in
< size
)
151 memset(buf
+ hdr
.size_in
, 0, size
- hdr
.size_in
);
153 ret
= vbg_core_ioctl(session
, req
, buf
);
157 returned_size
= ((struct vbg_ioctl_hdr
*)buf
)->size_out
;
158 if (returned_size
> size
) {
159 vbg_debug("%s: too much output data %zu > %zu\n",
160 __func__
, returned_size
, size
);
161 returned_size
= size
;
163 if (copy_to_user((void *)arg
, buf
, returned_size
) != 0)
168 vbg_req_free(buf
, size
);
175 /** The file_operations structures. */
176 static const struct file_operations vbg_misc_device_fops
= {
177 .owner
= THIS_MODULE
,
178 .open
= vbg_misc_device_open
,
179 .release
= vbg_misc_device_close
,
180 .unlocked_ioctl
= vbg_misc_device_ioctl
,
182 .compat_ioctl
= vbg_misc_device_ioctl
,
185 static const struct file_operations vbg_misc_device_user_fops
= {
186 .owner
= THIS_MODULE
,
187 .open
= vbg_misc_device_user_open
,
188 .release
= vbg_misc_device_close
,
189 .unlocked_ioctl
= vbg_misc_device_ioctl
,
191 .compat_ioctl
= vbg_misc_device_ioctl
,
196 * Called when the input device is first opened.
198 * Sets up absolute mouse reporting.
200 static int vbg_input_open(struct input_dev
*input
)
202 struct vbg_dev
*gdev
= input_get_drvdata(input
);
203 u32 feat
= VMMDEV_MOUSE_GUEST_CAN_ABSOLUTE
| VMMDEV_MOUSE_NEW_PROTOCOL
;
206 ret
= vbg_core_set_mouse_status(gdev
, feat
);
214 * Called if all open handles to the input device are closed.
216 * Disables absolute reporting.
218 static void vbg_input_close(struct input_dev
*input
)
220 struct vbg_dev
*gdev
= input_get_drvdata(input
);
222 vbg_core_set_mouse_status(gdev
, 0);
226 * Creates the kernel input device.
228 * Return: 0 on success, negated errno on failure.
230 static int vbg_create_input_device(struct vbg_dev
*gdev
)
232 struct input_dev
*input
;
234 input
= devm_input_allocate_device(gdev
->dev
);
238 input
->id
.bustype
= BUS_PCI
;
239 input
->id
.vendor
= VBOX_VENDORID
;
240 input
->id
.product
= VMMDEV_DEVICEID
;
241 input
->open
= vbg_input_open
;
242 input
->close
= vbg_input_close
;
243 input
->dev
.parent
= gdev
->dev
;
244 input
->name
= "VirtualBox mouse integration";
246 input_set_abs_params(input
, ABS_X
, VMMDEV_MOUSE_RANGE_MIN
,
247 VMMDEV_MOUSE_RANGE_MAX
, 0, 0);
248 input_set_abs_params(input
, ABS_Y
, VMMDEV_MOUSE_RANGE_MIN
,
249 VMMDEV_MOUSE_RANGE_MAX
, 0, 0);
250 input_set_capability(input
, EV_KEY
, BTN_MOUSE
);
251 input_set_drvdata(input
, gdev
);
255 return input_register_device(gdev
->input
);
258 static ssize_t
host_version_show(struct device
*dev
,
259 struct device_attribute
*attr
, char *buf
)
261 struct vbg_dev
*gdev
= dev_get_drvdata(dev
);
263 return sprintf(buf
, "%s\n", gdev
->host_version
);
266 static ssize_t
host_features_show(struct device
*dev
,
267 struct device_attribute
*attr
, char *buf
)
269 struct vbg_dev
*gdev
= dev_get_drvdata(dev
);
271 return sprintf(buf
, "%#x\n", gdev
->host_features
);
274 static DEVICE_ATTR_RO(host_version
);
275 static DEVICE_ATTR_RO(host_features
);
278 * Does the PCI detection and init of the device.
280 * Return: 0 on success, negated errno on failure.
282 static int vbg_pci_probe(struct pci_dev
*pci
, const struct pci_device_id
*id
)
284 struct device
*dev
= &pci
->dev
;
285 resource_size_t io
, io_len
, mmio
, mmio_len
;
286 struct vmmdev_memory
*vmmdev
;
287 struct vbg_dev
*gdev
;
290 gdev
= devm_kzalloc(dev
, sizeof(*gdev
), GFP_KERNEL
);
294 ret
= pci_enable_device(pci
);
296 vbg_err("vboxguest: Error enabling device: %d\n", ret
);
302 io
= pci_resource_start(pci
, 0);
303 io_len
= pci_resource_len(pci
, 0);
304 if (!io
|| !io_len
) {
305 vbg_err("vboxguest: Error IO-port resource (0) is missing\n");
306 goto err_disable_pcidev
;
308 if (devm_request_region(dev
, io
, io_len
, DEVICE_NAME
) == NULL
) {
309 vbg_err("vboxguest: Error could not claim IO resource\n");
311 goto err_disable_pcidev
;
314 mmio
= pci_resource_start(pci
, 1);
315 mmio_len
= pci_resource_len(pci
, 1);
316 if (!mmio
|| !mmio_len
) {
317 vbg_err("vboxguest: Error MMIO resource (1) is missing\n");
318 goto err_disable_pcidev
;
321 if (devm_request_mem_region(dev
, mmio
, mmio_len
, DEVICE_NAME
) == NULL
) {
322 vbg_err("vboxguest: Error could not claim MMIO resource\n");
324 goto err_disable_pcidev
;
327 vmmdev
= devm_ioremap(dev
, mmio
, mmio_len
);
329 vbg_err("vboxguest: Error ioremap failed; MMIO addr=%pap size=%pap\n",
331 goto err_disable_pcidev
;
334 /* Validate MMIO region version and size. */
335 if (vmmdev
->version
!= VMMDEV_MEMORY_VERSION
||
336 vmmdev
->size
< 32 || vmmdev
->size
> mmio_len
) {
337 vbg_err("vboxguest: Bogus VMMDev memory; version=%08x (expected %08x) size=%d (expected <= %d)\n",
338 vmmdev
->version
, VMMDEV_MEMORY_VERSION
,
339 vmmdev
->size
, (int)mmio_len
);
340 goto err_disable_pcidev
;
346 gdev
->misc_device
.minor
= MISC_DYNAMIC_MINOR
;
347 gdev
->misc_device
.name
= DEVICE_NAME
;
348 gdev
->misc_device
.fops
= &vbg_misc_device_fops
;
349 gdev
->misc_device_user
.minor
= MISC_DYNAMIC_MINOR
;
350 gdev
->misc_device_user
.name
= DEVICE_NAME_USER
;
351 gdev
->misc_device_user
.fops
= &vbg_misc_device_user_fops
;
353 ret
= vbg_core_init(gdev
, VMMDEV_EVENT_MOUSE_POSITION_CHANGED
);
355 goto err_disable_pcidev
;
357 ret
= vbg_create_input_device(gdev
);
359 vbg_err("vboxguest: Error creating input device: %d\n", ret
);
360 goto err_vbg_core_exit
;
363 ret
= devm_request_irq(dev
, pci
->irq
, vbg_core_isr
, IRQF_SHARED
,
366 vbg_err("vboxguest: Error requesting irq: %d\n", ret
);
367 goto err_vbg_core_exit
;
370 ret
= misc_register(&gdev
->misc_device
);
372 vbg_err("vboxguest: Error misc_register %s failed: %d\n",
374 goto err_vbg_core_exit
;
377 ret
= misc_register(&gdev
->misc_device_user
);
379 vbg_err("vboxguest: Error misc_register %s failed: %d\n",
380 DEVICE_NAME_USER
, ret
);
381 goto err_unregister_misc_device
;
384 mutex_lock(&vbg_gdev_mutex
);
389 mutex_unlock(&vbg_gdev_mutex
);
392 vbg_err("vboxguest: Error more then 1 vbox guest pci device\n");
393 goto err_unregister_misc_device_user
;
396 pci_set_drvdata(pci
, gdev
);
397 device_create_file(dev
, &dev_attr_host_version
);
398 device_create_file(dev
, &dev_attr_host_features
);
400 vbg_info("vboxguest: misc device minor %d, IRQ %d, I/O port %x, MMIO at %pap (size %pap)\n",
401 gdev
->misc_device
.minor
, pci
->irq
, gdev
->io_port
,
406 err_unregister_misc_device_user
:
407 misc_deregister(&gdev
->misc_device_user
);
408 err_unregister_misc_device
:
409 misc_deregister(&gdev
->misc_device
);
413 pci_disable_device(pci
);
418 static void vbg_pci_remove(struct pci_dev
*pci
)
420 struct vbg_dev
*gdev
= pci_get_drvdata(pci
);
422 mutex_lock(&vbg_gdev_mutex
);
424 mutex_unlock(&vbg_gdev_mutex
);
426 device_remove_file(gdev
->dev
, &dev_attr_host_features
);
427 device_remove_file(gdev
->dev
, &dev_attr_host_version
);
428 misc_deregister(&gdev
->misc_device_user
);
429 misc_deregister(&gdev
->misc_device
);
431 pci_disable_device(pci
);
434 struct vbg_dev
*vbg_get_gdev(void)
436 mutex_lock(&vbg_gdev_mutex
);
439 * Note on success we keep the mutex locked until vbg_put_gdev(),
440 * this stops vbg_pci_remove from removing the device from underneath
441 * vboxsf. vboxsf will only hold a reference for a short while.
446 mutex_unlock(&vbg_gdev_mutex
);
447 return ERR_PTR(-ENODEV
);
449 EXPORT_SYMBOL(vbg_get_gdev
);
451 void vbg_put_gdev(struct vbg_dev
*gdev
)
453 WARN_ON(gdev
!= vbg_gdev
);
454 mutex_unlock(&vbg_gdev_mutex
);
456 EXPORT_SYMBOL(vbg_put_gdev
);
459 * Callback for mouse events.
461 * This is called at the end of the ISR, after leaving the event spinlock, if
462 * VMMDEV_EVENT_MOUSE_POSITION_CHANGED was raised by the host.
464 * @gdev: The device extension.
466 void vbg_linux_mouse_event(struct vbg_dev
*gdev
)
470 /* Report events to the kernel input device */
471 gdev
->mouse_status_req
->mouse_features
= 0;
472 gdev
->mouse_status_req
->pointer_pos_x
= 0;
473 gdev
->mouse_status_req
->pointer_pos_y
= 0;
474 rc
= vbg_req_perform(gdev
, gdev
->mouse_status_req
);
476 input_report_abs(gdev
->input
, ABS_X
,
477 gdev
->mouse_status_req
->pointer_pos_x
);
478 input_report_abs(gdev
->input
, ABS_Y
,
479 gdev
->mouse_status_req
->pointer_pos_y
);
480 input_sync(gdev
->input
);
484 static const struct pci_device_id vbg_pci_ids
[] = {
485 { .vendor
= VBOX_VENDORID
, .device
= VMMDEV_DEVICEID
},
488 MODULE_DEVICE_TABLE(pci
, vbg_pci_ids
);
490 static struct pci_driver vbg_pci_driver
= {
492 .id_table
= vbg_pci_ids
,
493 .probe
= vbg_pci_probe
,
494 .remove
= vbg_pci_remove
,
497 module_pci_driver(vbg_pci_driver
);
499 MODULE_AUTHOR("Oracle Corporation");
500 MODULE_DESCRIPTION("Oracle VM VirtualBox Guest Additions for Linux Module");
501 MODULE_LICENSE("GPL");