View | Details | Raw Unified | Return to bug 70920
Collapse All | Expand All

(-)preface.sgml (-44 / +44 lines)
Lines 8-23 Link Here
8
  <bridgehead id="preface-audience" renderas=sect1>Intended
8
  <bridgehead id="preface-audience" renderas=sect1>Intended
9
  Audience</bridgehead>
9
  Audience</bridgehead>
10
10
11
  <para>The FreeBSD newcomer will find that the first section of this
11
  <para>The &os; newcomer will find that the first section of this
12
    book guides the user through the FreeBSD installation process and
12
    book guides the user through the &os; installation process and
13
    gently introduces the concepts and conventions that underpin &unix;.
13
    gently introduces the concepts and conventions that underpin &unix;.
14
    Working through this section requires little more than the desire
14
    Working through this section requires little more than the desire
15
    to explore, and the ability to take on board new concepts as they
15
    to explore, and the ability to take on board new concepts as they
16
    are introduced.</para>
16
    are introduced.</para>
17
17
18
  <para>Once you have travelled this far, the second, far larger,
18
  <para>Once you have traveled this far, the second, far larger,
19
    section of the Handbook is a comprehensive reference to all manner
19
    section of the Handbook is a comprehensive reference to all manner
20
    of topics of interest to FreeBSD system administrators.  Some of
20
    of topics of interest to &os; system administrators.  Some of
21
    these chapters may recommend that you do some prior reading, and
21
    these chapters may recommend that you do some prior reading, and
22
    this is noted in the synopsis at the beginning of each
22
    this is noted in the synopsis at the beginning of each
23
    chapter.</para>
23
    chapter.</para>
Lines 29-35 Link Here
29
  Second Edition</bridgehead>
29
  Second Edition</bridgehead>
30
30
31
  <para>This third edition is the culmination of over two years of
31
  <para>This third edition is the culmination of over two years of
32
      work by the dedicated members of the FreeBSD Documentation
32
      work by the dedicated members of the &os; Documentation
33
      Project.  The following are the major changes in this new
33
      Project.  The following are the major changes in this new
34
      edition:</para>
34
      edition:</para>
35
35
Lines 51-57 Link Here
51
      <listitem>
51
      <listitem>
52
	<para><xref linkend="mac">, Mandatory Access Control (MAC), is
52
	<para><xref linkend="mac">, Mandatory Access Control (MAC), is
53
	  a new chapter with this edition.  It explains what MAC is
53
	  a new chapter with this edition.  It explains what MAC is
54
	  and how this mechanism can be used to secure a FreeBSD
54
	  and how this mechanism can be used to secure a &os; 
55
	  system.</para>
55
	  system.</para>
56
      </listitem>
56
      </listitem>
57
57
Lines 94-100 Link Here
94
      <listitem>
94
      <listitem>
95
	<para><xref linkend="advanced-networking">, Advanced
95
	<para><xref linkend="advanced-networking">, Advanced
96
	  Networking, has been expanded with new information about
96
	  Networking, has been expanded with new information about
97
	  using Bluetooth devices with FreeBSD, setting up wireless
97
	  using Bluetooth devices with &os;, setting up wireless
98
	  networks, and Asynchronous Transfer Mode (ATM)
98
	  networks, and Asynchronous Transfer Mode (ATM)
99
	  networking.</para>
99
	  networking.</para>
100
      </listitem>
100
      </listitem>
Lines 115-121 Link Here
115
  First Edition</bridgehead>
115
  First Edition</bridgehead>
116
116
117
    <para>The second edition was the culmination of over two years of
117
    <para>The second edition was the culmination of over two years of
118
      work by the dedicated members of the FreeBSD Documentation
118
      work by the dedicated members of the &os; Documentation
119
      Project.  The following were the major changes in this
119
      Project.  The following were the major changes in this
120
      edition:</para>
120
      edition:</para>
121
121
Lines 139-145 Link Here
139
	<quote>Appendices</quote>.</para>
139
	<quote>Appendices</quote>.</para>
140
      </listitem>
