article.xml revision 81327
176082Sbmah<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [ 276082Sbmah<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"> 376082Sbmah%man; 476082Sbmah<!ENTITY % authors PUBLIC "-//FreeBSD//ENTITIES DocBook Author Entities//EN"> 576082Sbmah%authors; 676082Sbmah<!ENTITY % mlists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//EN"> 776082Sbmah%mlists; 876082Sbmah<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN"> 976082Sbmah%release; 1076082Sbmah]> 1176082Sbmah 1276082Sbmah<article> 1381327Sbmah<articleinfo> 1481327Sbmah <title>&os; &release.current; README</title> 1581327Sbmah 1681327Sbmah <corpauthor>The &os; Project</corpauthor> 1781327Sbmah <pubdate>$FreeBSD: head/release/doc/en_US.ISO8859-1/readme/article.sgml 81327 2001-08-09 00:35:04Z bmah $</pubdate> 1881327Sbmah 1981327Sbmah <copyright> 2081327Sbmah <year>2000</year> 2181327Sbmah <year>2001</year> 2281327Sbmah <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder> 2381327Sbmah </copyright> 2481327Sbmah</articleinfo> 2581327Sbmah<abstract> 2681327Sbmah <para>This document gives a brief introduction to &os; 2781327Sbmah &release.current;. It includes a roadmap to the other release 2881327Sbmah documentation files, as well as some pointers on obtaining &os; and 2981327Sbmah contacting the &os; development team.</para> 3081327Sbmah</abstract> 3181327Sbmah<sect1> 3281327Sbmah <title>Introduction</title> 3381327Sbmah 3481327Sbmah <para>This distribution is a &release.type; of &os; &release.current;, the 3581327Sbmah latest point along the &release.branch; branch.</para> 3681327Sbmah 3781327Sbmah <sect2> 3881327Sbmah <title>Target Audience</title> 3981327Sbmah 4081327Sbmah<![ %release.type.snapshot; [ 4181327Sbmah <para>This &release.type; is aimed primarily at early adopters and 4281327Sbmah various other users who want to get involved with the ongoing 4381327Sbmah development of &os;. While the &os; development team tries its 4481327Sbmah best to ensure that each &release.type; works as 4581327Sbmah advertised, &release.branch; is very much a work-in-progress.</para> 4681327Sbmah 4781327Sbmah <para>The basic requirements for using this &release.type are 4881327Sbmah technical proficiency with &os; and an understanding of the ongoing 4981327Sbmah development process of &os; &release.current; 5081327Sbmah (as discussed on the &a.current;).</para> 5181327Sbmah 5281327Sbmah <para>For those more interested 5381327Sbmah in doing business with &os; than in experimenting with new &os; 5481327Sbmah technology, formal releases (such as &release.prev;) are frequently more 5581327Sbmah appropriate. Releases undergo a period of testing and quality 5681327Sbmah assurance checking to ensure high reliability and dependability.</para> 5781327Sbmah]]> 5881327Sbmah 5981327Sbmah<![ %release.type.release; [ 6081327Sbmah <para>This &release.type; of &os; is suitable for all users. It has 6181327Sbmah undergone a period of testing and quality assurance 6281327Sbmah checking to ensure the highest reliability and dependability.</para> 6381327Sbmah]]> 6481327Sbmah 6581327Sbmah </sect2> 6681327Sbmah 6781327Sbmah <sect2 id="release-docs"> 6881327Sbmah <title>Release Documentation</title> 6981327Sbmah 7081327Sbmah <para>A number of other files provide more specific information 7181327Sbmah about this &release.type; distribution. These files are provided 7281327Sbmah in various formats. Most distributions will include both ASCII 7381327Sbmah text (<filename>.TXT</filename>) and HTML 7481327Sbmah (<filename>.HTM</filename>) renditions. Some distributions may 7581327Sbmah also include other formats such as PostScript 7681327Sbmah (<filename>.PS</filename>) or Portable Document Format 7781327Sbmah (<filename>.PDF</filename>). 7881327Sbmah 7981327Sbmah <itemizedlist> 8081327Sbmah <listitem> 8181327Sbmah <para><filename>README.TXT</filename>: This file, which 8281327Sbmah gives some general information about &os; as well as some 8381327Sbmah cursory notes about obtaining a distribution.</para> 8481327Sbmah </listitem> 8581327Sbmah <listitem> 8681327Sbmah <para><filename>RELNOTES.TXT</filename>: The release notes, 8781327Sbmah showing what's new and different in &os; &release.current; 8881327Sbmah compared to &os; &release.prev;.</para> 8981327Sbmah </listitem> 9081327Sbmah <listitem> 9181327Sbmah <para><filename>HARDWARE.TXT</filename>: The hardware 9281327Sbmah compatability list, showing devices with which &os; has been 9381327Sbmah tested and is known to work.</para> 9481327Sbmah </listitem> 9581327Sbmah <listitem> 9681327Sbmah <para><filename>INSTALL.TXT</filename>: Installation 9781327Sbmah instructions for installing &os; from its distribution 9881327Sbmah media.</para> 9981327Sbmah </listitem> 10081327Sbmah <listitem> 10181327Sbmah <para><filename>ERRATA.TXT</filename>: Release errata. 10281327Sbmah Late-breaking, post-release information can be found in this 10381327Sbmah file, which is principally applicable to releases (as opposed to 10481327Sbmah snapshots). It is important to consult this file before 10581327Sbmah installing a release of &os;, as it contains 10681327Sbmah the latest information on problems which have been found and 10781327Sbmah fixed since the release was created.</para> 10881327Sbmah </listitem> 10981327Sbmah </itemizedlist> 11081327Sbmah 11181327Sbmah </para> 11281327Sbmah 11381327Sbmah <para>Most information is also available from the 11481327Sbmah Documentation menu during installation.</para> 11581327Sbmah 11681327Sbmah </sect2> 11781327Sbmah 11881327Sbmah</sect1> 11981327Sbmah<sect1> 12081327Sbmah <title>About &os;</title> 12181327Sbmah 12281327Sbmah <para>&os; is an operating system based on 4.4 BSD 12381327Sbmah Lite for Intel, AMD, Cyrix or NexGen <quote>x86</quote> based PC 12481327Sbmah hardware and Compaq (formerly DEC) Alpha computers. Versions for 12581327Sbmah the IA64 and PowerPC architectures are currently under 12681327Sbmah development as well. &os; works with a 12781327Sbmah wide variety of peripherals and configurations and can be 12881327Sbmah used for everything from software development to games to Internet Service 12981327Sbmah Provision.</para> 13081327Sbmah 13181327Sbmah <para>This release of &os; contains everything you need to run 13281327Sbmah such a system, including full source code for the kernel and all 13381327Sbmah utilities in the base distribution. With the 13481327Sbmah source distribution installed, you can literally recompile the entire 13581327Sbmah system from scratch with one command, making it ideal for students, 13681327Sbmah researchers, or users who simply want to see how it all works.</para> 13781327Sbmah 13881327Sbmah <para>A large collection of third-party ported software (the 13981327Sbmah <quote>Ports Collection</quote>) is also provided to make it easy 14081327Sbmah to obtain and install all your favorite traditional UNIX 14181327Sbmah utilities for &os;. Each 14281327Sbmah <quote>port</quote> consists of a set of scripts to retrieve, 14381327Sbmah configure, build, and install a piece of software, with a single 14481327Sbmah command. Over 5000 ports, from editors to programming 14581327Sbmah languages to graphical applications, make &os; a powerful and 14681327Sbmah comprehensive operating environment that extends far beyond what's 14781327Sbmah provided by many commercial versions of UNIX. Most ports are also 14881327Sbmah available as pre-compiled <quote>packages</quote>, which can be 14981327Sbmah quickly installed from the installation program.</para> 15081327Sbmah 15181327Sbmah <para>Pointers to more documentation on &os; can be found in the 15281327Sbmah <ulink 15381327Sbmah url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html#BIBLIOGRAPHY-FREEBSD">Books 15481327Sbmah & Magazines Specific to FreeBSD</ulink> section of the &os; Handbook. 15581327Sbmah Because of &os;'s strong UNIX heritage, many other articles and books written 15681327Sbmah for UNIX systems are applicable as well. A selection of these documents 15781327Sbmah can be found in the Handbook's <ulink 15881327Sbmah url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html">Bibliography</ulink>. 15981327Sbmah </para> 16081327Sbmah 16181327Sbmah <para>If you're new to &os; then you should also read 16281327Sbmah all of the documentation files listed in <xref linkend="release-docs">, 16381327Sbmah all of which are available from the Documentation menu in the 16481327Sbmah installation program. 16581327Sbmah It may seem 16681327Sbmah like a lot to read, but it's important to at least acquaint yourself with 16781327Sbmah the types of information available, should you run into problems later. Once 16881327Sbmah the system is installed, you can also revisit this menu by running 16981327Sbmah the &man.sysinstall.8; utility.</para> 17081327Sbmah 17181327Sbmah <para>On-line 17281327Sbmah versions of the <ulink 17381327Sbmah url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/">FAQ</ulink> 17481327Sbmah (Frequently Asked Questions document) and <ulink 17581327Sbmah url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">Handbook</ulink> are always 17681327Sbmah available from the <ulink 17781327Sbmah url="http://www.FreeBSD.org/docs.html">FreeBSD Documentation 17881327Sbmah page</ulink> or its mirrors. 17981327Sbmah If you install the 18081327Sbmah <filename>doc</filename> distribution set, you can use a 18181327Sbmah Web browser to read the FAQ and Handbook locally.</para> 18281327Sbmah 18381327Sbmah <note> 18481327Sbmah <para>It is extremely important to read the errata for any given 18581327Sbmah release before installing it, to learn about any 18681327Sbmah <quote>late-breaking news</quote> or post-release problems. 18781327Sbmah The 18881327Sbmah errata file accompanying each release 18981327Sbmah (most likely right next to this file) is already out of 19081327Sbmah date by definition, but other copies are kept updated on the Internet 19181327Sbmah and should be consulted as the <quote>current errata</quote> for 19281327Sbmah this release. These 19381327Sbmah other copies of the errata are located at 19481327Sbmah <ulink url="http://www.FreeBSD.org/releases/"></ulink> 19581327Sbmah (as well as any sites which keep up-to-date mirrors of this 19681327Sbmah location).</para> 19781327Sbmah </note> 19881327Sbmah</sect1> 19981327Sbmah<sect1> 20081327Sbmah <title>Obtaining &os;</title> 20181327Sbmah 20281327Sbmah <para>&os; may be obtained in a variety of ways. This section 20381327Sbmah focuses on those ways that are primarily of use for obtaining a 20481327Sbmah complete &os; distribution, rather than updating an existing 20581327Sbmah installation.</para> 20681327Sbmah 20781327Sbmah <sect2> 20881327Sbmah <title>CDROM and DVD</title> 20981327Sbmah 21081327Sbmah <para>&os; -RELEASE distributions (for example, 4.3-RELEASE) may 21181327Sbmah be ordered on CDROM or DVD from several publishers. This is 21281327Sbmah frequently the most convenient way to obtain &os; for new 21381327Sbmah installations, as it provides a convenient way to quickly 21481327Sbmah reinstall the system if necessary. Some distributions include 21581327Sbmah some of the optional, precompiled <quote>packages</quote> from the 21681327Sbmah &os; Ports Collection.</para> 21781327Sbmah 21881327Sbmah <para>A list of the CDROM and DVD 21981327Sbmah publishers known to the project are listed in the <ulink 22081327Sbmah url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors.html"><quote>Obtaining 22181327Sbmah FreeBSD</quote></ulink> appendix to the Handbook.</para> 22281327Sbmah </sect2> 22381327Sbmah 22481327Sbmah <sect2> 22581327Sbmah <title>FTP</title> 22681327Sbmah 22781327Sbmah <para>You can use FTP to retrieve &os; and any or all of its 22881327Sbmah optional packages from <ulink 22981327Sbmah url="ftp://ftp.FreeBSD.org/"></ulink>, which 23081327Sbmah is the 23181327Sbmah official &os; release site, or any of its <quote>mirrors</quote>.</para> 23281327Sbmah 23381327Sbmah <para>Lists of locations that mirror &os; 23481327Sbmah can be found in the <ulink 23581327Sbmah url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors-ftp.html">FTP 23681327Sbmah Sites</ulink> section of the Handbook, or on the 23781327Sbmah <ulink url="http://www.freebsdmirrors.org/"></ulink> Web pages. 23881327Sbmah Finding a close (in networking terms) mirror from which to 23981327Sbmah download the distribution is highly recommended.</para> 24081327Sbmah 24181327Sbmah <para>Additional mirror sites are 24281327Sbmah always welcome. 24381327Sbmah Contact <email>freebsd-admin@FreeBSD.org</email> for more 24481327Sbmah details on becoming an official mirror site.</para> 24581327Sbmah 24681327Sbmah <para>Mirrors generally contain the floppy disk images necessary 24781327Sbmah to begin an installation, as well as the distribution files needed 24881327Sbmah for the install process itself. Some mirrors also contain some of 24981327Sbmah the ISO images necessary to create a CDROM of a &os; release.</para> 25081327Sbmah 25181327Sbmah </sect2> 25281327Sbmah</sect1> 25381327Sbmah<sect1 id="contacting"> 25481327Sbmah <title>Contacting the &os; Project</title> 25581327Sbmah 25681327Sbmah <sect2> 25781327Sbmah <title>Email and Mailing Lists</title> 25881327Sbmah <para>For any questions or general technical support issues, please send 25981327Sbmah mail to the &a.questions;.</para> 26081327Sbmah 26181327Sbmah <para>If you're tracking the -current development efforts, you 26281327Sbmah <emphasis>must</emphasis> join the &a.current;, in order to keep 26381327Sbmah abreast of recent developments and changes that may affect the way 26481327Sbmah you use and maintain the system. 26581327Sbmah 26681327Sbmah <para>Additionally, being a largely-volunteer effort, the &os; 26781327Sbmah Project is always happy to 26881327Sbmah have extra hands willing to help — there are already far more 26981327Sbmah desired enhancements than there is time to implement them. 27081327Sbmah To contact the developers on technical matters, or with offers of help, please 27181327Sbmah send mail to the &a.hackers;.</para> 27281327Sbmah 27381327Sbmah <para>Please note that these mailing lists can experience 27481327Sbmah <emphasis>significant</emphasis> amounts of traffic and if you have 27581327Sbmah slow or expensive mail access and are only interested in keeping up 27681327Sbmah with significant &os; events, you may find it preferable to 27781327Sbmah subscribe instead to the &a.announce;.</para> 27881327Sbmah 27981327Sbmah <para>All of the mailing lists can be freely joined by anyone 28081327Sbmah wishing to do so. Send mail to &a.majordomo; 28181327Sbmah and include the keyword <literal>help</literal> on a line by itself 28281327Sbmah somewhere in the body of the message. This will give you more 28381327Sbmah information on joining the various lists, accessing archives, etc. 28481327Sbmah There are a number of mailing lists targeted at special interest 28581327Sbmah groups not mentioned here; more information can be obtained either 28681327Sbmah through majordomo or the <ulink 28781327Sbmah url="http://www.FreeBSD.org/support.html#mailing-list">mailing lists 28881327Sbmah section</ulink> of the &os; Web site.</para> 28981327Sbmah 29081327Sbmah <important> 29181327Sbmah <para>Do <emphasis>not</emphasis> send email to the lists asking to 29281327Sbmah be subscribed. Use the &a.majordomo; address 29381327Sbmah instead.</para> 29481327Sbmah </important> 29581327Sbmah </sect2> 29681327Sbmah 29781327Sbmah <sect2> 29881327Sbmah <title>Submitting Problem Reports</title> 29981327Sbmah 30081327Sbmah <para>Suggestions, bug reports and contributions of code are 30181327Sbmah always valued — please do not hesitate to report any problems you 30281327Sbmah may find. Bug reports with attached fixes are of course even more 30381327Sbmah welcome.</para> 30481327Sbmah 30581327Sbmah <para>The preferred method to submit bug reports from a machine with 30681327Sbmah Internet mail connectivity is to use the &man.send-pr.1; command or 30781327Sbmah use the Web form at <ulink 30881327Sbmah url="http://www.FreeBSD.org/send-pr.html">http://www.FreeBSD.org/send-pr.html</ulink>. 30981327Sbmah <quote>Problem Reports</quote> (PRs) submitted in this way will be filed and 31081327Sbmah their progress tracked; the &os; developers will do their best to respond to all 31181327Sbmah reported bugs as soon as possible. <ulink url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi">A list of all active PRs</ulink> is 31281327Sbmah available on the &os; Web site; this list is useful to see what 31381327Sbmah potential problems other users have encountered.</para> 31481327Sbmah 31581327Sbmah <para>Note that &man.send-pr.1; itself is a shell script that should 31681327Sbmah be easy to move even onto a non-&os; system. Using this interface 31781327Sbmah is highly preferred. 31881327Sbmah If, for some reason, you are unable to use &man.send-pr.1; to 31981327Sbmah submit a bug report, you can try to send it to the &a.bugs;.</para> 32081327Sbmah 32181327Sbmah <para>In any case, before submitting a PR, 32281327Sbmah please try to determine whether the problem might have already been 32381327Sbmah fixed since.</para> 32481327Sbmah 32581327Sbmah </sect2> 32681327Sbmah 32781327Sbmah</sect1> 32881327Sbmah<sect1> 32981327Sbmah <title>Acknowledgments</title> 33081327Sbmah 33181327Sbmah <para>&os; represents the cumulative work of many hundreds, if not 33281327Sbmah thousands, of individuals from around the world who have worked 33381327Sbmah countless hours to bring about this &release.type;. 33481327Sbmah For a complete list of &os; developers and contributors, please see 33581327Sbmah <ulink 33681327Sbmah url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributors/">Contributors 33781327Sbmah to FreeBSD</ulink> on the &os; Web site or any of its mirrors.</para> 33881327Sbmah 33981327Sbmah <para>Special thanks also go to the many thousands of &os; users and 34081327Sbmah testers all over the world, without whom this &release.type; simply would 34181327Sbmah not have been possible.</para> 34281327Sbmah 34381327Sbmah</sect1> 34476082Sbmah</article> 345