Adding global read/write permissions to LabJack device rules.

The installer now installs 90-labjack.rules with global read/write permissions to LabJack devices. It also unistalls 10-labjack.rules and no longer cares about adding a user to the adm group.

Author: rolsen

10-labjack.rules 90-labjack.rules

@@ -1,6 +1,6 @@
 SUBSYSTEM!="usb_device", ACTION!="add", GOTO="labjack_rules_end"
 
 # LabJack Vendor ID
-ATTRS{idVendor}=="0cd5", GROUP="adm"
+ATTRS{idVendor}=="0cd5", MODE="0666", GROUP="adm"
 
 LABEL="labjack_rules_end"

INSTALL.Linux

@@ -126,54 +126,56 @@ install the library.
     $ make
     $ sudo make install
 
-Programs that use the liblabjackusb will need to access the USB device bus
-at /dev/bus/usb/, typically with root permission.  On Debian-based
-distributions, we provide udev rules that allow members of the "adm" group
-to access LabJack devices.
+Programs that use liblabjackusb will need to access the USB device bus at
+/dev/bus/usb/, without root permission.  On Debian-based distributions, we
+provide udev rules that allow all users to access LabJack devices.
 
-Install The udev Rules
+To Install The udev Rules:
 
-To install the udev rules, run the following commands from the root
-directory of this package.
+To install the udev rules, run the following command from the root
+directory of this package:
 
-    $ sudo cp 10-labjack.rules /lib/udev/rules.d
-    $ sudo udevadm control --reload-rules
+    $ sudo cp 90-labjack.rules /lib/udev/rules.d
 
-Older vesions of udevadm (e.g., the version included in Ubuntu 8.04) use an
-underscore instead of a dash: "--reload_rules" instead of "--reload-rules":
+Next, reload the udev rules.  For instructions, see the section "To Reload the
+udev Rules" below.
 
-    $ sudo udevadm control --reload_rules
+To Set Restrictive Permissions:
 
-On Debian-based distributions, the above two commands are sufficient. If
-your distribution does not have udevadm, restart udev or restart your
-computer. On a Fedora machine run:
+The current udev rules in 90-labjack.rules give LabJack device access to all
+users.  If you need to restrict permissions, alter 90-labjack.rules or install
+custom rules to /etc/udev/rules.d/, which takes priority over
+/lib/udev/rules.d/.  For example, to restrict usage to members of the adm group:
 
-    $ sudo /etc/init.d/udev-post reload
+    $ sudo cat > /etc/udev/rules.d/90-labjack.rules << EOF
+    SUBSYSTEM!="usb_device", ACTION!="add", GOTO="labjack_rules_end"
 
-Permissions
+    # LabJack Vendor ID
+    ATTRS{idVendor}=="0cd5", MODE="0664", GROUP="adm"
 
-Be sure to add any users that need to use LabJack devices to the "adm"
-group. If a user is not in the adm group, they will need to execute
-programs that use Exodriver with altered permissions. For example, they will
-need to run `sudo ./labjack_program` rather than `./labjack_program`.
+    LABEL="labjack_rules_end"
 
-To check if the user with username USERNAME is in the adm group, type:
+Next, reload the udev rules.  For instructions, see the section "To Reload the
+udev Rules" below.  Also, notice that the MODE is 0664, which is the only
+difference between what's installed as /lib/udev/rules.d/90-labjack.rules by
+default.  For more information about writing udev rules, see "man udev".
 
-    $ groups USERNAME
+To Reload the udev Rules:
 
-For this command, you can leave USERNAME blank if you are checking what groups
-the current user is in.
+To reload the udev rules, the following command works on most systems:
 
-If "adm" does not appear in the output, you need to add yourself to the
-adm group, as follows.
+    $ sudo udevadm control --reload-rules
 
-To add a user with username USERNAME to the adm group, run the following
-command:
+Older vesions of udevadm (e.g., the version included in Ubuntu 8.04) use an
+underscore instead of a dash: "--reload_rules" instead of "--reload-rules":
+
+    $ sudo udevadm control --reload_rules
 
-    $ sudo usermod -a -G adm USERNAME
+On Debian-based distributions, the above two commands are sufficient. If
+your distribution does not have udevadm, restart udev or restart your
+computer. On a Fedora machine run:
 