140
      </listitem>
141
      <listitem>
141
      <listitem>
142
	<para><xref linkend="install"> (<quote>Installing FreeBSD</quote>) was completely
142
	<para><xref linkend="install"> (<quote>Installing &os;</quote>) was completely
143
	rewritten with many screenshots to make it much easier for new
143
	rewritten with many screenshots to make it much easier for new
144
	users to grasp the text.</para>
144
	users to grasp the text.</para>
145
      </listitem>
145
      </listitem>
Lines 159-165 Link Here
159
	technologies such as <application>KDE</application> and <application>GNOME</application> on &xfree86; 4.X.</para>
159
	technologies such as <application>KDE</application> and <application>GNOME</application> on &xfree86; 4.X.</para>
160
      </listitem>
160
      </listitem>
161
      <listitem>
161
      <listitem>
162
	<para><xref linkend="boot"> (<quote>The FreeBSD Booting Process</quote>) has been
162
	<para><xref linkend="boot"> (<quote>The &os; Booting Process</quote>) has been
163
	expanded.</para>
163
	expanded.</para>
164
      </listitem>
164
      </listitem>
165
      <listitem>
165
      <listitem>
Lines 171-177 Link Here
171
      </listitem>
171
      </listitem>
172
      <listitem>
172
      <listitem>
173
	<para><xref linkend="serialcomms"> (<quote>Serial Communications</quote>) has been completely
173
	<para><xref linkend="serialcomms"> (<quote>Serial Communications</quote>) has been completely
174
	reorganized and updated for FreeBSD 4.X/5.X.</para>
174
	reorganized and updated for &os; 4.X/5.X.</para>
175
      </listitem>
175
      </listitem>
176
      <listitem>
176
      <listitem>
177
	<para><xref linkend="ppp-and-slip"> (<quote>PPP and SLIP</quote>) has been substantially
177
	<para><xref linkend="ppp-and-slip"> (<quote>PPP and SLIP</quote>) has been substantially
Lines 211-221 Link Here
211
211
212
  <para>This book is split into five logically distinct sections.
212
  <para>This book is split into five logically distinct sections.
213
    The first section, <emphasis>Getting Started</emphasis>, covers
213
    The first section, <emphasis>Getting Started</emphasis>, covers
214
    the installation and basic usage of FreeBSD.  It is expected that
214
    the installation and basic usage of &os;.  It is expected that
215
    the reader will follow these chapters in sequence, possibly
215
    the reader will follow these chapters in sequence, possibly
216
    skipping chapters covering familiar topics.  The second section,
216
    skipping chapters covering familiar topics.  The second section,
217
    <emphasis>Common Tasks</emphasis>, covers some frequently used
217
    <emphasis>Common Tasks</emphasis>, covers some frequently used
218
    features of FreeBSD.  This section, and all subsequent sections,
218
    features of &os;.  This section, and all subsequent sections,
219
    can be read out of order.  Each chapter begins with a succinct
219
    can be read out of order.  Each chapter begins with a succinct
220
    synopsis that
220
    synopsis that
221
    describes what the chapter covers and what the reader is expected
221
    describes what the chapter covers and what the reader is expected
Lines 234-241 Link Here
234
    <varlistentry>
234
    <varlistentry>
235
      <term><emphasis><xref linkend="introduction">, Introduction</emphasis></term>
235
      <term><emphasis><xref linkend="introduction">, Introduction</emphasis></term>
236
      <listitem>
236
      <listitem>
237
	<para>Introduces FreeBSD to a new user.  It describes the
237
	<para>Introduces &os; to a new user.  It describes the
238
	history of the FreeBSD Project, its goals and development model.</para>
238
	history of the &os; Project, its goals and development model.</para>
239
      </listitem>
239
      </listitem>
240
    </varlistentry>
240
    </varlistentry>
241
    <varlistentry>
241
    <varlistentry>
Lines 250-256 Link Here
250
      <term><emphasis><xref linkend="basics">, &unix; Basics</emphasis></term>
250
      <term><emphasis><xref linkend="basics">, &unix; Basics</emphasis></term>
