← Back to branch summary

~ubuntu-branches/ubuntu/maverick/gnome-user-docs/maverick-proposed

« back to all changes in this revision

Viewing changes to gnome2-accessibility-guide/C/sysadmin.xml

  • Committer: Bazaar Package Importer
  • Author(s): Matthew East
  • Date: 2007-09-12 07:51:05 UTC
  • Revision ID: james.westby@ubuntu.com-20070912075105-bsc0qzo62eqf4cbm
Tags: 2.18.2+svn20070912ubuntu1
* Substantial restructuring of gnome-access-guide
* Including pot files in source package for Rosetta

Show diffs side-by-side

added added

removed removed

Lines of Context:
gnome2-accessibility-guide/C/sysadmin.xml
5
5
describes some tasks that a system administrator needs to perform to enable
6
6
accessible login and to facilitate the use of the assistive technologies that
7
7
are available in the GNOME Desktop.</para>
8
 
<sect1 id="sysadmin-27">
9
 
<title>Configuring the Desktop for Accessible Login</title>
10
 
<indexterm>
11
 
<primary>accessible login feature</primary>
12
 
</indexterm>
13
 
<para>The GNOME Desktop includes an Accessible
14
 
Login feature. The Accessible Login feature enables users to: </para>
15
 
<itemizedlist>
16
 
<listitem>
17
 
<para>Log in to the desktop even if the user cannot easily use the
18
 
screen, mouse, or keyboard in the usual way.</para>
19
 
</listitem>
20
 
<listitem>
21
 
<para>Launch assistive technologies at login time by associating
22
 
a user action with an assistive technology application. The user can perform
23
 
the user action from the standard keyboard, or from a keyboard, pointing device,
24
 
or switch device that is attached to the USB or PS/2 mouse port. These user
25
 
actions are called gestures.</para>
26
 
</listitem>
27
 
<listitem>
28
 
<para>Change the visual appearance of the login dialog before the
29
 
user logs in, for example, to use a high contrast theme for better visibility. </para>
30
 
</listitem>
31
 
</itemizedlist>
32
 
<sect2 id="sysadmin-34">
33
 
<title>To Enable Accessible Login</title>
34
 
<indexterm>
35
 
<primary>GDM</primary>
36
 
</indexterm>
37
 
<para>To enable the Accessible
38
 
Login feature for the GNOME
39
 
Desktop, you must configure the desktop to use the GNOME Display Manager
40
 
(GDM) as the login manager. GDM is the default login manager on Linux systems
41
 
but not on Solaris systems, therefore the instructions to enable Accessible
42
 
Login differ depending on the platform you are using. </para>
43
 
<sect3 id="sysadmin-38">
44
 
<title>To Enable and Configure GDM on Solaris Systems</title>
45
 
<para>To enable and configure GDM as the login manager on Solaris systems,
46
 
perform the following steps:</para>
47
 
<orderedlist>
48
 
<listitem>
49
 
<para>Log in as the <literal>root</literal> user.</para>
50
 
</listitem>
51
 
<listitem>
52
 
<para>Open the file <filename>/etc/X11/gdm/gdm.conf</filename>.</para>
53
 
</listitem>
54
 
<listitem>
55
 
<para>Search the file for the following line: </para>
56
 
<para>
57
 
<literal>#AddGtkModules=false</literal>
58
 
</para>
59
 
<para>and replace the line with the following:</para>
60
 
<para>
61
 
<literal>AddGtkModules=true</literal>
62
 
</para>
63
 
<para>This step enables the GtkModules.</para>
64
 
</listitem>
65
 
<listitem>
66
 
<para>Search the file for the following line: </para>
67
 
<para>
68
 
<literal>#GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener</literal>
69
 
</para>
70
 
<para>and delete the <literal>#</literal> from the start of the line so that
71
 
the line reads:</para>
72
 
<para>
73
 
<literal>GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener</literal>
74
 
</para>
75
 
<note>
76
 
<para>The above lines must be displayed as single lines in the <filename>gdm.conf</filename> file without line breaks. The formatting of this guide
77
 
