aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/handbook/book.sgml
blob: 8c60df416a2bd8c9d4c71015041256ac36363607 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
<!--
     The FreeBSD Documentation Project

     $FreeBSD$
-->

<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
%man;

<!ENTITY % bookinfo PUBLIC "-//FreeBSD//ENTITIES DocBook BookInfo Entities//EN">
%bookinfo;

<!ENTITY % freebsd PUBLIC "-//FreeBSD//ENTITIES DocBook Miscellaneous FreeBSD Entities//EN">
%freebsd;

<!ENTITY % chapters SYSTEM "chapters.ent"> %chapters;
<!ENTITY % authors PUBLIC "-//FreeBSD//ENTITIES DocBook Author Entities//EN">
%authors;
<!ENTITY % teams PUBLIC "-//FreeBSD//ENTITIES DocBook Team Entities//EN">
%teams;
<!ENTITY % mailing-lists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//EN"> %mailing-lists;
<!ENTITY % newsgroups PUBLIC "-//FreeBSD//ENTITIES DocBook Newsgroup Entities//EN"> %newsgroups;
<!ENTITY % trademarks PUBLIC "-//FreeBSD//ENTITIES DocBook Trademark Entities//EN">
%trademarks;
<!ENTITY % txtfiles SYSTEM "txtfiles.ent"> %txtfiles;
<!ENTITY % urls PUBLIC "-//FreeBSD//ENTITIES DocBook URL Entities//EN">
%urls;

<!ENTITY % not.published "INCLUDE">

<!ENTITY % chap.introduction "IGNORE">
<!ENTITY % chap.install "IGNORE">
<!ENTITY % chap.basics "IGNORE">
<!ENTITY % chap.ports "IGNORE">
<!ENTITY % chap.config "IGNORE">
<!ENTITY % chap.boot "IGNORE">
<!ENTITY % chap.users "IGNORE">
<!ENTITY % chap.kernelconfig "IGNORE">
<!ENTITY % chap.security "IGNORE">
<!ENTITY % chap.printing "IGNORE">
<!ENTITY % chap.disks "IGNORE">
<!ENTITY % chap.vinum "IGNORE">
<!ENTITY % chap.x11 "IGNORE">
<!ENTITY % chap.l10n "IGNORE">
<!ENTITY % chap.multimedia "IGNORE">
<!ENTITY % chap.desktop "IGNORE">
<!ENTITY % chap.serialcomms "IGNORE">
<!ENTITY % chap.ppp-and-slip "IGNORE">
<!ENTITY % chap.advanced-networking "IGNORE">
<!ENTITY % chap.network-servers "IGNORE">
<!ENTITY % chap.mail "IGNORE">
<!ENTITY % chap.cutting-edge "IGNORE">
<!ENTITY % chap.linuxemu "IGNORE">
<!ENTITY % chap.mirrors "IGNORE">
<!ENTITY % chap.bibliography "IGNORE">
<!ENTITY % chap.eresources "IGNORE">
<!ENTITY % chap.pgpkeys "IGNORE">
<!ENTITY % chap.index "IGNORE">
<!ENTITY % chap.freebsd-glossary "IGNORE">
<!ENTITY % chap.mac "IGNORE">

<!ENTITY % pgpkeys SYSTEM "../../../share/pgpkeys/pgpkeys.ent"> %pgpkeys;
]>

