/[gentoo]/xml/htdocs/doc/en/gpm.xml
Gentoo

Diff of /xml/htdocs/doc/en/gpm.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.2 Revision 1.3
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gpm.xml,v 1.2 2005/07/26 18:17:07 neysx Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gpm.xml,v 1.3 2005/07/26 18:28:52 jkt Exp $ -->
4 4
5<guide link="/doc/en/gpm.xml"> 5<guide link="/doc/en/gpm.xml">
6<title>Using a Mouse within the Console</title> 6<title>Using a Mouse within the Console</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="jackdark@gmail.com">Joshua Saddler</mail> 9 <mail link="jackdark@gmail.com">Joshua Saddler</mail>
10</author> 10</author>
11 11
12<abstract> 12<abstract>
13This guide shows you how to set up and use gpm (the General Purpose Mouse 13This guide shows you how to set up and use GPM (the General Purpose Mouse
14server) from within a command line interface. This is especially useful for new 14server) from within a command line interface. This is especially useful for new
15Gentoo installations or for systems that cannot or do not use an X server. 15Gentoo installations or for systems that cannot or do not use an X server.
16</abstract> 16</abstract>
17 17
18<!-- The content of this document is licensed under the CC-BY-SA license --> 18<!-- The content of this document is licensed under the CC-BY-SA license -->
19<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 19<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
20<license/> 20<license/>
21 21
22<version>1.0</version> 22<version>1.1</version>
23<date>2005-07-26</date> 23<date>2005-07-26</date>
24 24
25<chapter> 25<chapter>
26<title>Getting gpm</title> 26<title>Getting GPM</title>
27<section> 27<section>
28<body> 28<body>
29 29
30<p> 30<p>
31If you've just installed Gentoo, you almost certainly don't have your mouse set 31If you've just installed Gentoo, you almost certainly don't have your mouse set
33or don't need an X server, yet you still need to use a mouse. The solution is 33or don't need an X server, yet you still need to use a mouse. The solution is
34simple: <c>gpm</c>, the General Purpose Mouse server. 34simple: <c>gpm</c>, the General Purpose Mouse server.
35</p> 35</p>
36 36
37<p> 37<p>
38First, you will need to get gpm: 38First, you will need to get GPM:
39</p> 39</p>
40 40
41<pre caption="Obtaining gpm"> 41<pre caption="Obtaining GPM">
42# <i>emerge gpm</i> 42# <i>emerge gpm</i>
43</pre> 43</pre>
44 44
45<p> 45<p>
46You might have noticed a few messages during the compilation that warned about 46You might have noticed a few messages during the compilation that warned about
47configuring the server. You must do this before starting gpm. 47configuring the server. You must do this before starting GPM.
48</p> 48</p>
49 49
50</body> 50</body>
51</section>
52</chapter>
53
54<chapter>
55<title>Configuring gpm</title>
56<section> 51</section>
57<body> 52</chapter>
58 53
54<chapter>
55<title>Configuring GPM</title>
56<section>
57<body>
58
59<p> 59<p>
60Before you can use gpm, you will need to uncomment the lines corresponding to 60Before you can use GPM, you will need to uncomment the lines corresponding to
61the location and protocol of your mouse. You do this by editing the gpm 61the location and protocol of your mouse. You do this by editing the GPM
62configuration file: 62configuration file:
63</p> 63</p>
64 64
65<pre caption="Setting up gpm"> 65<pre caption="Setting up GPM">
66# <i>nano /etc/conf.d/gpm</i> 66# <i>nano /etc/conf.d/gpm</i>
67</pre> 67</pre>
68 68
69<p> 69<p>
70In my case, I have a USB mouse on <path>/dev/input/mouse0</path>. So, I have 70In my case, I have a USB mouse on <path>/dev/input/mouse0</path>. So, I have
74deprecated and can be disabled in the latest 2.6 kernels. If 74deprecated and can be disabled in the latest 2.6 kernels. If
75<path>/dev/input/mice</path> fails, then fall back to other devices. Here is my 75<path>/dev/input/mice</path> fails, then fall back to other devices. Here is my
76example <path>/etc/conf.d/gpm</path>: 76example <path>/etc/conf.d/gpm</path>:
77</p> 77</p>
78 78
79<pre caption="Example gpm config"> 79<pre caption="Example GPM config">
80<comment>(Please uncomment the type of mouse you have and the appropriate MOUSEDEV entry)</comment> 80<comment>(Please uncomment the type of mouse you have and the appropriate MOUSEDEV entry)</comment>
81 81
82#MOUSE=ps2 82#MOUSE=ps2
83MOUSE=imps2 83MOUSE=imps2
84#MOUSEDEV=/dev/psaux 84#MOUSEDEV=/dev/psaux
85MOUSEDEV=/dev/input/mice 85MOUSEDEV=/dev/input/mice
86</pre> 86</pre>
87 87
88<p> 88<p>
89If you have a wheelmouse, you will want to use the imps2 protocol, so uncomment 89If you have a wheelmouse, you will want to use the imps2 protocol, so uncomment
90that line. If imps2 and ps2 both fail to work for you, please refer to the gpm 90that line. If imps2 and ps2 both fail to work for you, please refer to the GPM
91info page (<c>info gpm</c>) for other protocols to try. Also, if you want to be 91info page (<c>info gpm</c>) for other protocols to try. Also, if you want to be
92able to click on hyperlinks in terminals to navigate to a website, it is a good 92able to click on hyperlinks in terminals to navigate to a website, it is a good
93idea to follow the suggestion in the <c>/etc/conf.d/gpm</c> file: 93idea to follow the suggestion in the <c>/etc/conf.d/gpm</c> file:
94</p> 94</p>
95 95
96<pre caption="Other options"> 96<pre caption="Other options">
97<comment>(Please uncomment this line if you want gpm to understand charsets 97<comment>(Please uncomment this line if you want GPM to understand charsets
98used in URLs and names with ~ or : in them, etc. 98used in URLs and names with ~ or : in them, etc.
99This is a good idea to turn on!)</comment> 99This is a good idea to turn on!)</comment>
100 100
101APPEND="-l \"a-zA-Z0-9_.:~/\300-\326\330-\366\370-\377\"" 101APPEND="-l \"a-zA-Z0-9_.:~/\300-\326\330-\366\370-\377\""
102</pre> 102</pre>
110</body> 110</body>
111</section> 111</section>
112</chapter> 112</chapter>
113 113
114<chapter> 114<chapter>
115<title>Running gpm</title> 115<title>Running GPM</title>
116<section> 116<section>
117<body> 117<body>
118 118
119<p> 119<p>
120Now that your mouse server is installed and configured, it's time to start 120Now that your mouse server is installed and configured, it's time to start
121using it: 121using it:
122</p> 122</p>
123 123
124<pre caption="The gpm init script"> 124<pre caption="The GPM init script">
125# <i>/etc/init.d/gpm start</i> 125# <i>/etc/init.d/gpm start</i>
126</pre> 126</pre>
127 127
128<p> 128<p>
129You should see a block cursor appear. Remember that only root can run the gpm 129You should see a block cursor appear. Remember that only root can run the GPM
130init script. However, to avoid having to <c>su</c> and run the script every 130init script. However, to avoid having to <c>su</c> and run the script every
131single time you begin a new session, why not set gpm to begin every time you 131single time you begin a new session, why not set GPM to begin every time you
132turn on your computer? 132turn on your computer?
133</p> 133</p>
134 134
135<pre caption="Adding gpm to the default runlevel"> 135<pre caption="Adding GPM to the default runlevel">
136# <i>rc-update add gpm default</i> 136# <i>rc-update add gpm default</i>
137</pre> 137</pre>
138 138
139<p> 139<p>
140Now, whenever you start your computer, you'll be greeted by the console cursor 140Now, whenever you start your computer, you'll be greeted by the console cursor
145</body> 145</body>
146</section> 146</section>
147</chapter> 147</chapter>
148 148
149<chapter> 149<chapter>
150<title>Working with gpm</title> 150<title>Working with GPM</title>
151<section> 151<section>
152<title>Copying and pasting</title> 152<title>Copying and pasting</title>
153<body> 153<body>
154 154
155<p> 155<p>
157easy. Simply highlight the text with the left mouse button (it will stay 157easy. Simply highlight the text with the left mouse button (it will stay
158highlighted when you release the button), switch to a different terminal if you 158highlighted when you release the button), switch to a different terminal if you
159wish, position the cursor, and press the middle mouse button to paste the text 159wish, position the cursor, and press the middle mouse button to paste the text
160where you placed the cursor. Note that you can copy and paste without ever 160where you placed the cursor. Note that you can copy and paste without ever
161leaving the terminal you started. This makes posting the output of error 161leaving the terminal you started. This makes posting the output of error
162messages to the <uri link="http://forums.gentoo.org">Gentoo forums</uri> 162messages to the <uri link="http://forums.gentoo.org">Gentoo Forums</uri>
163extremely simple. 163extremely simple.
164</p> 164</p>
165 165
166</body> 166</body>
167</section> 167</section>
168<section> 168<section>
169<title>Text-mode browsing and gpm</title> 169<title>Text-mode browsing and GPM</title>
170<body> 170<body>
171 171
172<p> 172<p>
173If you have a message on one screen and a text-mode web browser on the other, 173If you have a message on one screen and a text-mode web browser on the other,
174you can copy the error message by highlighting it, then change to the other 174you can copy the error message by highlighting it, then change to the other
175terminal, left-click the appropriate text entry box to select it, and then 175terminal, left-click the appropriate text entry box to select it, and then
176press the middle mouse button. Voila! Your error message can now be posted to 176press the middle mouse button. Voilà! Your error message can now be posted to
177the forums. 177the forums.
178</p> 178</p>
179 179
180<p> 180<p>
181Though discussion of text-only browsers is somewhat beyond the scope of this 181Though discussion of text-only browsers is somewhat beyond the scope of this

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.3

  ViewVC Help
Powered by ViewVC 1.1.20