251
      <listitem>
251
      <listitem>
252
	<para>Covers the basic commands and functionality of the
252
	<para>Covers the basic commands and functionality of the
253
	FreeBSD operating system.  If you are familiar with Linux or
253
	&os; operating system.  If you are familiar with Linux or
254
	another flavor of &unix; then you can probably skip this
254
	another flavor of &unix; then you can probably skip this
255
	chapter.</para>
255
	chapter.</para>
256
      </listitem>
256
      </listitem>
Lines 259-265 Link Here
259
      <term><emphasis><xref linkend="ports">, Installing Applications</emphasis></term>
259
      <term><emphasis><xref linkend="ports">, Installing Applications</emphasis></term>
260
      <listitem>
260
      <listitem>
261
	<para>Covers the installation of third-party software with
261
	<para>Covers the installation of third-party software with
262
	both FreeBSD's innovative <quote>Ports Collection</quote> and standard
262
	both &os;'s innovative <quote>Ports Collection</quote> and standard
263
	binary packages.</para>
263
	binary packages.</para>
264
      </listitem>
264
      </listitem>
265
    </varlistentry>
265
    </varlistentry>
Lines 267-273 Link Here
267
      <term><emphasis><xref linkend="x11">, The X Window System</emphasis></term>
267
      <term><emphasis><xref linkend="x11">, The X Window System</emphasis></term>
268
      <listitem>
268
      <listitem>
269
	<para>Describes the X Window System in general and using
269
	<para>Describes the X Window System in general and using
270
	<application>&xfree86;</application> on FreeBSD in particular.  Also describes common
270
	<application>&xfree86;</application> on &os; in particular.  Also describes common
271
	desktop environments such as <application>KDE</application> and <application>GNOME</application>.</para>
271
	desktop environments such as <application>KDE</application> and <application>GNOME</application>.</para>
272
      </listitem>
272
      </listitem>
273
    </varlistentry>
273
    </varlistentry>
Lines 279-285 Link Here
279
      <listitem>
279
      <listitem>
280
        <para>Lists some common desktop applications, such as web browsers
280
        <para>Lists some common desktop applications, such as web browsers
281
         and productivity suites, and describes how to install them on
281
         and productivity suites, and describes how to install them on
282
         FreeBSD.</para>
282
         &os;.</para>
283
      </listitem>
283
      </listitem>
284
    </varlistentry>
284
    </varlistentry>
285
    <varlistentry>
285
    <varlistentry>
Lines 290-296 Link Here
290
      </listitem>
290
      </listitem>
291
    </varlistentry>
291
    </varlistentry>
292
    <varlistentry>
292
    <varlistentry>
293
      <term><emphasis><xref linkend="kernelconfig">, Configuring the FreeBSD
293
      <term><emphasis><xref linkend="kernelconfig">, Configuring the &os; 
294
      Kernel</emphasis></term>
294
      Kernel</emphasis></term>
295
      <listitem>
295
      <listitem>
296
	<para>Explains why you might need to configure a new kernel
296
	<para>Explains why you might need to configure a new kernel
Lines 301-307 Link Here
301
    <varlistentry>
301
    <varlistentry>
302
      <term><emphasis><xref linkend="printing">, Printing</emphasis></term>
302
      <term><emphasis><xref linkend="printing">, Printing</emphasis></term>
303
      <listitem>
303
      <listitem>
304
	<para>Describes managing printers on FreeBSD, including
304
	<para>Describes managing printers on &os;, including
305
	information about banner pages, printer accounting, and
305
	information about banner pages, printer accounting, and
306
	initial setup.</para>
306
	initial setup.</para>
307
      </listitem>
307
      </listitem>
Lines 309-317 Link Here
309
    <varlistentry>
309
    <varlistentry>
310
      <term><emphasis><xref linkend="linuxemu">, Linux Binary Compatibility</emphasis></term>
310
      <term><emphasis><xref linkend="linuxemu">, Linux Binary Compatibility</emphasis></term>
311
      <listitem>
311
      <listitem>