may display the lines over two lines.</para>
78
 
</note>
79
 
<para>This step loads all of the GtkModules to enable assistive technologies
80
 
such as <application>On-Screen Keyboard</application> and <application>Screen
81
 
Reader and Magnifier</application>. You can edit the line above further to
82
 
load only the GtkModules that you require to support the user base. For example: </para>
83
 
<itemizedlist>
84
 
<listitem>
85
 
<para>If you need to use the <application>Screen Reader and Magnifier</application>, include <literal>gail</literal> and <literal>atk-bridge</literal>.</para>
86
 
</listitem>
87
 
<listitem>
88
 
<para>If you need to use a pointing device without buttons or switches,
89
 
include <literal>gail</literal>, <literal>atk-bridge</literal>, and<literal>dwellmouselistener</literal>. </para>
90
 
</listitem>
91
 
<listitem>
92
 
<para>If you use pointing devices with switches, alternative physical
93
 
keyboards, or switch and button devices, include <literal>keymouselistener</literal>.</para>
94
 
</listitem>
95
 
<listitem>
96
 
<para><application>On-Screen Keyboard</application> can operate
97
 
without <literal>gail</literal> and <literal>atk-bridge</literal> but with
98
 
a reduced feature set. </para>
99
 
</listitem>
100
 
</itemizedlist>
101
 
<para>For optimum accessibility, include <literal>gail</literal> and <literal>atk-bridge</literal>.</para>
102
 
</listitem>
103
 
<listitem>
104
 
<para>Save the <filename>/etc/X11/gdm/gdm.conf</filename> file.</para>
105
 
</listitem>
106
 
<listitem>
107
 
<para>Enter the following command to stop the <application>dtlogin</application> manager:</para>
108
 
<para>
109
 
<command>/usr/dt/bin/dtconfig -d</command>
110
 
</para>
111
 
</listitem>
112
 
<listitem>
113
 
<para>Enter the following commands to configure GDM as the login
114
 
manager:</para>
115
 
<para>
116
 
<command>svccfg import /var/svc/manifest/application/gdm2-login.xml</command>
117
 
</para>
118
 
<para>
119
 
<command>svcadm enable application/gdm2-login</command>
120
 
</para>
121
 
<note>
122
 
<para>If you make any changes to the <filename>/etc/X11/gdm/gdm.conf</filename> file after you enable GDM, you can execute the following command
123
 
to restart GDM and activate the changes:</para>
124
 
<para>
125
 
<command>gdm-restart</command>
126
 
</para>
127
 
</note>
128
 
</listitem>
129
 
<listitem>
130
 
<para>Edit the file <filename>/etc/passwd</filename> to append the
131
 
following to the end of the <literal>gdm</literal> line:</para>
132
 
<para>
133
 
<literal>:/etc/X11/gdm/home</literal>
134
 
</para>
135
 
</listitem>
136
 
<listitem>
137
 
<para>Create the <literal>/etc/X11/gdm/home</literal> directory
138
 
and assign ownership of the directory to the <literal>gdm</literal> user.</para>
139
 
</listitem>
140
 
<listitem>
141
 
<para>Restart your system.</para>
142
 
</listitem>
143
 
</orderedlist>
144
 
</sect3>
145
 
<sect3 id="sysadmin-39">
146
 
<title>To Configure GDM on Linux Systems</title>
147
 
<para>To configure GDM on Linux systems, perform the following steps:</para>
148
 
<orderedlist>
149
 
<listitem>
150
 
<para>Log in as the <literal>root</literal> user.</para>
151
 
</listitem>
152
 
<listitem>
153
 
<para>Open the file <filename>/etc/X11/gdm/gdm.conf</filename>.</para>
154
 
</listitem>
155
 
<listitem>
156
 
<para>Search the file for the following line: </para>
157
 
<para>
158
 
<literal>#AddGtkModules=false</literal>
159
 
</para>
160
 
<para>and replace the line with the following:</para>
161
 
<para>
162
 
<literal>AddGtkModules=true</literal>
163
 
</para>
164
 
<para>This step enables the GtkModules.</para>
165
 
