← Back to branch summary

~ubuntu-branches/ubuntu/karmic/installation-guide/karmic

« back to all changes in this revision

Viewing changes to en/appendix/files.xml

  • Committer: Bazaar Package Importer
  • Author(s): Colin Watson
  • Date: 2007-07-23 15:52:44 UTC
  • mfrom: (2.1.1 etch)
  • Revision ID: james.westby@ubuntu.com-20070723155244-xayq1rzu8rllvngy
Tags: 20070319ubuntu1
https://launchpad.net/bugs/119177
* Resynchronise with Debian. Remaining changes:
  - Build only English (for now, until we figure out how to avoid trashing
    translations quite so badly with Ubuntu branding etc.).
  - Build only Ubuntu architectures (amd64, hppa, i386, ia64, powerpc,
    sparc).
  - Extensive (although possibly incomplete) Ubuntu branding, adjustments
    for our mirror layout, etc.
  - Add "Ubuntu and Debian" and "What is Ubuntu?" section, text borrowed
    from the Ubuntu web site. Disable the "What is Debian GNU/Linux?"
    section.
  - Direct installation reports to ubuntu-users for now.
  - Adjust various memory and disk space requirements. Talk about the
    default Ubuntu desktop and Ubuntu tasks rather than Debian tasks.
  - Document mounting /sys in various places.
  - Unset supports-floppy-boot for all our architectures.
  - Add a few more supports-floppy-boot and bootable-usb conditionals.
  - Document our root password and sudo arrangements.
  - Document netboot-style USB images. Still mention the hd-media images,
    but they're downplayed since many USB sticks are too small for a full
    Ubuntu ISO image.
  - Document Kickstart installations (currently only the basics, a
    reference to Red Hat's documentation, and the differences from
    Anaconda).
  - Note that an empty preseed file is equivalent to a normal manual
    installation.
  - Rename doc-base.TEMPLATE to TEMPLATE.doc-base.
  - Update keyboard preseeding documentation for console-setup.
  - Update chroot-install guide for console-setup and language packs; add
    a bit more advice about installing grub.
  - Remove text talking about devfs-style device names, which are no
    longer supported.
  - Fix links to web copies of installation manual and example preseed
    file.