312
	<para>Describes the Linux compatibility features of FreeBSD.
312
	<para>Describes the Linux compatibility features of &os;.
313
	Also provides detailed installation instructions for many
313
	Also provides detailed installation instructions for many
314
	popular Linux applications such as <application>&oracle;</application>, <application>&sap.r3;</application>, and
314
	popular &linux; applications such as <application>&oracle;</application>, <application>&sap.r3;</application>, and
315
	  <application>&mathematica;</application>.</para>
315
	  <application>&mathematica;</application>.</para>
316
      </listitem>
316
      </listitem>
317
    </varlistentry>
317
    </varlistentry>
Lines 322-336 Link Here
322
      <term><emphasis><xref linkend="config-tuning">, Configuration and Tuning</emphasis></term>
322
      <term><emphasis><xref linkend="config-tuning">, Configuration and Tuning</emphasis></term>
323
      <listitem>
323
      <listitem>
324
	<para>Describes the parameters available for system
324
	<para>Describes the parameters available for system
325
	administrators to tune a FreeBSD system for optimum
325
	administrators to tune a &os; system for optimum
326
	performance.  Also describes the various configuration files
326
	performance.  Also describes the various configuration files
327
	used in FreeBSD and where to find them.</para>
327
	used in &os; and where to find them.</para>
328
      </listitem>
328
      </listitem>
329
    </varlistentry>
329
    </varlistentry>
330
    <varlistentry>
330
    <varlistentry>
331
      <term><emphasis><xref linkend="boot">, Booting Process</emphasis></term>
331
      <term><emphasis><xref linkend="boot">, Booting Process</emphasis></term>
332
      <listitem>
332
      <listitem>
333
	<para>Describes the FreeBSD boot process and explains
333
	<para>Describes the &os; boot process and explains
334
	how to control this process with configuration options.</para>
334
	how to control this process with configuration options.</para>
335
      </listitem>
335
      </listitem>
336
    </varlistentry>
336
    </varlistentry>
Lines 347-353 Link Here
347
      <term><emphasis><xref linkend="security">, Security</emphasis></term>
347
      <term><emphasis><xref linkend="security">, Security</emphasis></term>
348
      <listitem>
348
      <listitem>
349
	<para>Describes many different tools available to help keep your
349
	<para>Describes many different tools available to help keep your
350
	FreeBSD system secure, including Kerberos, IPsec, OpenSSH, and
350
	&os; system secure, including Kerberos, IPsec, OpenSSH, and
351
	network firewalls.</para>
351
	network firewalls.</para>
352
      </listitem>
352
      </listitem>
353
    </varlistentry>
353
    </varlistentry>
Lines 355-368 Link Here
355
      <term><emphasis><xref linkend="mac">, Mandatory Access Control</emphasis></term>
355
      <term><emphasis><xref linkend="mac">, Mandatory Access Control</emphasis></term>
356
      <listitem>
356
      <listitem>
357
	<para>Explains what Mandatory Access Control (MAC) is and how this
357
	<para>Explains what Mandatory Access Control (MAC) is and how this
358
	mechanism can be used to secure a FreeBSD system.</para>
358
	mechanism can be used to secure a &os; system.</para>
359
      </listitem>
359
      </listitem>
360
    </varlistentry>
360
    </varlistentry>
361
    <varlistentry>
361
    <varlistentry>
362
      <term><emphasis><xref linkend="disks">, Storage</emphasis></term>
362
      <term><emphasis><xref linkend="disks">, Storage</emphasis></term>
363
      <listitem>
363
      <listitem>
364
	<para>Describes how to manage storage media and filesystems
364
	<para>Describes how to manage storage media and filesystems
365
  	  with FreeBSD.  This includes physical disks, RAID arrays,
365
  	  with &os;.  This includes physical disks, RAID arrays,
366
  	  optical and tape media, memory-backed disks, and network
366
  	  optical and tape media, memory-backed disks, and network
367
  	  filesystems.</para>
367
  	  filesystems.</para>
368
      </listitem>
368
      </listitem>