</listitem>
166
 
<listitem>
167
 
<para>Search the file for the following line: </para>
168
 
<para>
169
 
<literal>#GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener</literal>
170
 
</para>
171
 
<para>and delete the <literal>#</literal> from the start of the line so that
172
 
the line reads:</para>
173
 
<para>
174
 
<literal>GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener</literal>
175
 
</para>
176
 
<note>
177
 
<para>The above lines must be displayed as single lines in the <filename>gdm.conf</filename> file without line breaks. The formatting of this guide
178
 
may display the lines over two lines.</para>
179
 
</note>
180
 
<para>This step loads all of the GtkModules to enable assistive technologies
181
 
such as <application>On-Screen Keyboard</application> and <application>Screen
182
 
Reader and Magnifier</application>. You can edit the line above further to
183
 
load only the GtkModules that you require to support the user base. For example: </para>
184
 
<itemizedlist>
185
 
<listitem>
186
 
<para>If you need to use the <application>Screen Reader and Magnifier</application>, include <literal>gail</literal> and <literal>atk-bridge</literal>.</para>
187
 
</listitem>
188
 
<listitem>
189
 
<para>If you need to use a pointing device without buttons or switches,
190
 
include <literal>gail</literal>, <literal>atk-bridge</literal>, and <literal>dwellmouselistener</literal>. </para>
191
 
</listitem>
192
 
<listitem>
193
 
<para>If you use pointing devices with switches, alternative physical
194
 
keyboards, or switch and button devices, include <literal>keymouselistener</literal>.</para>
195
 
</listitem>
196
 
<listitem>
197
 
<para><application>On-Screen Keyboard</application> can operate
198
 
without <literal>gail</literal> and <literal>atk-bridge</literal> but with
199
 
a reduced feature set. </para>
200
 
</listitem>
201
 
</itemizedlist>
202
 
<para>For optimum accessibility, include <literal>gail</literal> and <literal>atk-bridge</literal>.</para>
203
 
</listitem>
204
 
<listitem>
205
 
<para>Save the <filename>/etc/X11/gdm/gdm.conf</filename> file.</para>
206
 
<note>
207
 
<para>If you make any changes to the <filename>/etc/X11/gdm/gdm.conf</filename> file after you enable GDM, you can execute the following command
208
 
to restart GDM and activate the changes:</para>
209
 
<para>
210
 
<command>gdm-restart</command>
211
 
</para>
212
 
</note>
213
 
</listitem>
214
 
<listitem>
215
 
<para>Edit the file <filename>/etc/group</filename> and append the
216
 
following to the <literal>audio</literal> line:</para>
217
 
<para>
218
 
<literal>,gdm</literal>
219
 
</para>
220
 
<para>This step ensures that speech works with GDM.</para>
221
 
</listitem>
222
 
<listitem>
223
 
<para>Restart your system.</para>
224
 
</listitem>
225
 
</orderedlist>
226
 
</sect3>
227
 
</sect2>
228
 
<sect2 id="sysadmin-29">
229
 
<title>To Start Assistive Technologies at Login</title>
230
 
<indexterm>
231
 
<primary>gestures</primary>
232
 
</indexterm>
233
 
<para>If you load the <literal>keymouselistener</literal> and <literal>dwellmouselistener</literal> GtkModules
234
 
in the GDM configuration file, you can assign user actions to launch specific
235
 
assistive technologies at login time. These user actions are called gestures.
236
 
The gesture associations are contained in the following GDM configuration
237
 
files: </para>
238
 
<itemizedlist>
239
 
<listitem>
240
 
<para>
241
 
<filename>/etc/X11/gdm/modules/AccessKeyMouseEvents</filename>
242
 
</para>
243
 
</listitem>
244
 
<listitem>
245
 
<para>
246
 
<filename>/etc/X11/gdm/modules/AccessDwellMouseEvents</filename>
247
 
</para>
248
 
</listitem>
249
 
</itemizedlist>
250
 
<note>
251
 
<para>If you modify these files, you must restart your system before
252
 
the changes take effect.</para>
253
 
