RomanNum3ral
/
Solaar
mirror of https://github.com/pwr-Solaar/Solaar.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs/installation: typo fix, clarification 

- Fix typo in rules path
 - Fix capitalisation.
 - `udevadm control --reload-rules` is unnecessary[1].
 - `adduser` is Debian-specific, use the more portable `gpasswd`.
 - No need to wait 10 seconds before re-inserting.
 - After adding to group, user must re-login.

 [1]: http://unix.stackexchange.com/a/39485/8250
This commit is contained in:
Peter Wu 2013-05-21 10:59:46 +02:00
parent d857144653
commit 07bff8cb37
1 changed files with 9 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
docs/installation.md
View File

@ -27,23 +27,22 @@ You can run the `rules.d/install.sh` script from Solaar to do this installation
automatically (it will switch to root when necessary), or you can do all the automatically (it will switch to root when necessary), or you can do all the
required steps by hand, as the root user: required steps by hand, as the root user:
1. copy `rules.d/99-logitech-unfiying-receiver.rules` from Solaar to 1. Copy `rules.d/99-logitech-unifying-receiver.rules` from Solaar to
`/etc/udev/rules.d/` `/etc/udev/rules.d/`. udev will automatically pick up this file using
inotify.
By default, the rule makes the Unifying Receiver device available for r/w by By default, the rule allows all members of the `plugdev` group to have
all users belonging to the `plugdev` system group (standard Debian/Ubuntu read/write access to the Unifying Receiver device. (standard Debian/ Ubuntu
group for pluggable devices). It may need changes, specific to your group for pluggable devices). It may need changes, specific to your
particular system's configuration. If in doubt, replacing `GROUP="plugdev"` particular system's configuration. If in doubt, replacing `GROUP="plugdev"`
with `GROUP="<your username>"` should just work. with `GROUP="<your username>"` should just work.
2. run `udevadm control --reload-rules` to let the udev daemon know about the 2. Physically remove the Unifying Receiver and re-insert it.
new rule
3. physically remove the Unifying Receiver, wait 10 seconds and re-insert it
This is necessary because if the receiver is already plugged-in, it already This is necessary because if the receiver is already plugged-in, it already
has a `/dev/hidraw?` device node, but with the old (`root:root`) permissions. has a `/dev/hidraw?` device node, but with the old (`root:root`) permissions.
Plugging it again will re-create the device node with the right permissions. Plugging it again will re-create the device node with the right permissions.
4. make sure your desktop users are part of the `plugdev` group, by running 3. Make sure your desktop users are part of the `plugdev` group, by running
`adduser <linux user> plugdev` as root `gpasswd $USER plugdev` as root. If these users were not assigned to the
group before, they must re-login for the changes to take effect.