<book>
  <bookinfo>
    <title>FreeBSD Handbook</title>
    
    <corpauthor>The FreeBSD Documentation Project</corpauthor>
    
    <pubdate>February 1999</pubdate>
    
    <copyright>
      <year>1995</year>
      <year>1996</year>
      <year>1997</year>
      <year>1998</year>
      <year>1999</year>
      <year>2000</year>
      <year>2001</year>
      <year>2002</year>
      <year>2003</year>
      <year>2004</year>
      <holder>The FreeBSD Documentation Project</holder>
    </copyright>

    &bookinfo.legalnotice;

    <legalnotice id="trademarks" role="trademarks">
      &tm-attrib.freebsd;
      &tm-attrib.3com;
      &tm-attrib.3ware;
      &tm-attrib.arm;
      &tm-attrib.adaptec;
      &tm-attrib.adobe;
      &tm-attrib.apple;
      &tm-attrib.corel;
      &tm-attrib.creative;
      &tm-attrib.cvsup;
      &tm-attrib.heidelberger;
      &tm-attrib.ibm;
      &tm-attrib.ieee;
      &tm-attrib.intel;
      &tm-attrib.intuit;
      &tm-attrib.linux;
      &tm-attrib.lsilogic;
      &tm-attrib.m-systems;
      &tm-attrib.macromedia;
      &tm-attrib.microsoft;
      &tm-attrib.netscape;
      &tm-attrib.nexthop;
      &tm-attrib.opengroup;
      &tm-attrib.oracle;
      &tm-attrib.powerquest;
      &tm-attrib.realnetworks;
      &tm-attrib.redhat;
      &tm-attrib.sap;
      &tm-attrib.sun;
      &tm-attrib.symantec;
      &tm-attrib.themathworks;
      &tm-attrib.thomson;
      &tm-attrib.usrobotics;
      &tm-attrib.vmware;
      &tm-attrib.waterloomaple;
      &tm-attrib.wolframresearch;
      &tm-attrib.xfree86;
      &tm-attrib.xiph;
      &tm-attrib.general;
    </legalnotice>
    
    <abstract>
      <para>Welcome to FreeBSD! This handbook covers the installation and day
	to day use of <emphasis>FreeBSD &rel2.current;-RELEASE</emphasis>
	and <emphasis>FreeBSD &rel.current;-RELEASE</emphasis>.
	This manual is a <emphasis>work in progress</emphasis> and is the work
	of many individuals.  Many sections do not yet exist and some of those
	that do exist need to be updated.  If you are interested in helping
	with this project, send email to the &a.doc;.  The latest version of
	this document is always available from the <ulink
	  url="http://www.FreeBSD.org/">FreeBSD web site</ulink>.
	It may also be downloaded in a variety of formats and compression
	options from the <ulink 
          url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">FreeBSD FTP 
          server</ulink> or one of the numerous <link
	  linkend="mirrors-ftp">mirror sites</link>.  If you would prefer
	  to have a hard copy of the handbook, you can purchase one at the
	  <ulink
	  url="http://www.freebsdmall.com/">FreeBSD Mall</ulink>.  You
	  may also want to <ulink
	  url="&url.base;/search/index.html">search the
	  handbook</ulink>.</para>
    </abstract>
  </bookinfo>

  &chap.preface;

  <part id="getting-started">
    <title>Getting Started</title>
    
    <partintro>
      <para>This part of the FreeBSD Handbook is for users and
	administrators who are new to FreeBSD.  These chapters:</para>

      <itemizedlist>
	<listitem>
	  <para>Introduce you to FreeBSD.</para>
	</listitem>

	<listitem>
	  <para>Guide you through the installation process.</para>
	</listitem>

	<listitem>
	  <para>Teach you &unix; basics and fundamentals.</para>
	</listitem>

	<listitem>
	  <para>Show you how to install the wealth of third party
	    applications available for FreeBSD.</para>
	</listitem>

	<listitem>
	  <para>Introduce you to X, the &unix; windowing system, and
	    detail how to configure a desktop environment that makes you
	    more productive.</para>
	</listitem>
      </itemizedlist>

      <para>We have tried to keep the number of forward references in
	the text to a minimum so that you can read this section of the
	Handbook from front to back with the minimum page flipping
	required.</para>
    </partintro>

    <![ %chap.introduction;             [ &chap.introduction;         ]]>
    <![ %chap.install;                  [ &chap.install;              ]]>
    <![ %chap.basics;                   [ &chap.basics;               ]]>
    <![ %chap.ports;                    [ &chap.ports;                ]]>
    <![ %chap.x11;                      [ &chap.x11;                  ]]>
  </part>
  
  <part id="common-tasks">
    <title>Common Tasks</title>
    
    <partintro>
      <para>Now that the basics have been covered, this part of the
        FreeBSD Handbook will discuss some frequently used features of
        FreeBSD.  These chapters:</para>

      <itemizedlist>
	<listitem>
	  <para>Introduce you to popular and usesul desktop
	    applications: browsers, productivity tools, document
	    viewers, etc.</para>
	</listitem>

	<listitem>
	  <para>Introduce you to a number of multimedia tools
	  available for FreeBSD.</para>
	</listitem>

	<listitem>
	  <para>Explain the process of building a customized FreeBSD
	  kernel, to enable extra functionality on your system.</para>
	</listitem>

        <listitem>
          <para>Describe the print system in detail, both for desktop
          and network-connected printer setups.</para>
        </listitem>

        <listitem>
          <para>Show you how to run Linux applications on your FreeBSD
          system.</para>
        </listitem>

      </itemizedlist>

      <para>Some of these chapters recommend that you do some prior
	reading, and this is noted in the synopsis at the beginning of
	each chapter.</para>

    </partintro>

    <![ %chap.desktop;                  [ &chap.desktop;              ]]>
    <![ %chap.multimedia;               [ &chap.multimedia;           ]]>
    <![ %chap.kernelconfig;             [ &chap.kernelconfig;         ]]>
    <![ %chap.printing;                 [ &chap.printing;             ]]>
    <![ %chap.linuxemu;                 [ &chap.linuxemu;             ]]>
  </part>

  <part id="system-administration">
    <title>System Administration</title>

    <partintro>
      <para>The remaining chapters of the FreeBSD Handbook cover all
	aspects of FreeBSD system administration.  Each chapter
	starts by describing what you will learn as a result of reading
	the chapter, and also details what you are expected to know
	before tackling the material.</para>

      <para>These chapters are designed to be read when
	you need the information.  You do not have to read them in any
	particular order, nor do you need to read all of them before you
	can begin using FreeBSD.</para>
    </partintro>

    <![ %chap.config;                   [ &chap.config;               ]]>
    <![ %chap.boot;                     [ &chap.boot;                 ]]>
    <![ %chap.users;                    [ &chap.users;                ]]>
    <![ %chap.security;                 [ &chap.security;             ]]>
    <![ %chap.mac;			[ &chap.mac;		      ]]>
    <![ %chap.disks;                    [ &chap.disks;                ]]>
    <![ %chap.vinum;                    [ &chap.vinum;                ]]>
    <![ %chap.l10n;                     [ &chap.l10n;                 ]]>
    <![ %chap.cutting-edge;             [ &chap.cutting-edge;         ]]>
  </part>

  <part id="network-communication">
    <title>Network Communication</title>

    <partintro>
      <para>FreeBSD is one of the most widely deployed operating
        systems for high performance network servers.  The chapters in
        this part cover:</para>

      <itemizedlist>
        <listitem>
          <para>Serial communication</para>
        </listitem>

        <listitem>
          <para>PPP and PPP over Ethernet</para>
        </listitem>

        <listitem>
          <para>Electronic Mail</para>
        </listitem>

        <listitem>
          <para>Running Network Servers</para>
        </listitem>

        <listitem>
          <para>Other Advanced Networking Topics</para>
        </listitem>
      </itemizedlist>

      <para>These chapters are designed to be read when
	you need the information.  You do not have to read them in any
	particular order, nor do you need to read all of them before you
	can begin using FreeBSD in a network environment.</para>
    </partintro>

    <![ %chap.serialcomms;              [ &chap.serialcomms;          ]]>
    <![ %chap.ppp-and-slip;             [ &chap.ppp-and-slip;         ]]>
    <![ %chap.mail;                     [ &chap.mail;                 ]]>
    <![ %chap.network-servers;          [ &chap.network-servers;      ]]>
    <![ %chap.advanced-networking;      [ &chap.advanced-networking;  ]]>

  </part>
  
  <part id="appendices">
    <title>Appendices</title>
    
    <![ %chap.mirrors;                  [ &chap.mirrors;              ]]>
    <![ %chap.bibliography;             [ &chap.bibliography;         ]]>
    <![ %chap.eresources;               [ &chap.eresources;           ]]>
    <![ %chap.pgpkeys;                  [ &chap.pgpkeys;              ]]>
  </part>
  <![ %chap.freebsd-glossary;         [ &bookinfo.freebsd-glossary; ]]>
  <![ %chap.index;                    [ &chap.index;                ]]>
  &chap.colophon;
</book>

<!-- 
     Local Variables:
     mode: sgml
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-always-quote-attributes: t
     End:
-->