</note>
254
 
<para>The following sections contain examples of the gestures that you can
255
 
add to the GDM configuration files.</para>
256
 
<note>
257
 
<para>The gestures must be contained in a single line in the <filename>AccessKeyMouseEvents</filename> file without line breaks. The formatting of
258
 
this guide might display the examples in the following sections over two lines. </para>
259
 
</note>
260
 
<sect3 id="sysadmin-30">
261
 
<title>To Start Screen Reader Using a Keyboard Shortcut</title>
262
 
<para>Edit the <filename>AccessKeyMouseEvents</filename> file to associate
263
 
keyboard shortcuts with assistive technologies. For example, the following
264
 
line enables you to press-and-hold <keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>
265
 
for one second to start <application>Screen Reader and Magnifier</application>
266
 
in speech and Braille mode:</para>
267
 
<para>
268
 
<emphasis>Solaris:</emphasis>
269
 
</para>
270
 
<para>
271
 
<literal>&lt;Control&gt;s 1 1000 10000 /usr/sfw/bin/srcore --login --disable-magnifier
272
 
--enable-speech --enable-braille</literal>
273
 
</para>
274
 
<para>
275
 
<emphasis>Linux:</emphasis>
276
 
</para>
277
 
<para>
278
 
<literal>&lt;Control&gt;s 1 1000 10000 srcore --login --disable-magnifier
279
 
--enable-speech --enable-braille</literal>
280
 
</para>
281
 
</sect3>
282
 
<sect3 id="sysadmin-41">
283
 
<title>To Start Magnifier Using a Keyboard Shortcut</title>
284
 
<para>Edit the <filename>AccessKeyMouseEvents</filename> file to associate
285
 
keyboard shortcuts with assistive technologies. For example, the following
286
 
line enables you to press-and-hold <keycombo><keycap>Ctrl</keycap><keycap>M</keycap></keycombo>
287
 
for one second to start <application>Screen Reader and Magnifier</application>
288
 
in magnifier mode:</para>
289
 
<para>
290
 
<emphasis>Solaris:</emphasis>
291
 
</para>
292
 
<para>
293
 
<literal>&lt;Control&gt;m 1 1000 10000 /usr/sfw/bin/srcore --login --enable-magnifier
294
 
--disable-speech</literal>
295
 
</para>
296
 
<para>
297
 
<emphasis>Linux:</emphasis>
298
 
</para>
299
 
<para>
300
 
<literal>&lt;Control&gt;m 1 1000 10000 srcore --login --enable-magnifier
301
 
--disable-speech</literal>
302
 
</para>
303
 
</sect3>
304
 
<sect3 id="sysadmin-31">
305
 
<title>To Start On-Screen Keyboard Using a Switch or Button Gesture</title>
306
 
<para>Edit the <filename>AccessKeyMouseEvents</filename> file to associate
307
 
switch, key, or button gestures with assistive technologies. Since the primary
308
 
input device for many <application>On-Screen Keyboard</application> users
309
 
is a switch or button, this is a good way to enable users to start <application>On-Screen Keyboard</application> at login time. </para>
310
 
<para>If there is a tendency for a user to start an application unintentionally,
311
 
you can associate the gestures with multiple switch presses or minimum durations.
312
 
For example, the following line starts <application>On-Screen Keyboard</application>
313
 
in inverse scanning mode when the user presses the switch that is defined
314
 
as Switch 2 three times within two seconds, for a minimum of 100 milliseconds
315
 
for each press:</para>
316
 
<para>
317
 
<emphasis>Solaris:</emphasis>
318
 
</para>
319
 
<para>
320
 
<literal>&lt;Switch2&gt;3 100 2000 /usr/sfw/bin/gok --login --accessmethod=inversescanning
321
 
--scan-action=switch1 --select-action=switch2</literal>
322
 
</para>
323
 
<para>
324
 
<emphasis>Linux:</emphasis>
325
 
</para>
326
 
<para>
327
 
<literal>&lt;Switch2&gt;3 100 2000 gok --login --accessmethod=inversescanning
328
 
