Find a file
Peter Hutterer cabe03d8fe Document that the fd should be drained before libevdev_set_fd
This is the caller's responsibility, for two reasons:
* we don't know if O_NONBLOCK is set, so draining the fd isn't a simple matter
  of read() until EAGAIN. A select() + read() could work around this of
  course.
* for stateless information, keys and relative data, it is not a problem when
  there are events waiting on the fd already, they are processed correctly,
  albeit with a delay.

So punt this decision to the caller, they openend the fd, they know if they
care about delayed events, they can drain the fd before handing it to us.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Acked-by: Benjamin Tissoires <benjamin.tissoires@gmail.com>
Acked-by: David Herrmann <dh.herrmann@gmail.com>
2015-12-17 10:46:31 +10:00
doc doc: update doxygen.in for current doxygen 2014-11-13 11:06:08 +10:00
include/linux include: update to 4.1 header 2015-06-22 15:53:48 +10:00
libevdev Document that the fd should be drained before libevdev_set_fd 2015-12-17 10:46:31 +10:00
m4 m4: fix CC_CHECK_WERROR and CC_FLAG_VISIBILITY macros 2014-06-05 15:16:06 +10:00
test Accept LIBEVDEV_READ_FLAG_BLOCKING as valid flag 2015-04-08 12:48:43 +10:00
tools tools: fix touchpad-edge-detector udev rule output 2015-11-10 13:07:10 +10:00
.gitignore Add some more files to gitignore 2015-11-10 13:07:10 +10:00
autogen.sh autogen.sh: remove unneeded m4 configuration workaround 2013-11-19 09:37:06 +10:00
configure.ac libevdev 1.4.5 2015-11-11 12:11:48 +10:00
COPYING Update COPYING file. 2013-11-15 09:30:10 +10:00
libevdev.pc.in Fix name and version in pkgconfig file 2013-07-24 07:27:17 +10:00
Makefile.am Pass --no-print-directory to make 2013-08-26 07:59:07 +10:00
README.md README: remove the warning, it's stable now 2014-02-11 16:27:50 +10:00

libevdev - wrapper library for evdev input devices

libevdev is a wrapper library for evdev devices. it moves the common tasks when dealing with evdev devices into a library and provides a library interface to the callers, thus avoiding erroneous ioctls, etc.

git://git.freedesktop.org/git/libevdev http://cgit.freedesktop.org/libevdev/

The eventual goal is that libevdev wraps all ioctls available to evdev devices, thus making direct access unnecessary.

Go here for the API documentation: http://www.freedesktop.org/software/libevdev/doc/latest/

File bugs in the freedesktop.org bugzilla: https://bugs.freedesktop.org/enter_bug.cgi?product=libevdev

Patches, questions and general comments should be submitted to the input-tools@lists.freedesktop.org mailing list: http://lists.freedesktop.org/mailman/listinfo/input-tools