* Bump kernelversion to 2.6.22.
* Bump x11ver to 7.3.
* Bump GNOME version to 2.20.
* Bump release version and names for Gutsy (LP: #119177).
* Refer to the standard task rather than ubuntu-standard.
* Disable documentation of the GTK frontend.
* Remove latex-hangul-ucs-hlatex build-dependency, as we don't build for
  Korean.

Show diffs side-by-side

added added

removed removed

Lines of Context:
en/appendix/files.xml
1
1
<!-- retain these comments for translator revision tracking -->
2
 
<!-- $Id: files.xml 33887 2006-01-09 10:09:48Z cjwatson $ -->
 
2
<!-- $Id: files.xml 44436 2007-01-23 19:23:09Z fjp $ -->
3
3
 
4
4
 
5
5
 <sect1 id="linuxdevices"><title>Linux Devices</title>
6
6
<para>
7
7
 
8
 
In Linux you have various special files in
9
 
<filename>/dev</filename>. These files are called device files. In
10
 
the Unix world accessing hardware is different.  There you have a
11
 
special file which actually runs a driver which in turn accesses the
12
 
hardware. The device file is an interface to the actual system
13
 
component. Files under <filename>/dev</filename> also behave
14
 
differently than ordinary files. Below are the most important device
15
 
files listed.
 
8
In Linux various special files can be found under the directory
 
9
<filename>/dev</filename>. These files are called device files and
 
10
behave unlike ordinary files. The most common types of device files
 
11
are for block devices and character devices. These files are an
 
12
interface to the actual driver (part of the Linux kernel) which in
 
13
turn accesses the hardware. Another, less common, type of device file
 
14
is the named <firstterm>pipe</firstterm>.
 
15
The most important device files are listed in the tables below.
16
16
 
17
17
</para><para>
18
18
 
106
106
<informaltable><tgroup cols="2"><tbody>
107
107
<row>
108
108
  <entry><filename>null</filename></entry>
109
 
  <entry>Everything pointed to this device will disappear</entry>
 
109
  <entry>Anything written to this device will disappear</entry>
110
110
</row><row>
111
111
  <entry><filename>zero</filename></entry>
112
112
  <entry>One can endlessly read zeros out of this device</entry>
115
115
 
116
116
</para>
117
117
 
118
 
  <sect2>
119
 
<title>Setting Up Your Mouse</title>
120
 
 
121
 
<para>
122
 
 
123
 
The mouse can be used in both the Linux console (with gpm) and the X window
124
 
environment. The two uses can be made compatible if the gpm repeater is used
125
 
to allow the signal to flow to the X server as shown:
126
 
 
127
 
<informalexample><screen>
128
 
mouse =&gt; /dev/psaux  =&gt; gpm =&gt; /dev/gpmdata -&gt; /dev/mouse =&gt; X
129
 
         /dev/ttyS0             (repeater)        (symlink)
130
 
         /dev/ttyS1
131
 
</screen></informalexample>
132
 
 
133
 
Set the repeater protocol to be raw (in <filename>/etc/gpm.conf</filename>) while
134
 
setting X to the original mouse protocol in <filename>/etc/X11/XF86Config</filename>
135
 
or <filename>/etc/X11/XF86Config-4</filename>.
136
 
 
137
 
</para><para>
138
 
 
139
 
This approach to use gpm even in X has advantages when the mouse is
140
 
unplugged inadvertently.  Simply restarting gpm with
141
 
 
142
 
<informalexample><screen>
143
 
# /etc/init.d/gpm restart
144
 
</screen></informalexample>
145
 
 
146
 
will re-connect the mouse in software without restarting X.
147
 
 
148
 
</para><para>
149
 
 
150
 
If gpm is disabled or not installed with some reason, make sure to set X to
151
 
read directly from the mouse device such as /dev/psaux. For details, refer
152
 
to the 3-Button Mouse mini-Howto at
153
 
<filename>/usr/share/doc/HOWTO/en-txt/mini/3-Button-Mouse.gz</filename>,
154
 
<userinput>man gpm</userinput>,
155
 
<filename>/usr/share/doc/gpm/FAQ.gz</filename>, and
156
 
<ulink url="&url-xorg;current/doc/html/mouse.html">README.mouse</ulink>.
157
 
 
158
 
</para><para arch="powerpc">
159
 
 
160
 
For PowerPC, in <filename>/etc/X11/XF86Config</filename> or
161
 
<filename>/etc/X11/XF86Config-4</filename>, set the mouse device to
162
 
<userinput>"/dev/input/mice"</userinput>.
163
 
 
164
 
</para><para arch="powerpc">
 
118
  <sect2 arch="not-s390" id="device-mouse">
 
119
  <title>Setting Up Your Mouse</title>
 
120
<para>
 
121
 
 
122
The mouse can be used in both the Linux console (with gpm) and the X
 
123
window environment. Normally, this is a simple matter of installing
 
124
<filename>gpm</filename> and the X server itself. Both should be
 
125
configured to use <filename>/dev/input/mice</filename> as the mouse
 
126
device. The correct mouse protocol is named <userinput>exps2</userinput>
 
127
in gpm, and <userinput>ExplorerPS/2</userinput> in X. The respective
 
128
configuration files are <filename>/etc/gpm.conf</filename> and
 
129
<filename>/etc/X11/xorg.conf</filename>.
 
130
 
 
131
</para><para>
 
132
 
 
133
Certain kernel modules must be loaded in order for your mouse to work.
 
134
In most cases the correct modules are autodetected, but not always for
 
135
old-style serial and bus mice<footnote>
 
136
 
 
137
<para>
 
138
Serial mice usually have a 9-hole D-shaped connector; bus mice have an
 
139
8-pin round connector, not to be confused with the 6-pin round connector
 
140
of a PS/2 mouse or the 4-pin round connector of an ADB mouse.
 
141
</para>
 
142
 
 
143
</footnote>, which are quite rare except on very old computers. Summary
 
144
of Linux kernel modules needed for different mouse types:
 
145
 
 
146
<informaltable><tgroup cols="2"><thead>
 
147
<row>
 
148
  <entry>Module</entry>
 
149
  <entry>Description</entry>
 
150
</row>
 
151
</thead><tbody>
 
152
<row>
 
153
  <entry>psmouse</entry>
 
154
  <entry>PS/2 mice (should be autodetected)</entry>
 
155
</row>
 
156
<row>
 
157
  <entry>usbhid</entry>
 
158
  <entry>USB mice (should be autodetected)</entry>
 
159
</row>
 
160
<row>
 
161
  <entry>sermouse</entry>
 
162
  <entry>Most serial mice</entry>
 
163
</row>
 
164
<row>
 
165
  <entry>logibm</entry>
 
166
  <entry>Bus mouse connected to Logitech adapter card</entry>
 
167
</row>
 
168
<row>
 
169
  <entry>inport</entry>
 
170
  <entry>Bus mouse connected to ATI or Microsoft InPort card</entry>
 
171
</row>
 
172
</tbody></tgroup></informaltable>
 
173
 
 
174
To load a mouse driver module, you can use the <command>modconf</command>
 
175
command (from the package with the same name) and look in the category
 
176
<userinput>kernel/drivers/input/mouse</userinput>.
 
177
 
 
178
</para><para arch="powerpc">
 
179
<!-- FJP 20070122: Unsure if this is still valid -->
165
180
 
166
181
Modern kernels give you the capability to emulate a three-button mouse
167
182
when your mouse only has one button. Just add the following lines to
184
199
 
185
200
 <sect1 id="tasksel-size-list">
186
201
 <title>Disk Space Needed for Tasks</title>
187
 
 
188
 
<!-- Note for d-i and manual maintainers
189
 
 Sizes of tasks should be determined by running "tasksel new" on a system
190
 
 that been fully installed without selecting any tasks. By selecting a
191
 
 task together with the "manual selection" option, aptitude will be started
192
 
 and show the sizes for the task. After deselecting the packages to be
193
 
 installed, quit aptitude and repeat for other tasks.
194
 
 Space requirements need to be determined from tasksel as tasksel will not
195
 
 install recommended packages while selecting a task from aptitude will.
196
 
-->
197
 
 
198
 
<para>
199
 
 
200
 
The base installation for i386 using the default 2.4 kernel,
201
 
including all standard packages, requires 573MB of disk space.
202
 
 
203
 
</para><para>
 
202
<para>
 
203
 
 
204
A standard installation for the i386 architecture, including all standard
 
205
packages and using the default 2.6 kernel, takes up &std-system-size;MB of disk space.
 
206
A minimal base installation, without the <quote>Standard system</quote>
 
207
task selected, will take &base-system-size;MB.
 
208
 
 
209
</para>
 
210
<important><para>
 
211
 
 
212
In both cases this is the actual disk space used <emphasis>after</emphasis>
 
213
the installation is finished and any temporary files deleted. It also does
 
214
not take into account overhead used by the file system, for example for
 
215
journal files. This means that significantly more disk space is needed both
 
216
<emphasis>during</emphasis> the installation and for normal system use.
 
217
 
 
218
</para></important>
 
219
<para>
204
220
 
205
221
The following table lists sizes reported by aptitude for the tasks listed
206
222
in tasksel. Note that some tasks have overlapping constituents, so the
210
226
</para><para>
211
227
 
212
228
Note that you will need to add the sizes listed in the table to the size
213
 
of the base installation when determining the size of partitions.
 
229
of the standard installation when determining the size of partitions.
214
230
Most of the size listed as <quote>Installed size</quote> will end up in
215
 
<filename>/usr</filename>; the size listed as <quote>Download size</quote>
 
231
<filename>/usr</filename> and in <filename>/lib</filename>;
 
232
the size listed as <quote>Download size</quote>
216
233
is (temporarily) required in <filename>/var</filename>.
217
234
 
218
235
</para><para>
229
246
 
230
247
<tbody>
231
248
<row>
232
 
  <entry>Desktop</entry>
233
 
  <entry>1392</entry>
234
 
  <entry>460</entry>
235
 
  <entry>1852</entry>
 
249
  <entry>Desktop environment</entry>
 
250
  <entry>&task-desktop-inst;</entry>
 
251
  <entry>&task-desktop-dl;</entry>
 
252
  <entry>&task-desktop-tot;</entry>
 
253
</row>
 
254
 
 
255
<row>
 
256
  <entry>Laptop<footnote>
 
257
  
 
258
  <para>
 
259
  There is a large overlap of the Laptop task with the Destop environment task.
 
260
  If you install both, the Laptop task will only require a few MB additional
 
261
  disk space.
 
262
  </para>
 
263
 
 
264
  </footnote></entry>
 
265
  <entry>&task-laptop-inst;</entry>
 
266
  <entry>&task-laptop-dl;</entry>
 
267
  <entry>&task-laptop-tot;</entry>
236
268
</row>
237
269
 
238
270
<row>
239
271
  <entry>Web server</entry>
240
 
  <entry>36</entry>
241
 
  <entry>12</entry>
242
 
  <entry>48</entry>
 
272
  <entry>&task-web-inst;</entry>
 
273
  <entry>&task-web-dl;</entry>
 
274
  <entry>&task-web-tot;</entry>
243
275
</row>
244
276
 
245
277
<row>
246
278
  <entry>Print server</entry>
247
 
  <entry>168</entry>
248
 
  <entry>58</entry>
249
 
  <entry>226</entry>
 
279
  <entry>&task-print-inst;</entry>
 
280
  <entry>&task-print-dl;</entry>
 
281
  <entry>&task-print-tot;</entry>
250
282
</row>
251
283
 
252
284
<row>
253
285
  <entry>DNS server</entry>
254
 
  <entry>2</entry>
255
 
  <entry>1</entry>
256
 
  <entry>3</entry>
 
286
  <entry>&task-dns-inst;</entry>
 
287
  <entry>&task-dns-dl;</entry>
 
288
  <entry>&task-dns-tot;</entry>
257
289
</row>
258
290
 
259
291
<row>
260
292
  <entry>File server</entry>
261
 
  <entry>47</entry>
262
 
  <entry>24</entry>
263
 
  <entry>71</entry>
 
293
  <entry>&task-file-inst;</entry>
 
294
  <entry>&task-file-dl;</entry>
 
295
  <entry>&task-file-tot;</entry>
264
296
</row>
265
297
 
266
298
<row>
267
299
  <entry>Mail server</entry>
268
 
  <entry>10</entry>
269
 
  <entry>3</entry>
270
 
  <entry>13</entry>
 
300
  <entry>&task-mail-inst;</entry>
 
301
  <entry>&task-mail-dl;</entry>
 
302
  <entry>&task-mail-tot;</entry>
271
303
</row>
272
304
 
273
305
<row>
274
306
  <entry>SQL database</entry>
275
 
  <entry>66</entry>
276
 
  <entry>21</entry>
277
 
  <entry>87</entry>
 
307
  <entry>&task-sql-inst;</entry>
 
308
  <entry>&task-sql-dl;</entry>
 
309
  <entry>&task-sql-tot;</entry>
278
310
</row>
279
311
 
280
312
</tbody>
282
314
 
283
315
<note><para>
284
316
 
285
 
The <emphasis>Desktop</emphasis> task will install both the Gnome and KDE
286
 
desktop environments.
 
317
The <emphasis>Desktop</emphasis> task will install the GNOME desktop
 
318
environment.
287
319
 
288
320
</para></note>
289
321
 
292
324
If you install in a language other than English, <command>tasksel</command>
293
325
may automatically install a <firstterm>localization task</firstterm>, if one
294
326
is available for your language. Space requirements differ per language;
295
 
you should allow up to 200MB in total for download and installation.
 
327
you should allow up to 350MB in total for download and installation. 
296
328
 
297
329
</para>
298
330
 </sect1>