manual/xml/configuring_usb_device_access.xml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

<?xml version="1.0" standalone="no"?>

<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [

]>

<section id="sn-configuring-usb-device-access">
	<title>Configuring USB device access (Linux only)</title>
	<para>
		Linux is by default a multi-user system, so it has to have a policy to
		determine who can access various devices. This includes those that can be
		plugged into to a USB port.
	</para>

	<para>
		For devices known to the operating system (which these days includes most
		digital cameras, scanners, MIDI interfaces etc.), a logged-in user will be
		granted access automatically. However, for devices that the OS doesn't
		recognize (even if there is software on it that can use it), this is not the
		case. It is possible to configure Linux to reverse this policy and grant all
		users access to all devices, but this is not recommended for security
		reasons.
	</para>

	<section id="usb-access-tranzport">
		<title>Configuring Access to a Frontier Design Tranzport</title>
		<para>
			Using the Tranzport on Linux requires a couple of extra steps to enable
			non-administrative users to access the device.
		</para>

		<para>
			First, you need to login as the administrative user ("root"). Then put the
			following into a new file called <filename>/etc/hotplug/usb/tranzport</filename>
		</para>
<screen>
#!/bin/sh

if [ $ACTION = "add" ] &amp;&amp; [ -f $DEVICE ] ; then
    chmod 0666 $DEVICE
fi
exit 0
</screen>
		<para>
			Then make sure that the file is executable by running
		</para>
<screen>
chmod +x /etc/hotplug/usb/tranzport
</screen>
		<para>
			Second, edit the file <filename>/etc/hotplug/usb.usermap</filename>  by adding the following 2
			lines to the end of it (make sure that the 2nd line is not split across
			multiple lines, even though it is very long):
		</para>
<screen>
# Frontier Design Tranzport
tranzport            0x0000      0x165b   0x8101    0x0000       0x0000      0x00         0x00            0x00            0x00          0x00               0x00               0x00000000
</screen>
		<para>
			After doing these steps, the next time you plugin your Tranzport it will be
			accessible to you as a regular user.
		</para>
	</section>
<!--
	<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
		href="Some_Subsection.xml" />
	-->
</section>