manual/xml/configuring_usb_device_access.xml

   1 <?xml version="1.0" standalone="no"?>
   2
   3 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
   4
   5 ]>
   6
   7 <section id="sn-configuring-usb-device-access">
   8   <title>Configuring USB device access (Linux only)</title>
   9   <para>
  10     Linux is by default a multi-user system, so it has to have a policy to
  11     determine who can access various devices. This includes those that can
  12     be plugged into to a USB port.
  13   </para>
  14
  15   <para>
  16     For devices known to the operating system (which these days includes
  17     most digital cameras, scanners, MIDI interfaces etc.), a logged-in user
  18     will be granted access automatically. However, for devices that the OS
  19     doesn't recognize (even if there is software on it that can use it),
  20     this is not the case. It is possible to configure Linux to reverse this
  21     policy and grant all users access to all devices, but this is not
  22     recommended for security reasons.
  23   </para>
  24
  25   <section id="usb-access-tranzport">
  26     <title>Configuring Access to a Frontier Design Tranzport</title>
  27     <para>
  28       Using the Tranzport on Linux requires a couple of extra steps to
  29       enable non-administrative users to access the device.
  30     </para>
  31
  32     <para>
  33       First, you need to login as the administrative user ("root"). Then put
  34       the following into a new file called
  35       <filename>/etc/hotplug/usb/tranzport</filename>
  36     </para>
  37 <screen>
  38 #!/bin/sh
  39
  40 if [ $ACTION = "add" ] &amp;&amp; [ -f $DEVICE ] ; then
  41     chmod 0666 $DEVICE
  42 fi
  43 exit 0
  44 </screen>
  45     <para>
  46       Then make sure that the file is executable by running
  47     </para>
  48 <screen>
  49 chmod +x /etc/hotplug/usb/tranzport
  50 </screen>
  51     <para>
  52       Second, edit the file <filename>/etc/hotplug/usb.usermap</filename> by
  53       adding the following 2 lines to the end of it (make sure that the 2nd
  54       line is not split across multiple lines, even though it is very long):
  55     </para>
  56 <screen>
  57 # Frontier Design Tranzport
  58 tranzport            0x0000      0x165b   0x8101    0x0000       0x0000      0x00         0x00            0x00            0x00          0x00               0x00               0x00000000
  59 </screen>
  60     <para>
  61       After doing these steps, the next time you plugin your Tranzport it
  62       will be accessible to you as a regular user.
  63     </para>
  64   </section>
  65 <!--
  66         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  67                 href="Some_Subsection.xml" />
  68         -->
  69 </section>