aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/handbook/preface/preface.xml
diff options
context:
space:
mode:
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/preface/preface.xml')
-rw-r--r--en_US.ISO8859-1/books/handbook/preface/preface.xml760
1 files changed, 0 insertions, 760 deletions
diff --git a/en_US.ISO8859-1/books/handbook/preface/preface.xml b/en_US.ISO8859-1/books/handbook/preface/preface.xml
deleted file mode 100644
index f140ec1e93..0000000000
--- a/en_US.ISO8859-1/books/handbook/preface/preface.xml
+++ /dev/null
@@ -1,760 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!--
- $FreeBSD$
--->
-<preface xmlns="http://docbook.org/ns/docbook"
- xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
- xml:id="book-preface">
- <title>Preface</title>
-
- <bridgehead xml:id="preface-audience" renderas="sect1">Intended
- Audience</bridgehead>
-
- <para>The &os; newcomer will find that the first section of this
- book guides the user through the &os; installation process and
- gently introduces the concepts and conventions that underpin
- &unix;. Working through this section requires little more than
- the desire to explore, and the ability to take on board new
- concepts as they are introduced.</para>
-
- <para>Once you have traveled this far, the second, far larger,
- section of the Handbook is a comprehensive reference to all manner
- of topics of interest to &os; system administrators. Some of
- these chapters may recommend that you do some prior reading, and
- this is noted in the synopsis at the beginning of each
- chapter.</para>
-
- <para>For a list of additional sources of information, please see
- <xref linkend="bibliography"/>.</para>
-
- <bridgehead xml:id="preface-changes-from3" renderas="sect1">Changes
- from the Third Edition</bridgehead>
-
- <para>The current online version of the Handbook represents the
- cumulative effort of many hundreds of contributors over the past
- 10 years. The following are some of the significant changes since
- the two volume third edition was published in 2004:</para>
-
- <itemizedlist>
- <listitem>
- <para><xref linkend="wine"/> has been added with information
- about how to run &windows; applications on &os;.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="dtrace"/> has been added with information
- about the powerful &dtrace; performance analysis tool.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="filesystems"/> has been added with
- information about non-native file systems in &os;, such as ZFS
- from &sun;.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="audit"/> has been added to cover the new
- auditing capabilities in &os; and explain its use.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="virtualization"/> has been added with
- information about installing &os; on virtualization
- software.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="bsdinstall"/> has been added to cover
- installation of &os; using the new installation utility,
- <application>bsdinstall</application>.</para>
- </listitem>
- </itemizedlist>
-
- <bridgehead xml:id="preface-changes-from2" renderas="sect1">Changes
- from the Second Edition (2004)</bridgehead>
-
- <para>The third edition was the culmination of over two years of
- work by the dedicated members of the &os; Documentation
- Project. The printed edition grew to such a size that it was
- necessary to publish as two separate volumes. The following are
- the major changes in this new edition:</para>
-
- <itemizedlist>
- <listitem>
- <para><xref linkend="config-tuning"/> has been expanded with new
- information about the ACPI power and resource management, the
- <command>cron</command> system utility, and more kernel tuning
- options.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="security"/> has been expanded with new
- information about virtual private networks (VPNs), file system
- access control lists (ACLs), and security advisories.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="mac"/> is a new chapter with this edition.
- It explains what MAC is and how this mechanism can be used to
- secure a &os; system.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="disks"/> has been expanded with new
- information about USB storage devices, file system snapshots,
- file system quotas, file and network backed filesystems, and
- encrypted disk partitions.</para>
- </listitem>
-
- <listitem>
- <para>A troubleshooting section has been added to <xref
- linkend="ppp-and-slip"/>.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="mail"/> has been expanded with new
- information about using alternative transport agents, SMTP
- authentication, UUCP, <application>fetchmail</application>,
- <application>procmail</application>, and other advanced
- topics.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="network-servers"/> is all new with this
- edition. This chapter includes information about setting up
- the <application>Apache HTTP Server</application>,
- <application>ftpd</application>, and setting up a server for
- &microsoft; &windows; clients with
- <application>Samba</application>. Some sections from <xref
- linkend="advanced-networking"/> were moved here to improve
- the presentation.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="advanced-networking"/> has been expanded
- with new information about using &bluetooth; devices with
- &os;, setting up wireless networks, and Asynchronous Transfer
- Mode (ATM) networking.</para>
- </listitem>
-
- <listitem>
- <para>A glossary has been added to provide a central location
- for the definitions of technical terms used throughout the
- book.</para>
- </listitem>
-
- <listitem>
- <para>A number of aesthetic improvements have been made to the
- tables and figures throughout the book.</para>
- </listitem>
- </itemizedlist>
-
- <bridgehead xml:id="preface-changes" renderas="sect1">Changes from
- the First Edition (2001)</bridgehead>
-
- <para>The second edition was the culmination of over two years of
- work by the dedicated members of the &os; Documentation Project.
- The following were the major changes in this edition:</para>
-
-<!-- Talk a little about justification and other stylesheet changes? -->
-
- <itemizedlist>
- <listitem>
- <para>A complete Index has been added.</para>
- </listitem>
-
- <listitem>
- <para>All ASCII figures have been replaced by graphical
- diagrams.</para>
- </listitem>
-
- <listitem>
- <para>A standard synopsis has been added to each chapter to
- give a quick summary of what information the chapter
- contains, and what the reader is expected to know.</para>
- </listitem>
-
- <listitem>
- <para>The content has been logically reorganized into three
- parts: <quote>Getting Started</quote>, <quote>System
- Administration</quote>, and
- <quote>Appendices</quote>.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="basics"/> has been expanded to contain
- additional information about processes, daemons, and
- signals.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="ports"/> has been expanded to contain
- additional information about binary package
- management.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="x11"/> has been completely rewritten with
- an emphasis on using modern desktop technologies such as
- <application>KDE</application> and
- <application>GNOME</application> on &xfree86; 4.X.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="boot"/> has been expanded.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="disks"/> has been written from what used
- to be two separate chapters on <quote>Disks</quote> and
- <quote>Backups</quote>. We feel that the topics are easier
- to comprehend when presented as a single chapter. A section
- on RAID (both hardware and software) has also been
- added.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="serialcomms"/> has been completely
- reorganized and updated for &os; 4.X/5.X.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="ppp-and-slip"/> has been substantially
- updated.</para>
- </listitem>
-
- <listitem>
- <para>Many new sections have been added to <xref
- linkend="advanced-networking"/>.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="mail"/> has been expanded to include more
- information about configuring
- <application>sendmail</application>.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="linuxemu"/> has been expanded to include
- information about installing
- <application>&oracle;</application> and
- <application>&sap.r3;</application>.</para>
- </listitem>
-
- <listitem>
- <para>The following new topics are covered in this second
- edition:</para>
-
- <itemizedlist>
- <listitem>
- <para><xref linkend="config-tuning"/>.</para>
- </listitem>
-
- <listitem>
- <para><xref linkend="multimedia"/>.</para>
- </listitem>
- </itemizedlist>
- </listitem>
- </itemizedlist>
-
- <bridgehead xml:id="preface-overview"
- renderas="sect1">Organization of This Book</bridgehead>
-
- <para>This book is split into five logically distinct sections.
- The first section, <emphasis>Getting Started</emphasis>, covers
- the installation and basic usage of &os;. It is expected that
- the reader will follow these chapters in sequence, possibly
- skipping chapters covering familiar topics. The second section,
- <emphasis>Common Tasks</emphasis>, covers some frequently used
- features of &os;. This section, and all subsequent sections,
- can be read out of order. Each chapter begins with a succinct
- synopsis that describes what the chapter covers and what the
- reader is expected to already know. This is meant to allow the
- casual reader to skip around to find chapters of interest. The
- third section, <emphasis>System Administration</emphasis>, covers
- administration topics. The fourth section, <emphasis>Network
- Communication</emphasis>, covers networking and server topics.
- The fifth section contains appendices of reference
- information.</para>
-
- <variablelist>
-
-<!-- Part I - Introduction -->
-
- <varlistentry>
- <term><emphasis><xref linkend="introduction"/></emphasis></term>
-
- <listitem>
- <para>Introduces &os; to a new user. It describes the
- history of the &os; Project, its goals and development
- model.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="bsdinstall"/></emphasis></term>
-
- <listitem>
- <para>Walks a user through the entire installation process of
- &os;&nbsp;9.<replaceable>x</replaceable> and later using
- <application>bsdinstall</application>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="basics"/></emphasis></term>
-
- <listitem>
- <para>Covers the basic commands and functionality of the
- &os; operating system. If you are familiar with &linux;
- or another flavor of &unix; then you can probably skip this
- chapter.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="ports"/></emphasis></term>
-
- <listitem>
- <para>Covers the installation of third-party software with
- both &os;'s innovative <quote>Ports Collection</quote> and
- standard binary packages.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="x11"/></emphasis></term>
-
- <listitem>
- <para>Describes the X Window System in general and using X11
- on &os; in particular. Also describes common desktop
- environments such as <application>KDE</application> and
- <application>GNOME</application>.</para>
- </listitem>
- </varlistentry>
-
-<!-- Part II Common Tasks -->
-
- <varlistentry>
- <term><emphasis><xref linkend="desktop"/></emphasis></term>
-
- <listitem>
- <para>Lists some common desktop applications, such as web
- browsers and productivity suites, and describes how to
- install them on &os;.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="multimedia"/></emphasis></term>
- <listitem>
- <para>Shows how to set up sound and video playback support
- for your system. Also describes some sample audio and video
- applications.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="kernelconfig"/></emphasis></term>
-
- <listitem>
- <para>Explains why you might need to configure a new kernel
- and provides detailed instructions for configuring,
- building, and installing a custom kernel.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="printing"/></emphasis></term>
-
- <listitem>
- <para>Describes managing printers on &os;, including
- information about banner pages, printer accounting, and
- initial setup.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="linuxemu"/></emphasis></term>
-
- <listitem>
- <para>Describes the &linux; compatibility features of &os;.
- Also provides detailed installation instructions for many
- popular &linux; applications such as
- <application>&oracle;</application> and
- <application>&mathematica;</application>.</para>
- </listitem>
- </varlistentry>
-
-<!-- Part III - System Administration -->
-
- <varlistentry>
- <term><emphasis><xref
- linkend="config-tuning"/></emphasis></term>
-
- <listitem>
- <para>Describes the parameters available for system
- administrators to tune a &os; system for optimum
- performance. Also describes the various configuration files
- used in &os; and where to find them.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="boot"/></emphasis></term>
-
- <listitem>
- <para>Describes the &os; boot process and explains how to
- control this process with configuration options.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="security"/></emphasis></term>
-
- <listitem>
- <para>Describes many different tools available to help keep
- your &os; system secure, including Kerberos, IPsec and
- OpenSSH.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="jails"/></emphasis></term>
-
- <listitem>
- <para>Describes the jails framework, and the improvements of
- jails over the traditional chroot support of &os;.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="mac"/></emphasis></term>
-
- <listitem>
- <para>Explains what Mandatory Access Control (MAC) is and
- how this mechanism can be used to secure a &os;
- system.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="audit"/></emphasis></term>
-
- <listitem>
- <para>Describes what &os; Event Auditing is, how it can be
- installed, configured, and how audit trails can be inspected
- or monitored.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="disks"/></emphasis></term>
-
- <listitem>
- <para>Describes how to manage storage media and filesystems
- with &os;. This includes physical disks, RAID arrays,
- optical and tape media, memory-backed disks, and network
- filesystems.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="geom"/></emphasis></term>
-
- <listitem>
- <para>Describes what the GEOM framework in &os; is and how
- to configure various supported RAID levels.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="filesystems"/></emphasis></term>
-
- <listitem>
- <para>Examines support of non-native file systems in &os;,
- like the Z File System from &sun;.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref
- linkend="virtualization"/></emphasis></term>
-
- <listitem>
- <para>Describes what virtualization systems offer, and how
- they can be used with &os;.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="l10n"/></emphasis></term>
-
- <listitem>
- <para>Describes how to use &os; in languages other than
- English. Covers both system and application level
- localization.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref
- linkend="updating-upgrading"/></emphasis></term>
-
- <listitem>
- <para>Explains the differences between &os;-STABLE,
- &os;-CURRENT, and &os; releases. Describes which users
- would benefit from tracking a development system and
- outlines that process. Covers the methods users may take
- to update their system to the latest security
- release.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="dtrace"/></emphasis></term>
-
- <listitem>
- <para>Describes how to configure and use the &dtrace; tool
- from &sun; in &os;. Dynamic tracing can help locate
- performance issues, by performing real time system
- analysis.</para>
- </listitem>
- </varlistentry>
-
-<!-- Part IV - Network Communications -->
-
- <varlistentry>
- <term><emphasis><xref linkend="serialcomms"/></emphasis></term>
-
- <listitem>
- <para>Explains how to connect terminals and modems to your
- &os; system for both dial in and dial out
- connections.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="ppp-and-slip"/></emphasis></term>
-
- <listitem>
- <para>Describes how to use PPP to connect to remote systems
- with &os;.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="mail"/></emphasis></term>
-
- <listitem>
- <para>Explains the different components of an email server
- and dives into simple configuration topics for the most
- popular mail server software:
- <application>sendmail</application>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref
- linkend="network-servers"/></emphasis></term>
-
- <listitem>
- <para>Provides detailed instructions and example configuration
- files to set up your &os; machine as a network filesystem
- server, domain name server, network information system
- server, or time synchronization server.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="firewalls"/></emphasis></term>
-
- <listitem>
- <para>Explains the philosophy behind software-based firewalls
- and provides detailed information about the configuration
- of the different firewalls available for &os;.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref
- linkend="advanced-networking"/></emphasis></term>
-
- <listitem>
- <para>Describes many networking topics, including sharing an
- Internet connection with other computers on your LAN,
- advanced routing topics, wireless networking, &bluetooth;,
- ATM, IPv6, and much more.</para>
- </listitem>
- </varlistentry>
-
-<!-- Part V - Appendices -->
-
- <varlistentry>
- <term><emphasis><xref linkend="mirrors"/></emphasis></term>
-
- <listitem>
- <para>Lists different sources for obtaining &os; media on
- CDROM or DVD as well as different sites on the Internet
- that allow you to download and install &os;.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="bibliography"/></emphasis></term>
-
- <listitem>
- <para>This book touches on many different subjects that may
- leave you hungry for a more detailed explanation. The
- bibliography lists many excellent books that are referenced
- in the text.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="eresources"/></emphasis></term>
-
- <listitem>
- <para>Describes the many forums available for &os; users to
- post questions and engage in technical conversations about
- &os;.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><emphasis><xref linkend="pgpkeys"/></emphasis></term>
-
- <listitem>
- <para>Lists the PGP fingerprints of several &os;
- Developers.</para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <bridgehead xml:id="preface-conv" renderas="sect1">Conventions used
- in this book</bridgehead>
-
- <para>To provide a consistent and easy to read text, several
- conventions are followed throughout the book.</para>
-
- <bridgehead xml:id="preface-conv-typographic"
- renderas="sect2">Typographic Conventions</bridgehead>
-
- <variablelist>
- <varlistentry>
- <term><emphasis>Italic</emphasis></term>
-
- <listitem>
- <para>An <emphasis>italic</emphasis> font is used for
- filenames, URLs, emphasized text, and the first usage of
- technical terms.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><literal>Monospace</literal></term>
-
- <listitem>
- <para>A <literal>monospaced</literal> font is used for error
- messages, commands, environment variables, names of ports,
- hostnames, user names, group names, device names, variables,
- and code fragments.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><application>Bold</application></term>
-
- <listitem>
- <para>A <keycap>bold</keycap> font is used for
- applications, commands, and keys.</para>
- </listitem>
- </varlistentry>
- </variablelist>
-
-<!-- Var list -->
- <bridgehead xml:id="preface-conv-commands" renderas="sect2">User
- Input</bridgehead>
-
- <para>Keys are shown in <keycap>bold</keycap> to stand out from
- other text. Key combinations that are meant to be typed
- simultaneously are shown with `<literal>+</literal>' between
- the keys, such as:</para>
-
- <para><keycombo action="simul">
- <keycap>Ctrl</keycap>
- <keycap>Alt</keycap>
- <keycap>Del</keycap></keycombo></para>
-
- <para>Meaning the user should type the <keycap>Ctrl</keycap>,
- <keycap>Alt</keycap>, and <keycap>Del</keycap> keys at the same
- time.</para>
-
- <para>Keys that are meant to be typed in sequence will be separated
- with commas, for example:</para>
-
- <para><keycombo action="simul">
- <keycap>Ctrl</keycap>
- <keycap>X</keycap>
- </keycombo>,
- <keycombo action="simul">
- <keycap>Ctrl</keycap>
- <keycap>S</keycap></keycombo></para>
-
- <para>Would mean that the user is expected to type the
- <keycap>Ctrl</keycap> and <keycap>X</keycap> keys simultaneously
- and then to type the <keycap>Ctrl</keycap> and <keycap>S</keycap>
- keys simultaneously.</para>
-
-<!-- How to type in key stokes, etc.. -->
- <bridgehead xml:id="preface-conv-examples"
- renderas="sect2">Examples</bridgehead>
-
- <para>Examples starting with <filename>C:\&gt;</filename>
- indicate a &ms-dos; command. Unless otherwise noted, these
- commands may be executed from a <quote>Command Prompt</quote>
- window in a modern &microsoft.windows;
- environment.</para>
-
- <screen><prompt>E:\&gt;</prompt> <userinput>tools\fdimage floppies\kern.flp A:</userinput></screen>
-
- <para>Examples starting with &prompt.root; indicate a command that
- must be invoked as the superuser in &os;. You can login as
- <systemitem class="username">root</systemitem> to type the
- command, or login as your normal account and use &man.su.1; to
- gain superuser privileges.</para>
-
- <screen>&prompt.root; <userinput>dd if=kern.flp of=/dev/fd0</userinput></screen>
-
- <para>Examples starting with &prompt.user; indicate a command that
- should be invoked from a normal user account. Unless otherwise
- noted, C-shell syntax is used for setting environment variables
- and other shell commands.</para>
-
- <screen>&prompt.user; <userinput>top</userinput></screen>
-
- <bridgehead xml:id="preface-acknowledgements"
- renderas="sect1">Acknowledgments</bridgehead>
-
- <para>The book you are holding represents the efforts of many
- hundreds of people around the world. Whether they sent in fixes
- for typos, or submitted complete chapters, all the contributions
- have been useful.</para>
-
- <para>Several companies have supported the development of this
- document by paying authors to work on it full-time, paying for
- publication, etc. In particular, BSDi (subsequently acquired by
- <link xlink:href="http://www.windriver.com">Wind River
- Systems</link>) paid members of the &os; Documentation Project
- to work on improving this book full time leading up to the
- publication of the first printed edition in March 2000 (ISBN
- 1-57176-241-8). Wind River Systems then paid several additional
- authors to make a number of improvements to the print-output
- infrastructure and to add additional chapters to the text. This
- work culminated in the publication of the second printed edition
- in November 2001 (ISBN 1-57176-303-1). In 2003-2004, <link
- xlink:href="http://www.freebsdmall.com">&os; Mall, Inc</link>,
- paid several contributors to improve the Handbook in preparation
- for the third printed edition.</para>
-
-</preface>