Skip to content
forked from g4bwy/inputpipe

Inputpipe is a client/server application for making any Linux input device network-transparent.

License

Notifications You must be signed in to change notification settings

baraban/inputpipe

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

===========
 Inputpipe
===========
Version 0.5


Introduction
------------

Inputpipe is a client/server application for making any Linux input
device network-transparent. An inputpipe client runs on a computer with
some arbitrary input devices, forwarding information and status from
those devices to an inputpipe server. The server creates local input
devices that are for all practical purposes identical copies of the
devices being forwarded.

Build with "make", install with "make install". Nothing fancy there.

Inputpipe is licensed under the GNU GPL.


Contents
--------

conf:
  Sample config files. Currently this contains an example of running
  inputpipe-server via xinetd.

uinput:
  A modified version of the uinput driver that supports force feedback
  and includes some small bugfixes. This has been submitted upstream
  so hopefully you should see it in a stable kernel soon.
  This is not required.

src:
  Source for inputpipe-server and inputpipe-client


Server setup
------------

(Requires Linux 2.6 or later and the 'uinput' kernel module)

The inputpipe server is the machine you wish forwarded input devices
to appear on. It uses the 'uinput' kernel module to create the forwarded
input devices- therefore it requires Linux 2.6.x.

IMPORTANT: inputpipe-server on its own has no security features. It is
           intended mainly for use on closed networks. If you require
           a little extra security you can run inputpipe-server in inetd
           mode and use wrappers or inetd features to accept only certain
           connections.

           Even if you authenticate connections to inputpipe, note that
           the data will not be encrypted! Don't use inputpipe for devices
           that may be used to enter passwords.

That said, you can get started just by running "inputpipe-server" with
no arguments. For more advanced usage, see the --help text and the sample
xinetd.conf provided in the 'conf' directory.


Client setup
------------

(Requires Linux 2.4 or later and the 'evdev' kernel module)

Inputpipe clients can run on Linux 2.4 or Linux 2.6 machines, though
clients using Linux 2.4 will be less bandwidth-efficient and won't support
a few fun features like physical paths and "rumble" force feedback.

The inputpipe client needs to know what server to connect to, and where to
find input devices to forward. You can give it individual event devices,
you can give it categories of devices to forward, or any combination of the
two. In the case that inputpipe-client is forwarding a broad category of
devices, it will support hotplugging. New devices will automagically appear
on the server when plugged in, if they match the criteria given to
inputpipe-client.

Read the output of "inputpipe-client --help" for details, but here are some
quick examples:

1. Forwarding a single event device to the host "warzok":

 inputpipe-client warzok /dev/input/event5

2. Forwarding all joystick devices to warzok:

 inputpipe-client -j warzok

3. Forwarding all mice plus a single known input device to warzok:

 inputpipe-client -m warzok /dev/input/event3

Note that in example 1, inputpipe-client will exit if the device is removed
or warzok goes down. In the other examples, inputpipe-client will keep scanning
for new hotplugged devices. Also note that as long as the inputpipe server is
alive when inputpipe-client first connects, it can go down and come back up
without killing inputpipe-client- the client will retry failed connections.


Internals
---------

Inputpipe uses a simple but extensible binary protocol over TCP. Most input
traffic consists of thinly encapsulated and network-byte-order-adjusted
input_event structures, but inputpipe defines numerous other packet types
used for communicating a device's identity and capabilities. For full details
on the protocol, see src/inputpipe.h


Contacts
------

Micah Dowty <micah@navi.cx>

The latest code is in a Subversion repository at:
  http://navi.cx/svn/misc/trunk/inputpipe/

--- The End ---

About

Inputpipe is a client/server application for making any Linux input device network-transparent.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 99.8%
  • Shell 0.2%