Lines 378-384 Link Here
378
    <varlistentry>
378
    <varlistentry>
379
      <term><emphasis><xref linkend="l10n">, Localization</emphasis></term>
379
      <term><emphasis><xref linkend="l10n">, Localization</emphasis></term>
380
      <listitem>
380
      <listitem>
381
	<para>Describes how to use FreeBSD in languages other than
381
	<para>Describes how to use &os; in languages other than
382
	English.  Covers both system and application level
382
	English.  Covers both system and application level
383
	localization.</para>
383
	localization.</para>
384
      </listitem>
384
      </listitem>
Lines 386-393 Link Here
386
    <varlistentry>
386
    <varlistentry>
387
      <term><emphasis><xref linkend="cutting-edge">, The Cutting Edge</emphasis></term>
387
      <term><emphasis><xref linkend="cutting-edge">, The Cutting Edge</emphasis></term>
388
      <listitem>
388
      <listitem>
389
	<para>Explains the differences between FreeBSD-STABLE,
389
	<para>Explains the differences between &os.stable;,
390
	FreeBSD-CURRENT, and FreeBSD releases.  Describes which users
390
	&os.current;, and &os; releases.  Describes which users
391
	would benefit from tracking a development system and outlines
391
	would benefit from tracking a development system and outlines
392
	that process.</para>
392
	that process.</para>
393
      </listitem>
393
      </listitem>
Lines 399-412 Link Here
399
      <term><emphasis><xref linkend="serialcomms">, Serial Communications</emphasis></term>
399
      <term><emphasis><xref linkend="serialcomms">, Serial Communications</emphasis></term>
400
      <listitem>
400
      <listitem>
401
	<para>Explains how to connect terminals and modems to your
401
	<para>Explains how to connect terminals and modems to your
402
  	FreeBSD system for both dial in and dial out connections.</para>
402
  	&os; system for both dial in and dial out connections.</para>
403
      </listitem>
403
      </listitem>
404
    </varlistentry>
404
    </varlistentry>
405
    <varlistentry>
405
    <varlistentry>
406
      <term><emphasis><xref linkend="ppp-and-slip">, PPP and SLIP</emphasis></term>
406
      <term><emphasis><xref linkend="ppp-and-slip">, PPP and SLIP</emphasis></term>
407
      <listitem>
407
      <listitem>
408
	<para>Describes how to use PPP, SLIP, or PPP over Ethernet to
408
	<para>Describes how to use PPP, SLIP, or PPP over Ethernet to
409
	connect to remote systems with FreeBSD.</para>
409
	connect to remote systems with &os;.</para>
410
      </listitem>
410
      </listitem>
411
    </varlistentry>
411
    </varlistentry>
412
    <varlistentry>
412
    <varlistentry>
Lines 422-428 Link Here
422
      <term><emphasis><xref linkend="network-servers">, Network Servers</emphasis></term>
422
      <term><emphasis><xref linkend="network-servers">, Network Servers</emphasis></term>
423
      <listitem>
423
      <listitem>
424
	<para>Provides detailed instructions and example configuration
424
	<para>Provides detailed instructions and example configuration
425
	  files to set up your FreeBSD machine as a network filesystem
425
	  files to set up your &os; machine as a network filesystem
426
	  server, domain name server, network information system
426
	  server, domain name server, network information system
427
	  server, or time synchronization server.</para>
427
	  server, or time synchronization server.</para>
428
      </listitem>
428
      </listitem>
Lines 440-450 Link Here
440
<!-- Part V - Appendices -->
440
<!-- Part V - Appendices -->
441
441
442
    <varlistentry>
442
    <varlistentry>
443
      <term><emphasis><xref linkend="mirrors">, Obtaining FreeBSD </emphasis></term>
443
      <term><emphasis><xref linkend="mirrors">, Obtaining &os;</emphasis></term>
444
      <listitem>
444
      <listitem>
445
	<para>Lists different sources for obtaining FreeBSD media on CDROM
445
	<para>Lists different sources for obtaining &os; media on CDROM