--scan-action=switch1 --select-action=switch2</literal>
329
 
</para>
330
 
<para>Users who use single switches may prefer to start <application>On-Screen
331
 
Keyboard</application> in automatic scanning mode. The following line starts <application>On-Screen Keyboard</application> in automatic scanning mode when the user
332
 
presses the switch on an alternative access device for more than four seconds:</para>
333
 
<para>
334
 
<emphasis>Solaris:</emphasis>
335
 
</para>
336
 
<para>
337
 
<literal>&lt;Switch&gt;1 4000 5000 /usr/sfw/bin/gok --login --accessmethod=automaticscanning
338
 
--scan-action=switch1 --select-action=switch1</literal>
339
 
</para>
340
 
<para>
341
 
<emphasis>Linux:</emphasis>
342
 
</para>
343
 
<para>
344
 
<literal>&lt;Switch&gt;1 4000 5000 gok --login --accessmethod=automaticscanning
345
 
--scan-action=switch1 --select-action=switch1</literal>
346
 
</para>
347
 
<para>For information about the <application>On-Screen Keyboard</application>
348
 
operating modes, see the online Help for <application>On-Screen Keyboard</application>.</para>
349
 
</sect3>
350
 
<sect3 id="sysadmin-32">
351
 
<title>To Start On-Screen Keyboard Using a Motion-only Gesture</title>
352
 
<para>You can define gestures that involve only the motion of a pointing device
353
 
such as a mouse, or an alternative pointing device, such as a head pointer
354
 
or trackball. The syntax of the gesture does not change depending on whether
355
 
you are using a mouse or an alternative pointing device. Edit the <filename>AccessKeyMouseEvents</filename> file to associate motion gestures with assistive
356
 
technologies.</para>
357
 
<para>If the <literal>dwellmouselistener</literal> GtkModule is loaded, alternative
358
 
pointing devices are temporarily latched to the core pointer. This means that
359
 
if the user moves the alternative pointing device, the onscreen pointer moves.</para>
360
 
<para>For example, the following line starts <application>On-Screen Keyboard</application> in dwell mode when the user moves the onscreen pointer from
361
 
inside the login dialog through the top edge, back into the dialog through
362
 
the top edge, out of the dialog through the left edge, back into the dialog
363
 
through the left edge, and similarly through the bottom and right edges of
364
 
the dialog in a cross pattern:</para>
365
 
<para>
366
 
<emphasis>Solaris:</emphasis>
367
 
</para>
368
 
<para>
369
 
<literal>TTLLBBRR O 10000 /usr/sfw/bin/gok --login --access-method=dwellselection
370
 
--input-device=MOUSE[3]</literal>
371
 
</para>
372
 
<para>
373
 
<emphasis>Linux:</emphasis>
374
 
</para>
375
 
<para>
376
 
<literal>TTLLBBRR O 10000 gok --login --access-method=dwellselection
377
 
--input-device=MOUSE[3]</literal>
378
 
</para>
379
 
<para>Note that the <literal>--input-device</literal> parameter specified
380
 
in the gesture must match the name of the extended user input device, such
381
 
as a head pointer or trackball, as specified in <filename>/etc/X11/XF86Config</filename>.</para>
382
 
</sect3>
383
 
</sect2>
384
 
<sect2 id="sysadmin-33">
385
 
<title>Additional Requirements for Accessible Login</title>
386
 
<para>To enable the Accessible Login feature to use alternative pointing devices
387
 
and switch devices such as sip-and-puff switches, wheelchair-mounted switches,
388
 
or trackballs, you might need to modify your X server system configuration
389
 
to recognize these devices. You can use most devices that emulate mouse buttons
390
 
with the Accessible Login feature and <application>On-Screen Keyboard</application>,
391
 
including USB single switches and mouse-like pointing devices.</para>
392
 
<note>
393
 
<para>You should not configure an alternative input device to control
394
 
the primary onscreen pointer. This might result in undesirable behavior or
395
 
cause situations from which the user of the alternate input device cannot
396
 
recover without using the primary keyboard or mouse. To prevent this problem,
397
 
