mirror of
https://gitlab.freedesktop.org/libevdev/libevdev.git
synced 2025-12-21 20:10:34 +01:00
73 lines
1.8 KiB
Text
73 lines
1.8 KiB
Text
|
libevdev_new(3)
|
||
|
|
===============
|
||
|
|
|
||
|
|
NAME
|
||
|
|
----
|
||
|
|
|
||
|
|
libevdev_new, libevdev_new_from_fd, libevdev_free - initialize and free a libevdev device
|
||
|
|
|
||
|
|
SYNOPSIS
|
||
|
|
--------
|
||
|
|
|
||
|
|
#include <libevdev/libevdev.h>
|
||
|
|
|
||
|
|
struct libevdev* libevdev_new(void);
|
||
|
|
|
||
|
|
int libevdev_new_from_fd(int fd, struct libevdev **dev);
|
||
|
|
|
||
|
|
void libevdev_free(struct libevdev *dev);
|
||
|
|
|
||
|
|
DESCRIPTION
|
||
|
|
-----------
|
||
|
|
|
||
|
|
*libevdev_new* allocates the memory required for libevdev's
|
||
|
|
wrapping of an evdev kernel input device. This does not initialize the
|
||
|
|
device yet, use *libevdev_set_fd(3)* for that.
|
||
|
|
|
||
|
|
*libevdev_new_from_fd* allocates the memory required for a kernel input
|
||
|
|
device and initializes that device from the given fd. The fd must be opened
|
||
|
|
in read or read-write mode and the caller must have the required permissions
|
||
|
|
to perform *ioctl(2)* calls on the fd.
|
||
|
|
|
||
|
|
The function *libevdev_free* frees the memory associated with the kernel input
|
||
|
|
device.
|
||
|
|
|
||
|
|
PARAMETERS
|
||
|
|
----------
|
||
|
|
*dev*::
|
||
|
|
Pointer to the libevdev device. In *libevdev_new_from_fd*, 'dev' is
|
||
|
|
set to the newly allocated pointer. In *libevdev_free*, 'dev' is the
|
||
|
|
previously allocated struct.
|
||
|
|
|
||
|
|
*fd*::
|
||
|
|
An open file descriptor to the kernel device. The fd must be opened
|
||
|
|
in O_RDONLY or O_RDWR.
|
||
|
|
|
||
|
|
RETURN VALUE
|
||
|
|
------------
|
||
|
|
|
||
|
|
On success, *libevdev_new* returns a pointer to the opaque 'struct
|
||
|
|
libevdev'. On failure, NULL is returned.
|
||
|
|
|
||
|
|
On success, *libevdev_new_from_fd* returns 0 and sets 'dev' to the newly
|
||
|
|
allocated device. On failure, a negative errno is returned indicating the
|
||
|
|
type of failure:
|
||
|
|
|
||
|
|
*ENOSP*::
|
||
|
|
Memory allocation failed.
|
||
|
|
|
||
|
|
*EBADF*::
|
||
|
|
'fd' is not a valid file descriptor.
|
||
|
|
|
||
|
|
*EACCESS*::
|
||
|
|
Permission denied.
|
||
|
|
|
||
|
|
For a full list of potential error codes consult *ioctl(2)*.
|
||
|
|
|
||
|
|
SEE ALSO
|
||
|
|
--------
|
||
|
|
|
||
|
|
libevdev_set_fd(3), libevdev_change_fd(3),
|
||
|
|
libevdev_grab(3),
|
||
|
|
libevdev_has_event_type(3), libevdev_has_event_code(3)
|