446
	or DVD as well as different sites on the Internet that allow
446
	or DVD as well as different sites on the Internet that allow
447
	you to download and install FreeBSD.</para>
447
	you to download and install &os;.</para>
448
      </listitem>
448
      </listitem>
449
    </varlistentry>
449
    </varlistentry>
450
    <varlistentry>
450
    <varlistentry>
Lines 459-473 Link Here
459
    <varlistentry>
459
    <varlistentry>
460
      <term><emphasis><xref linkend="eresources">, Resources on the Internet</emphasis></term>
460
      <term><emphasis><xref linkend="eresources">, Resources on the Internet</emphasis></term>
461
      <listitem>
461
      <listitem>
462
	<para>Describes the many forums available for FreeBSD users to
462
	<para>Describes the many forums available for &os; users to
463
	post questions and engage in technical conversations about
463
	post questions and engage in technical conversations about
464
	FreeBSD.</para>
464
	&os;.</para>
465
      </listitem>
465
      </listitem>
466
    </varlistentry>
466
    </varlistentry>
467
    <varlistentry>
467
    <varlistentry>
468
      <term><emphasis><xref linkend="pgpkeys">, PGP Keys</emphasis></term>
468
      <term><emphasis><xref linkend="pgpkeys">, PGP Keys</emphasis></term>
469
      <listitem>
469
      <listitem>
470
	<para>Lists the PGP fingerprints of several FreeBSD Developers.</para>
470
	<para>Lists the PGP fingerprints of several &os; Developers.</para>
471
      </listitem>
471
      </listitem>
472
    </varlistentry>
472
    </varlistentry>
473
  </variablelist>
473
  </variablelist>
Lines 525-531 Link Here
525
  </para>
525
  </para>
526
526
527
  <para>Meaning the user should type the <keycap>Ctrl</keycap>,
527
  <para>Meaning the user should type the <keycap>Ctrl</keycap>,
528
    <keycap>Alt</keycap>,and <keycap>Del</keycap> keys at the same
528
    <keycap>Alt</keycap>, and <keycap>Del</keycap> keys at the same
529
    time.</para>
529
    time.</para>
530
530
531
  <para>Keys that are meant to be typed in sequence will be separated with
531
  <para>Keys that are meant to be typed in sequence will be separated with
Lines 559-565 Link Here
559
  <screen><prompt>E:\&gt;</prompt> <userinput>tools\fdimage floppies\kern.flp A:</userinput></screen>
559
  <screen><prompt>E:\&gt;</prompt> <userinput>tools\fdimage floppies\kern.flp A:</userinput></screen>
560
560
561
  <para>Examples starting with &prompt.root; indicate a command that
561
  <para>Examples starting with &prompt.root; indicate a command that
562
    must be invoked as the superuser in FreeBSD.  You can login as
562
    must be invoked as the superuser in &os;.  You can login as
563
    <username>root</username> to type the command, or login as your
563
    <username>root</username> to type the command, or login as your
564
    normal account and use &man.su.1; to gain
564
    normal account and use &man.su.1; to gain
565
    superuser privileges.</para>
565
    superuser privileges.</para>
Lines 585-591 Link Here
585
    document by paying authors to work on it full-time, paying for
585
    document by paying authors to work on it full-time, paying for
586
    publication, etc.  In particular, BSDi (subsequently acquired by
586
    publication, etc.  In particular, BSDi (subsequently acquired by
587
    <ulink url="http://www.windriver.com">Wind River Systems</ulink>)
587
    <ulink url="http://www.windriver.com">Wind River Systems</ulink>)
588
    paid members of the FreeBSD Documentation Project to work on
588
    paid members of the &os; Documentation Project to work on
589
    improving this book full time leading up to the publication of the
589
    improving this book full time leading up to the publication of the
590
    first printed edition in March 2000 (ISBN 1-57176-241-8).  Wind
590
    first printed edition in March 2000 (ISBN 1-57176-241-8).  Wind
591
    River Systems then paid several additional authors to make a
591
    River Systems then paid several additional authors to make a

Return to bug 70920