please remove any occurrences of the attributes <literal>SendCore</literal>
398
 
or <literal>AlwaysCore</literal> from any of <literal>InputDevice</literal>
399
 
lines in the X Server configuration file.</para>
400
 
</note>
401
 
</sect2>
402
 
</sect1>
403
 
<sect1 id="sysadmin-7">
404
 
<title>Configuring the Java Environment for Accessibility on Solaris Systems</title>
405
 
<indexterm>
406
 
<primary>Java environment, configuring</primary>
407
 
</indexterm>
408
 
<para>To configure the Java environment on Solaris systems for accessibility, perform
409
 
the following steps:</para>
410
 
<orderedlist>
411
 
<listitem>
412
 
<para>Log in as the <literal>root</literal> user to the base directory
413
 
of the Java SDK installation. </para>
414
 
</listitem>
415
 
<listitem>
416
 
<para>Enter the following command:</para>
417
 
<para>
418
 
<command>cd jre/lib</command>
419
 
</para>
420
 
</listitem>
421
 
<listitem>
422
 
<para>Enter the following command:</para>
423
 
<para>
424
 
<command>ln -s /usr/share/jar/accessibility.properties</command>
425
 
</para>
426
 
</listitem>
427
 
<listitem>
428
 
<para>Enter the following command:</para>
429
 
<para>
430
 
<command>cd ext</command>
431
 
</para>
432
 
</listitem>
433
 
<listitem>
434
 
<para>Enter the following command: </para>
435
 
<para>
436
 
<command>ln -s /usr/share/jar/gnome-java-bridge.jar</command>
437
 
</para>
438
 
</listitem>
439
 
</orderedlist>
440
 
</sect1>
441
 
<sect1 id="sysadmin-55">
442
 
<title>Enabling XKB on Solaris Systems</title>
443
 
<indexterm>
444
 
<primary>XKB</primary>
445
 
</indexterm>
446
 
<para>If you are using the desktop
447
 
for the Solaris operating system on a SPARC platform, you must enable XKB
448
 
on your system before you can use the <application>AccessX</application> preference
449
 
tool, <application>Screen Reader and Magnifier</application>, or <application>On-Screen Keyboard</application>. </para>
450
 
<note>
451
 
<para>XKB is not currently supported on Sun Ray systems.</para>
452
 
</note>
453
 
<para>To enable XKB on a non-Sun Ray Solaris system, perform the following
454
 
steps:</para>
455
 
<orderedlist>
456
 
<listitem>
457
 
<para>Log in as the <literal>root</literal> user.</para>
458
 
</listitem>
459
 
<listitem>
460
 
<para>Check if the path and file <filename>/etc/dt/config/Xservers</filename> exists on your system.</para>
461
 
</listitem>
462
 
<listitem>
463
 
<para>If the <filename>/etc/dt/config</filename> directory does
464
 
not exist, enter the following command:</para>
465
 
<screen>
466
 
<command>mkdir -p /etc/dt/config</command>
467
 
</screen>
468
 
</listitem>
469
 
<listitem>
470
 
<para>If the <filename>Xservers</filename> file is not present,
471
 
enter the following command:</para>
472
 
<screen>
473
 
<command>cp /usr/dt/config/Xservers /etc/dt/config/Xservers</command>
474
 
</screen>
475
 
</listitem>
476
 
<listitem>
477
 
<para>Open the <filename>Xservers</filename> file in a text editor
478
 
and scroll to the end of the file. </para>
479
 
</listitem>
480
 
<listitem>
481
 
<para>Append the following to the command line at the end of the
482
 
file:</para>
483
 
<screen>
484
 
<userinput>+kb</userinput>
485
 
</screen>
486
 
</listitem>
487
 
<listitem>
488
 
<para>Save and close the <filename>Xservers</filename> file.</para>
489
 
</listitem>
490
 
<listitem>
491
 
<para>Enter the following command at a command line:</para>
492
 
<screen>
493
 
<command>pkill -HUP dtlogin</command>
494
 
</screen>
495
 
</listitem>
496
 
<listitem>
497
 