-For every user that is added to the adm group, they must log out and log
-back in for the group changes to take effect. Re-run "groups" to double check.
+    $ sudo /etc/init.d/udev-post reload
 
 
 LabJackPython and the Exodriver on Ubuntu 10.04

install.sh

@@ -1,17 +1,16 @@
 #! /bin/bash
 
-RULES=10-labjack.rules
+RULES=90-labjack.rules
+OLD_RULES=10-labjack.rules
 RULES_DEST_PRIMARY=/lib/udev/rules.d
 RULES_DEST_ALTERNATE=/etc/udev/rules.d
-GROUP=adm
 [email protected]
 TRUE=1
 FALSE=0
 IS_SUCCESS=$TRUE
 # Assume these are unneeded until otherwise
 NEED_RECONNECT=$FALSE
 NEED_RESTART=$FALSE
-NEED_RELOG=$FALSE
 NO_RULES=$FALSE
 NO_RULES_ERR=2
 
@@ -43,10 +42,6 @@ success ()
 	fi
 	if [ $NEED_RESTART -eq $TRUE ]; then
 		echo "Please manually restart the device rules or restart your computer now."
-	elif [ $NEED_RELOG -eq $TRUE ]; then
-		echo "Please log off and log back in for the group changes to take effect. To confirm the group changes have taken effect, enter the command:"
-		echo "  $ groups"
-		echo "and make sure $GROUP is in the list. (You probably have to log out of your entire account, not just your shell.)"
 	fi
 	exit $e
 }
@@ -73,6 +68,9 @@ go cd ../
 #################
 # LabJack Rules #
 #################
+rm -f $RULES_DEST_PRIMARY/$OLD_RULES
+rm -f $RULES_DEST_ALTERNATE/$OLD_RULES
+
 if [ -d $RULES_DEST_PRIMARY ]; then
 	RULES_DEST=$RULES_DEST_PRIMARY
 
@@ -117,81 +115,4 @@ else
 	echo # Finishes previous echo -n
 fi
 
-#####################
-# Add user to group #
-#####################
-user=`logname`
-
-in_group=$FALSE
-for g in `id -nG $user`; do
-	if [ "$g" == "$GROUP" ]; then
-		in_group=$TRUE
-		break
-	fi
-done
-
-if [ $in_group -eq $TRUE ]; then
-	# Make sure the user is logged into the adm group
-	current_groups=$FALSE
-	for g in `groups $user`; do
-		if [ "$g" == "$GROUP" ]; then
-			current_groups=$TRUE
-			break
-		fi
-	done
-	if [ $current_groups -ne $TRUE ]; then
-		NEED_RELOG=$TRUE
-	fi
-
-	success
-fi
-
-echo "Adding $user to the $GROUP group.."
-NEED_RELOG=$TRUE
-
-declare -a tasks=("add/create a group named $GROUP ($ groupadd -f $GROUP)" "add your user account to the group named $GROUP ($ usermod -a -G $GROUP $user)")
-
-print_tasks_if_needed()
-{
-	ret=$?
-	if [ $ret -ne 0 ]; then
-		echo
-		echo "It looks like this installer failed with only a few task(s) left to complete."
-		echo "LabJack developed this installer on Ubuntu/Debian Linux, so if you are running"
-		echo "Ubuntu/Debian, please contact LabJack. However, if you are running a"
-		echo "different distribution of Linux, it is likely that your distribution varies"
-		echo "enough to make these last task(s) fail."
-		echo
-		echo "You can search the internet for how to complete the following task(s) on your"
-		echo "distribution of Linux:"
-		for n in "${tasks[@]}"; do
-			echo "    - $n"
-		done
-		echo
-		echo "Where the Ubuntu/Debian commands for the tasks are in parenthesis."
-		echo
-		echo "Once these tasks are complete, your installation of Exodriver will be complete."
-		echo
-		echo "If you are on a common distribution of Linux or if you are not sure how to"
-		echo "complete the above task(s), please contact LabJack support. If your"
-		echo "distribution of Linux is old, consider upgrading to see if that solves the"
-		echo "problem."
-		echo
-		echo "LabJack support: [email protected]"
-		echo
-		echo "Please also follow any following instructions."
-		echo
-		IS_SUCCESS=$FALSE
-		success
-	fi
-}
-
-groupadd -f $GROUP
-print_tasks_if_needed
-unset tasks[0]
-
-usermod -a -G $GROUP $user
-print_tasks_if_needed
-unset tasks[1]
-
 success