<para>Open the <filename>/etc/X11/gdm/gdm.conf</filename> file in
498
 
a text editor.</para>
499
 
</listitem>
500
 
<listitem>
501
 
<para>Scroll towards the end of the file until you see the line <literal>[server - standard]</literal>.</para>
502
 
</listitem>
503
 
<listitem>
504
 
<para>Edit the <literal>command</literal> line in this section to
505
 
append the following to the end of the line:</para>
506
 
<para>
507
 
<command>+accessx +kb</command>
508
 
</para>
509
 
</listitem>
510
 
<listitem>
511
 
<para>Save and close the <filename>gdm.conf</filename> file.</para>
512
 
</listitem>
513
 
<listitem>
514
 
<para>Log out of your session and log in again.</para>
515
 
</listitem>
516
 
<listitem>
517
 
<para>To verify if XKB is running, execute the following command: </para>
518
 
<para>
519
 
<command>xdpyinfo</command>
520
 
</para>
521
 
<para>then search for XKEYBOARD in the extensions list.</para>
522
 
</listitem>
523
 
</orderedlist>
524
 
</sect1>
525
8
<sect1 id="sysadmin-6">
526
9
<title>Enabling Full Screen Magnification</title>
527
10
<indexterm>
697
180
</indexterm>
698
181
<para>To enable
699
182
your system to support Braille output, you must configure the access rights
700
 
to the serial port to which the Braille device is connected. The following
701
 
sections describe the steps that you need to perform depending on your operating
702
 
system.</para>
703
 
<sect2 id="sysadmin-53">
704
 
<title>To Enable Braille on Solaris Systems</title>
705
 
<para>To configure the serial port to which the Braille device is connected
706
 
on Solaris systems, perform the following steps:</para>
707
 
<orderedlist>
708
 
<listitem>
709
 
<para>Log in as the <literal>root</literal> user.</para>
710
 
</listitem>
711
 
<listitem>
712
 
<para>Enter the following command:</para>
713
 
<para>
714
 
<command>chmod 777 /dev/cua/a</command>
715
 
</para>
716
 
</listitem>
717
 
<listitem>
718
 
<para>Enter the following command:</para>
719
 
<para>
720
 
<command>chmod 777 /dev/cua/b</command>
721
 
</para>
722
 
</listitem>
723
 
<listitem>
724
 
<para>Change the permissions to <literal>777</literal> on the devices
725
 
to which the symbolic links <literal>/dev/cua/a</literal> and <literal>/dev/cua/b</literal> point. </para>
726
 
</listitem>
727
 
</orderedlist>
728
 
<note>
729
 
<para>If your system uses <command>/dev/cua/a</command> for system log
730
 
messages, Braille will not work on that serial port. Use <command>/dev/cua/b</command> instead.</para>
731
 
</note>
732
 
</sect2>
733
 
<sect2 id="sysadmin-54">
734
 
<title>To Enable Braille on Linux Systems</title>
735
 
<para>To configure the serial port to which the Braille device is connected
736
 
on Linux systems, perform the following steps:</para>
 
183
to the serial port to which the Braille device is connected. To do that:</para>
737
184
<orderedlist>
738
185
<listitem>
739
186
<para>Log in as the <literal>root</literal> user.</para>
751
198
</para>
752
199
</listitem>
753
200
</orderedlist>
754
 
</sect2>
755
201
</sect1>
756
202
<sect1 id="sysadmin-37">
757
203
<title>Configuring Alternative Pointer Devices</title>
 
204
<indexterm>
 
205
<primary>configuring two pointer devices</primary>
 
206
<secondary>on
 
207
Linux systems</secondary>
 
208
</indexterm>
758
209
<para>The following sections describe how to configure your system to use
759
210
a standard physical mouse and another pointer device such as a single switch
760
211
device or head tracker device, and how to configure <application>On-Screen
761
212
Keyboard</application> to use the second pointer device.</para>
762
 
<sect2 id="sysadmin-45">
763
 
<title>To Configure Alternative Pointer Devices on Solaris Systems</title>
764
 
<indexterm>
765
 
<primary>configuring two pointer devices</primary>
766
 
<secondary>on
767
 
Solaris systems</secondary>
768
 
</indexterm>
769
 
<para>To configure an alternative pointer
770
 
device on a Solaris system, perform the following steps:</para>
771
 
<note>
772
 
<para>This procedure does not work on all Solaris platforms.</para>
773
 
</note>
774
 
<orderedlist>
775
 
<listitem>
776
 
<para>Before you connect the alternative pointer device to your
777
 
system, enter the following command to list the existing devices:</para>
778
 
<para>
779
 
<command>ls -l /dev/usb/hid*</command>
780
 
</para>
781
 
</listitem>
782
 
<listitem>
783
 
<para>Connect the alternative pointer device to your system.</para>
784
 
</listitem>
785
 
<listitem>
786
 
<para>Enter the following command again to list the new device:</para>
787
 
<para>
788
 
<command>ls -l /dev/usb/hid*</command>
789
 
</para>
790
 
</listitem>
791
 
<listitem>
792
 
<para>Open the file <filename>/usr/openwin/server/etc/OWconfig</filename>.</para>
793
 
</listitem>
794
 
<listitem>
795
 
<para>Add the following lines to the <filename>OWconfig</filename>
796
 
file:</para>
797
 
<para>
798
 
<literallayout># Sun Mouse module
799
 
class=&quot;XINPUT&quot; name=&quot;IMOUSE2&quot;
800
 
dev=&quot;/dev/usb/hid2&quot; strmod=&quot;usbms&quot;
801
 
ddxHandler=&quot;ddxSUNWmouse.so.1&quot;
802
 
ddxInitFunc=&quot;ddxSUNWmouseProc&quot;;</literallayout>
803
 
</para>
804
 
<para>where:</para>
805
 
<itemizedlist>
806
 
<listitem>
807
 
<para>the <literal>name</literal> option starts with the string <literal>IMOUSE</literal> but is extended to form a unique string, such as <literal>IMOUSE2</literal> or <literal>IMOUSE3</literal>, depending on the number of
808
 
existing devices.</para>
809
 
</listitem>
810
 
<listitem>
811
 
<para>the <literal>dev</literal> option specifies the device name
812
 
that you identified in Step 3.</para>
813
 
</listitem>
814
 
</itemizedlist>
815
 
</listitem>
816
 
<listitem>
817
 
<para>Remove the following lines from the <filename>OWconfig</filename>
818
 
file:</para>
819
 
<para>
820
 
<literallayout># Null Mouse module
821
 
class=&quot;XINPUT&quot; name=&quot;NMOUSE&quot;
822
 
ddxHandler=&quot;ddxSUNWmouse.so.1&quot;
823
 
ddxInitFunc=&quot;ddxnullmouseProc&quot;;</literallayout>
824
 
</para>
825
 
</listitem>
826
 
<listitem>
827
 
<para>Save the <filename>/usr/openwin/server/etc/OWconfig</filename>
828
 
file.</para>
829
 
</listitem>
830
 
<listitem>
831
 
<para>Restart the X Server. </para>
832
 
</listitem>
833
 
</orderedlist>
834
 
</sect2>
835
 
<sect2 id="sysadmin-46">
836
 
<title>To Configure Alternative Pointer Devices on Linux Systems</title>
837
 
<indexterm>
838
 
<primary>configuring two pointer devices</primary>
839
 
<secondary>on
840
 
Linux systems</secondary>
841
 
</indexterm>
842
 
<para>To configure an alternative pointer
843
 
device on a Linux system, perform the following steps:</para>
 
213
<para>To configure an alternative pointer
 
214
device, perform the following steps:</para>
844
215
<orderedlist>
845
216
<listitem>
846
217
<para>Before you connect the alternative pointer device to your
934
305
<para>Restart the X Server.</para>
935
306
</listitem>
936
307
</orderedlist>
937
 
</sect2>
938
308
<sect2 id="sysadmin-47">
939
309
<title>To Configure On-Screen Keyboard to Use an Alternative Pointer Device</title>
940
310
<indexterm>