doc/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml
Giorgos Keramidas bf0250d8c3 Document the sun4v mailing list.
PR:		docs/104558
Submitted by:	postmaster (David Wolfskill)
2006-10-20 19:18:37 +00:00

1791 lines
52 KiB
Text

<!--
The FreeBSD Documentation Project
$FreeBSD$
-->
<appendix id="eresources">
<title>Resources on the Internet</title>
<para>The rapid pace of FreeBSD progress makes print media impractical as a
means of following the latest developments. Electronic resources are the
best, if not often the only, way stay informed of the latest advances.
Since FreeBSD is a volunteer effort, the user community itself also
generally serves as a <quote>technical support department</quote> of sorts,
with electronic mail and USENET news being the most effective way of
reaching that community.</para>
<para>The most important points of contact with the FreeBSD user community
are outlined below. If you are aware of other resources not mentioned
here, please send them to the &a.doc; so that they may also be
included.</para>
<sect1 id="eresources-mail">
<title>Mailing Lists</title>
<para>Though many of the FreeBSD development members read USENET, we
cannot always guarantee that we will get to your questions in a timely
fashion (or at all) if you post them only to one of the
<literal>comp.unix.bsd.freebsd.*</literal> groups. By addressing your
questions to the appropriate mailing list you will reach both us and a
concentrated FreeBSD audience, invariably assuring a better (or at least
faster) response.</para>
<para>The charters for the various lists are given at the bottom of this
document. <emphasis>Please read the charter before joining or sending
mail to any list</emphasis>. Most of our list subscribers now receive
many hundreds of FreeBSD related messages every day, and by setting down
charters and rules for proper use we are striving to keep the
signal-to-noise ratio of the lists high. To do less would see the
mailing lists ultimately fail as an effective communications medium for
the project.</para>
<para>When in doubt about what list to post a question to, see <ulink
url="&url.articles.freebsd-questions;">How to get best results from
the FreeBSD-questions mailing list</ulink>.</para>
<para>Before posting to any list, please learn about how to best use
the mailing lists, such as how to help avoid frequently-repeated
discussions, by reading the <ulink url="&url.articles.mailing-list-faq;">
Mailing List Frequently Asked Questions</ulink> (FAQ) document.</para>
<para>Archives are kept for all of the mailing lists and can be searched
using the <ulink url="&url.base;/search/index.html">FreeBSD World
Wide Web server</ulink>. The keyword searchable archive offers an
excellent way of finding answers to frequently asked questions and
should be consulted before posting a question.</para>
<sect2 id="eresources-summary">
<title>List Summary</title>
<para><emphasis>General lists:</emphasis> The following are general
lists which anyone is free (and encouraged) to join:</para>
<informaltable frame="none" pgwide="1">
<tgroup cols="2">
<thead>
<row>
<entry>List</entry>
<entry>Purpose</entry>
</row>
</thead>
<tbody>
<row>
<entry>&a.cvsall.name;</entry>
<entry>Changes made to the FreeBSD source tree</entry>
</row>
<row>
<entry>&a.advocacy.name;</entry>
<entry>FreeBSD Evangelism</entry>
</row>
<row>
<entry>&a.announce.name;</entry>
<entry>Important events and project milestones</entry>
</row>
<row>
<entry>&a.arch.name;</entry>
<entry>Architecture and design discussions</entry>
</row>
<row>
<entry>&a.bugbusters.name;</entry>
<entry>Discussions pertaining to the maintenance of the FreeBSD
problem report database and related tools</entry>
</row>
<row>
<entry>&a.bugs.name;</entry>
<entry>Bug reports</entry>
</row>
<row>
<entry>&a.chat.name;</entry>
<entry>Non-technical items related to the FreeBSD
community</entry>
</row>
<row>
<entry>&a.current.name;</entry>
<entry>Discussion concerning the use of
&os.current;</entry>
</row>
<row>
<entry>&a.isp.name;</entry>
<entry>Issues for Internet Service Providers using
FreeBSD</entry>
</row>
<row>
<entry>&a.jobs.name;</entry>
<entry>FreeBSD employment and consulting
opportunities</entry>
</row>
<row>
<entry>&a.policy.name;</entry>
<entry>FreeBSD Core team policy decisions. Low volume, and
read-only</entry>
</row>
<row>
<entry>&a.questions.name;</entry>
<entry>User questions and technical support</entry>
</row>
<row>
<entry>&a.security-notifications.name;</entry>
<entry>Security notifications</entry>
</row>
<row>
<entry>&a.stable.name;</entry>
<entry>Discussion concerning the use of
&os.stable;</entry>
</row>
<row>
<entry>&a.test.name;</entry>
<entry>Where to send your test messages instead of one of
the actual lists</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para><emphasis>Technical lists:</emphasis> The following lists are for
technical discussion. You should read the charter for each list
carefully before joining or sending mail to one as there are firm
guidelines for their use and content.</para>
<informaltable frame="none" pgwide="1">
<tgroup cols="2">
<thead>
<row>
<entry>List</entry>
<entry>Purpose</entry>
</row>
</thead>
<tbody>
<row>
<entry>&a.acpi.name;</entry>
<entry>ACPI and power management development</entry>
</row>
<row>
<entry>&a.afs.name;</entry>
<entry>Porting AFS to FreeBSD</entry>
</row>
<row>
<entry>&a.aic7xxx.name;</entry>
<entry>Developing drivers for the &adaptec; AIC 7xxx</entry>
</row>
<row>
<entry>&a.alpha.name;</entry>
<entry>Porting FreeBSD to the Alpha</entry>
</row>
<row>
<entry>&a.amd64.name;</entry>
<entry>Porting FreeBSD to AMD64 systems</entry>
</row>
<row>
<entry>&a.apache.name;</entry>
<entry>Discussion about <application>Apache</application> related ports</entry>
</row>
<row>
<entry>&a.arm.name;</entry>
<entry>Porting FreeBSD to &arm; processors</entry>
</row>
<row>
<entry>&a.atm.name;</entry>
<entry>Using ATM networking with FreeBSD</entry>
</row>
<row>
<entry>&a.audit.name;</entry>
<entry>Source code audit project</entry>
</row>
<row>
<entry>&a.binup.name;</entry>
<entry>Design and development of the binary update system</entry>
</row>
<row>
<entry>&a.bluetooth.name;</entry>
<entry>Using &bluetooth; technology in FreeBSD</entry>
</row>
<row>
<entry>&a.cluster.name;</entry>
<entry>Using FreeBSD in a clustered environment</entry>
</row>
<row>
<entry>&a.cvsweb.name;</entry>
<entry>CVSweb maintenance</entry>
</row>
<row>
<entry>&a.database.name;</entry>
<entry>Discussing database use and development under
FreeBSD</entry>
</row>
<row>
<entry>&a.doc.name;</entry>
<entry>Creating FreeBSD related documents</entry>
</row>
<row>
<entry>&a.drivers.name;</entry>
<entry>Writing device drivers for &os;</entry>
</row>
<row>
<entry>&a.eclipse.name;</entry>
<entry>FreeBSD users of Eclipse IDE, tools, rich client
applications and ports.</entry>
</row>
<row>
<entry>&a.embedded.name;</entry>
<entry>Using FreeBSD in embedded applications</entry>
</row>
<row>
<entry>&a.emulation.name;</entry>
<entry>Emulation of other systems such as
Linux/&ms-dos;/&windows;</entry>
</row>
<row>
<entry>&a.firewire.name;</entry>
<entry>FreeBSD &firewire; (iLink, IEEE 1394) technical
discussion</entry>
</row>
<row>
<entry>&a.fs.name;</entry>
<entry>File systems</entry>
</row>
<row>
<entry>&a.geom.name;</entry>
<entry>GEOM-specific discussions and implementations</entry>
</row>
<row>
<entry>&a.gnome.name;</entry>
<entry>Porting <application>GNOME</application> and <application>GNOME</application> applications</entry>
</row>
<row>
<entry>&a.hackers.name;</entry>
<entry>General technical discussion</entry>
</row>
<row>
<entry>&a.hardware.name;</entry>
<entry>General discussion of hardware for running
FreeBSD</entry>
</row>
<row>
<entry>&a.i18n.name;</entry>
<entry>FreeBSD Internationalization</entry>
</row>
<row>
<entry>&a.ia32.name;</entry>
<entry>FreeBSD on the IA-32 (&intel; x86) platform</entry>
</row>
<row>
<entry>&a.ia64.name;</entry>
<entry>Porting FreeBSD to &intel;'s upcoming IA64 systems</entry>
</row>
<row>
<entry>&a.ipfw.name;</entry>
<entry>Technical discussion concerning the redesign of the IP
firewall code</entry>
</row>
<row>
<entry>&a.isdn.name;</entry>
<entry>ISDN developers</entry>
</row>
<row>
<entry>&a.java.name;</entry>
<entry>&java; developers and people porting &jdk;s to
FreeBSD</entry>
</row>
<row>
<entry>&a.kde.name;</entry>
<entry>Porting <application>KDE</application> and <application>KDE</application> applications</entry>
</row>
<row>
<entry>&a.lfs.name;</entry>
<entry>Porting LFS to FreeBSD</entry>
</row>
<row>
<entry>&a.libh.name;</entry>
<entry>The second generation installation and package
system</entry>
</row>
<row>
<entry>&a.mips.name;</entry>
<entry>Porting FreeBSD to &mips;</entry>
</row>
<row>
<entry>&a.mobile.name;</entry>
<entry>Discussions about mobile computing</entry>
</row>
<row>
<entry>&a.mozilla.name;</entry>
<entry>Porting <application>Mozilla</application> to FreeBSD</entry>
</row>
<row>
<entry>&a.multimedia.name;</entry>
<entry>Multimedia applications</entry>
</row>
<row>
<entry>&a.newbus.name;</entry>
<entry>Technical discussions about bus architecture</entry>
</row>
<row>
<entry>&a.net.name;</entry>
<entry>Networking discussion and TCP/IP source code</entry>
</row>
<row>
<entry>&a.openoffice.name;</entry>
<entry>Porting <application>OpenOffice.org</application> and
<application>&staroffice;</application> to FreeBSD</entry>
</row>
<row>
<entry>&a.performance.name;</entry>
<entry>Performance tuning questions for high
performance/load installations</entry>
</row>
<row>
<entry>&a.perl.name;</entry>
<entry>Maintenance of a number of
Perl-related ports</entry>
</row>
<row>
<entry>&a.pf.name;</entry>
<entry>Discussion and questions about the packet filter
firewall system</entry>
</row>
<row>
<entry>&a.platforms.name;</entry>
<entry>Concerning ports to non &intel; architecture
platforms</entry>
</row>
<row>
<entry>&a.ports.name;</entry>
<entry>Discussion of the Ports Collection</entry>
</row>
<row>
<entry>&a.ports-bugs.name;</entry>
<entry>Discussion of the ports bugs/PRs</entry>
</row>
<row>
<entry>&a.ppc.name;</entry>
<entry>Porting FreeBSD to the &powerpc;</entry>
</row>
<row>
<entry>&a.proliant.name;</entry>
<entry>Technical discussion of FreeBSD on HP ProLiant server platforms</entry>
</row>
<row>
<entry>&a.python.name;</entry>
<entry>FreeBSD-specific Python issues</entry>
</row>
<row>
<entry>&a.qa.name;</entry>
<entry>Discussion of Quality Assurance, usually pending a release</entry>
</row>
<row>
<entry>&a.rc.name;</entry>
<entry>Discussion related to the <filename>rc.d</filename> system and its development</entry>
</row>
<row>
<entry>&a.realtime.name;</entry>
<entry>Development of realtime extensions to FreeBSD</entry>
</row>
<row>
<entry>&a.scsi.name;</entry>
<entry>The SCSI subsystem</entry>
</row>
<row>
<entry>&a.security.name;</entry>
<entry>Security issues affecting FreeBSD</entry>
</row>
<row>
<entry>&a.small.name;</entry>
<entry>Using FreeBSD in embedded applications
(obsolete; use &a.embedded.name; instead)</entry>
</row>
<row>
<entry>&a.smp.name;</entry>
<entry>Design discussions for [A]Symmetric
MultiProcessing</entry>
</row>
<row>
<entry>&a.sparc.name;</entry>
<entry>Porting FreeBSD to &sparc; based systems</entry>
</row>
<row>
<entry>&a.standards.name;</entry>
<entry>FreeBSD's conformance to the C99 and the &posix;
standards</entry>
</row>
<row>
<entry>&a.sun4v.name;</entry>
<entry>Porting FreeBSD to &sun4v; based systems</entry>
</row>
<row>
<entry>&a.threads.name;</entry>
<entry>Threading in FreeBSD</entry>
</row>
<row>
<entry>&a.testing.name;</entry>
<entry>FreeBSD Performance and Stability Tests</entry>
</row>
<row>
<entry>&a.tokenring.name;</entry>
<entry>Support Token Ring in FreeBSD</entry>
</row>
<row>
<entry>&a.usb.name;</entry>
<entry>Discussing &os; support for USB</entry>
</row>
<row>
<entry>&a.vuxml.name;</entry>
<entry>Discussion on VuXML infrastructure</entry>
</row>
<row>
<entry>&a.x11.name;</entry>
<entry>Maintenance and support of X11 on FreeBSD</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para><emphasis>Limited lists:</emphasis> The following lists are for
more specialized (and demanding) audiences and are probably not of
interest to the general public. It is also a good idea to establish a
presence in the technical lists before joining one of these limited
lists so that you will understand the communications etiquette involved.</para>
<informaltable frame="none" pgwide="1">
<tgroup cols="2">
<thead>
<row>
<entry>List</entry>
<entry>Purpose</entry>
</row>
</thead>
<tbody>
<row>
<entry>&a.hubs.name;</entry>
<entry>People running mirror sites (infrastructural
support)</entry>
</row>
<row>
<entry>&a.usergroups.name;</entry>
<entry>User group coordination</entry>
</row>
<row>
<entry>&a.vendors.name;</entry>
<entry>Vendors pre-release coordination</entry>
</row>
<row>
<entry>&a.www.name;</entry>
<entry>Maintainers of <ulink url="&url.base;/index.html">www.FreeBSD.org</ulink></entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para><emphasis>Digest lists:</emphasis> All of the above lists
are available in a digest format. Once subscribed to a list,
you can change your digest options in your account options
section.</para>
<para><emphasis>CVS lists:</emphasis> The following lists are for people
interested in seeing the log messages for changes to various areas of
the source tree. They are <emphasis>Read-Only</emphasis> lists and
should not have mail sent to them.</para>
<informaltable frame="none" pgwide="1">
<tgroup cols="3">
<thead>
<row>
<entry>List</entry>
<entry>Source area</entry>
<entry>Area Description (source for)</entry>
</row>
</thead>
<tbody>
<row>
<entry>&a.cvsall.name;</entry>
<entry><filename>/usr/(CVSROOT|doc|ports|projects|src)</filename></entry>
<entry>All changes to any place in the tree (superset of other CVS commit lists)</entry>
</row>
<row>
<entry>&a.cvs-doc.name;</entry>
<entry><filename>/usr/(doc|www)</filename></entry>
<entry>All changes to the doc and www trees</entry>
</row>
<row>
<entry>&a.cvs-ports.name;</entry>
<entry><filename>/usr/ports</filename></entry>
<entry>All changes to the ports tree</entry>
</row>
<row>
<entry>&a.cvs-projects.name;</entry>
<entry><filename>/usr/projects</filename></entry>
<entry>All changes to the projects tree</entry>
</row>
<row>
<entry>&a.cvs-src.name;</entry>
<entry><filename>/usr/src</filename></entry>
<entry>All changes to the src tree</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect2>
<sect2 id="eresources-subscribe">
<title>How to Subscribe</title>
<para>To subscribe to a list, click on the list name above or
go to &a.mailman.lists.link;
and click on the list that you are interested in. The list
page should contain all of the necessary subscription
instructions.</para>
<para>To actually post to a given list you simply send mail to
<email><replaceable>listname</replaceable>@FreeBSD.org</email>. It will then
be redistributed to mailing list members world-wide.</para>
<para>To unsubscribe yourself from a list, click on the URL
found at the bottom of every email received from the list. It
is also possible to send an email to
<email><replaceable>listname</replaceable>-unsubscribe@FreeBSD.org</email> to unsubscribe
yourself.</para>
<para>Again, we would like to request that you keep discussion in the
technical mailing lists on a technical track. If you are only
interested in important announcements then it is suggested that
you join the &a.announce;, which is intended only for infrequent
traffic.</para>
</sect2>
<sect2 id="eresources-charters">
<title>List Charters</title>
<para><emphasis>All</emphasis> FreeBSD mailing lists have certain basic
rules which must be adhered to by anyone using them. Failure to comply
with these guidelines will result in two (2) written warnings from the
FreeBSD Postmaster <email>postmaster@FreeBSD.org</email>, after which,
on a third offense, the poster will removed from all FreeBSD mailing
lists and filtered from further posting to them. We regret that such
rules and measures are necessary at all, but today's Internet is a
pretty harsh environment, it would seem, and many fail to appreciate
just how fragile some of its mechanisms are.</para>
<para>Rules of the road:</para>
<itemizedlist>
<listitem>
<para>The topic of any posting should adhere to the basic charter of
the list it is posted to, e.g. if the list is about technical
issues then your posting should contain technical discussion.
Ongoing irrelevant chatter or flaming only detracts from the value
of the mailing list for everyone on it and will not be tolerated.
For free-form discussion on no particular topic, the &a.chat;
is freely available and should be used instead.</para>
</listitem>
<listitem>
<para>No posting should be made to more than 2 mailing lists, and
only to 2 when a clear and obvious need to post to both lists
exists. For most lists, there is already a great deal of
subscriber overlap and except for the most esoteric mixes (say
<quote>-stable &amp; -scsi</quote>), there really is no reason to post to more
than one list at a time. If a message is sent to you in such a
way that multiple mailing lists appear on the
<literal>Cc</literal> line then the <literal>Cc</literal>
line should also be trimmed before sending it out again.
<emphasis>You are still responsible for your
own cross-postings, no matter who the originator might have
been.</emphasis></para>
</listitem>
<listitem>
<para>Personal attacks and profanity (in the context of an argument)
are not allowed, and that includes users and developers alike.
Gross breaches of netiquette, like excerpting or reposting private
mail when permission to do so was not and would not be
forthcoming, are frowned upon but not specifically enforced.
<emphasis>However</emphasis>, there are also very few cases where
such content would fit within the charter of a list and it would
therefore probably rate a warning (or ban) on that basis
alone.</para>
</listitem>
<listitem>
<para>Advertising of non-FreeBSD related products or services is
strictly prohibited and will result in an immediate ban if it is
clear that the offender is advertising by spam.</para>
</listitem>
</itemizedlist>
<para><emphasis>Individual list charters:</emphasis></para>
<variablelist>
<varlistentry>
<term>&a.acpi.name;</term>
<listitem>
<para><emphasis>ACPI and power management
development</emphasis></para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.afs.name;</term>
<listitem>
<para><emphasis>Andrew File System</emphasis></para>
<para>This list is for discussion on porting and using AFS from
CMU/Transarc</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.announce.name;</term>
<listitem>
<para><emphasis>Important events / milestones</emphasis></para>
<para>This is the mailing list for people interested only in
occasional announcements of significant FreeBSD events. This
includes announcements about snapshots and other releases. It
contains announcements of new FreeBSD capabilities. It may
contain calls for volunteers etc. This is a low volume, strictly
moderated mailing list.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.arch.name;</term>
<listitem>
<para><emphasis>Architecture and design
discussions</emphasis></para>
<para>This list is for discussion of the FreeBSD
architecture. Messages will mostly be kept strictly
technical in nature. Examples of suitable topics
are:</para>
<itemizedlist>
<listitem>
<para>How to re-vamp the build system to have several
customized builds running at the same time.</para>
</listitem>
<listitem>
<para>What needs to be fixed with VFS to make Heidemann layers
work.</para>
</listitem>
<listitem>
<para>How do we change the device driver interface to be able
to use the same drivers cleanly on many buses and
architectures.</para>
</listitem>
<listitem>
<para>How to write a network driver.</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.audit.name;</term>
<listitem>
<para><emphasis>Source code audit project</emphasis></para>
<para>This is the mailing list for the FreeBSD source code
audit project. Although this was originally intended for
security-related changes, its charter has been expanded to
review any code changes.</para>
<para>This list is very heavy on patches, and is probably of no
interest to the average FreeBSD user. Security discussions
not related to a particular code change are held on
freebsd-security. Conversely, all developers are encouraged
to send their patches here for review, especially if they
touch a part of the system where a bug may adversely affect
the integrity of the system.</para>
<!-- I can't actually find a charter for this, but there's this email: http://www.FreeBSD.org/cgi/getmsg.cgi?fetch=223347+225804+/usr/local/www/db/text/2000/cvs-all/20001210.cvs-all -->
</listitem>
</varlistentry>
<varlistentry>
<term>&a.binup.name;</term>
<listitem>
<para><emphasis>FreeBSD Binary Update Project</emphasis></para>
<para>This list exists to provide discussion for the binary
update system, or <application>binup</application>.
Design issues, implementation details,
patches, bug reports, status reports, feature requests, commit
logs, and all other things related to
<application>binup</application> are fair game.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.bluetooth.name;</term>
<listitem>
<para><emphasis>&bluetooth; in FreeBSD</emphasis></para>
<para>This is the forum where FreeBSD's &bluetooth; users
congregate. Design issues, implementation details,
patches, bug reports, status reports, feature requests,
and all matters related to &bluetooth; are fair
game.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.bugbusters.name;</term>
<listitem>
<para><emphasis>Coordination of the Problem Report handling effort</emphasis></para>
<para>The purpose of this list is to serve as a coordination and
discussion forum for the Bugmeister, his Bugbusters, and any other
parties who have a genuine interest in the PR database. This list
is not for discussions about specific bugs, patches or PRs.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.bugs.name;</term>
<listitem>
<para><emphasis>Bug reports</emphasis></para>
<para>This is the mailing list for reporting bugs in FreeBSD.
Whenever possible, bugs should be submitted using the
&man.send-pr.1;
command or the <ulink
url="&url.base;/send-pr.html">WEB
interface</ulink> to it.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.chat.name;</term>
<listitem>
<para><emphasis>Non technical items related to the FreeBSD
community</emphasis></para>
<para>This list contains the overflow from the other lists about
non-technical, social information. It includes discussion about
whether Jordan looks like a toon ferret or not, whether or not
to type in capitals, who is drinking too much coffee, where the
best beer is brewed, who is brewing beer in their basement, and
so on. Occasional announcements of important events (such as
upcoming parties, weddings, births, new jobs, etc) can be made
to the technical lists, but the follow ups should be directed to
this -chat list.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.core.name;</term>
<listitem>
<para><emphasis>FreeBSD core team</emphasis></para>
<para>This is an internal mailing list for use by the core
members. Messages can be sent to it when a serious
FreeBSD-related matter requires arbitration or high-level
scrutiny.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.current.name;</term>
<listitem>
<para><emphasis>Discussions about the use of
&os.current;</emphasis></para>
<para>This is the mailing list for users of &os.current;. It
includes warnings about new features coming out in -CURRENT that
will affect the users, and instructions on steps that must be
taken to remain -CURRENT. Anyone running <quote>CURRENT</quote>
must subscribe to this list. This is a technical mailing list
for which strictly technical content is expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.cvsweb.name;</term>
<listitem>
<para><emphasis>FreeBSD CVSweb Project</emphasis></para>
<para>Technical discussions about use, development and maintenance
of FreeBSD-CVSweb.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.doc.name;</term>
<listitem>
<para><emphasis>Documentation project</emphasis></para>
<para>This mailing list is for the discussion of issues and
projects related to the creation of documentation for FreeBSD.
The members of this mailing list are collectively referred to as
<quote>The FreeBSD Documentation Project</quote>. It is an open
list; feel free to join and contribute!</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.drivers.name;</term>
<listitem>
<para><emphasis>Writing device drivers for &os;</emphasis></para>
<para>This is a forum for technical discussions related to
device drivers on &os;. It is primarily a place
for device driver writers to ask questions about
how to write device drivers using the APIs in the
&os; kernel.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.eclipse.name;</term>
<listitem>
<para><emphasis>&os; users of Eclipse IDE, tools, rich
client applications and ports.</emphasis></para>
<para>The intention of this list is to provide mutual
support for everything to do with choosing, installing,
using, developing and maintaining the Eclipse IDE,
tools, rich client applications on the &os; platform and
assisting with the porting of Eclipse IDE and plugins to
the &os; environment.</para>
<para>The intention is also to facilitate exchange of
information between the Eclipse community and the &os;
community to the mutual benefit of both.</para>
<para>Although this list is focused primarily on the needs
of Eclipse users it will also provide a forum for those
who would like to develop &os; specific applications
using the Eclipse framework.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.embedded.name;</term>
<listitem>
<para><emphasis>Using FreeBSD in embedded
applications</emphasis></para>
<para>This list discusses topics related to using FreeBSD in
embedded systems. This is a technical mailing list for which
strictly technical content is expected. For the purpose of
this list we define embedded systems as those computing
devices which are not desktops and which usually serve a
single purpose as opposed to being general computing
environments. Examples include, but are not limited to,
all kinds of phone handsets, network equipment such as
routers, switches and PBXs, remote measuring equipment,
PDAs, Point Of Sale systems, and so on.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.emulation.name;</term>
<listitem>
<para><emphasis>Emulation of other systems such as
Linux/&ms-dos;/&windows;</emphasis></para>
<para>This is a forum for technical discussions related to
running programs written for other operating systems on &os;.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.firewire.name;</term>
<listitem>
<para><emphasis>&firewire; (iLink, IEEE 1394)</emphasis></para>
<para>This is a mailing list for discussion of the design
and implementation of a &firewire; (aka IEEE 1394 aka
iLink) subsystem for FreeBSD. Relevant topics
specifically include the standards, bus devices and
their protocols, adapter boards/cards/chips sets, and
the architecture and implementation of code for their
proper support.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.fs.name;</term>
<listitem>
<para><emphasis>File systems</emphasis></para>
<para>Discussions concerning FreeBSD file systems. This is a
technical mailing list for which strictly technical content is
expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.geom.name;</term>
<listitem>
<para><emphasis>GEOM</emphasis></para>
<para>Discussions specific to GEOM and related implementations.
This is a technical mailing list for which strictly technical
content is expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.gnome.name;</term>
<listitem>
<para><emphasis>GNOME</emphasis></para>
<para>Discussions concerning The <application>GNOME</application> Desktop Environment for
FreeBSD systems. This is a technical mailing list for
which strictly technical content is expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.ipfw.name;</term>
<listitem>
<para><emphasis>IP Firewall</emphasis></para>
<para>This is the forum for technical discussions concerning the
redesign of the IP firewall code in FreeBSD. This is a
technical mailing list for which strictly technical content is
expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.ia64.name;</term>
<listitem>
<para><emphasis>Porting FreeBSD to IA64</emphasis></para>
<para>This is a technical mailing list for individuals
actively working on porting FreeBSD to the IA-64 platform
from &intel;, to bring up problems or discuss alternative
solutions. Individuals interested in following the
technical discussion are also welcome.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.isdn.name;</term>
<listitem>
<para><emphasis>ISDN Communications</emphasis></para>
<para>This is the mailing list for people discussing the
development of ISDN support for FreeBSD.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.java.name;</term>
<listitem>
<para><emphasis>&java; Development</emphasis></para>
<para>This is the mailing list for people discussing the
development of significant &java; applications for FreeBSD and the
porting and maintenance of &jdk;s.</para>
</listitem>
</varlistentry>
<varlistentry id="eresources-charters-jobs">
<term>&a.jobs.name;</term>
<listitem>
<para><emphasis>Jobs offered and sought</emphasis></para>
<para>This is a forum for posting employment notices and
resumes specifically related to &os;, e.g. if you are
seeking &os;-related employment or have a job involving
&os; to advertise then this is the right place. This is
<emphasis>not</emphasis> a mailing list for general
employment issues since adequate forums for that
already exist elsewhere.</para>
<para>Note that this list, like other <hostid role="domainname">FreeBSD.org</hostid> mailing
lists, is distributed worldwide. Thus, you need to be
clear about location and the extent to which
telecommuting or assistance with relocation is
available.</para>
<para>Email should use open formats only &mdash;
preferably plain text, but basic Portable Document
Format (<acronym>PDF</acronym>), HTML, and a few others
are acceptable to many readers. Closed formats such as
&microsoft; Word (<filename>.doc</filename>) will be
rejected by the mailing list server.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.kde.name;</term>
<listitem>
<para><emphasis>KDE</emphasis></para>
<para>Discussions concerning <application>KDE</application> on
FreeBSD systems. This is a technical mailing list for
which strictly technical content is expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.hackers.name;</term>
<listitem>
<para><emphasis>Technical discussions</emphasis></para>
<para>This is a forum for technical discussions related to
FreeBSD. This is the primary technical mailing list. It is for
individuals actively working on FreeBSD, to bring up problems or
discuss alternative solutions. Individuals interested in
following the technical discussion are also welcome. This is a
technical mailing list for which strictly technical content is
expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.hardware.name;</term>
<listitem>
<para><emphasis>General discussion of FreeBSD
hardware</emphasis></para>
<para>General discussion about the types of hardware that FreeBSD
runs on, various problems and suggestions concerning what to buy
or avoid.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.hubs.name;</term>
<listitem>
<para><emphasis>Mirror sites</emphasis></para>
<para>Announcements and discussion for people who run FreeBSD
mirror sites.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.isp.name;</term>
<listitem>
<para><emphasis>Issues for Internet Service
Providers</emphasis></para>
<para>This mailing list is for discussing topics relevant to
Internet Service Providers (ISPs) using FreeBSD. This is a
technical mailing list for which strictly technical content is
expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.openoffice.name;</term>
<listitem>
<para><emphasis>OpenOffice.org</emphasis></para>
<para>Discussions concerning the porting and maintenance
of <application>OpenOffice.org</application> and
<application>&staroffice;</application>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.performance.name;</term>
<listitem>
<para><emphasis>Discussions about tuning or speeding up FreeBSD</emphasis></para>
<para>This mailing list exists to provide a place for
hackers, administrators, and/or concerned parties to
discuss performance related topics pertaining to
FreeBSD. Acceptable topics includes talking about
FreeBSD installations that are either under high load,
are experiencing performance problems, or are pushing
the limits of FreeBSD. Concerned parties that are
willing to work toward improving the performance of
FreeBSD are highly encouraged to subscribe to this list.
This is a highly technical list ideally suited for
experienced FreeBSD users, hackers, or administrators
interested in keeping FreeBSD fast, robust, and
scalable. This list is not a question-and-answer list
that replaces reading through documentation, but it is a
place to make contributions or inquire about unanswered
performance related topics.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.pf.name;</term>
<listitem>
<para><emphasis>Discussion and questions about the packet filter
firewall system</emphasis></para>
<para>Discussion concerning the packet filter (pf) firewall
system in terms of FreeBSD. Technical discussion and user
questions are both welcome. This list is also a place to
discuss the ALTQ QoS framework.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.platforms.name;</term>
<listitem>
<para><emphasis>Porting to Non &intel; platforms</emphasis></para>
<para>Cross-platform FreeBSD issues, general discussion and
proposals for non &intel; FreeBSD ports. This is a technical
mailing list for which strictly technical content is
expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.policy.name;</term>
<listitem>
<para><emphasis>Core team policy decisions</emphasis></para>
<para>This is a low volume, read-only mailing list for FreeBSD
Core Team Policy decisions.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.ports.name;</term>
<listitem>
<para><emphasis>Discussion of
<quote>ports</quote></emphasis></para>
<para>Discussions concerning FreeBSD's <quote>ports
collection</quote> (<filename>/usr/ports</filename>), ports infrastructure, and
general ports coordination efforts. This is a technical mailing list
for which strictly technical content is expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.ports-bugs.name;</term>
<listitem>
<para><emphasis>Discussion of
<quote>ports</quote> bugs</emphasis></para>
<para>Discussions concerning problem reports for FreeBSD's <quote>ports
collection</quote> (<filename>/usr/ports</filename>), proposed
ports, or modifications to ports. This is a technical mailing list
for which strictly technical content is expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.proliant.name;</term>
<listitem>
<para><emphasis>Technical discussion of FreeBSD on HP
ProLiant server platforms</emphasis></para>
<para>This mailing list is to be used for the technical
discussion of the usage of FreeBSD on HP ProLiant servers,
including the discussion of ProLiant-specific drivers,
management software, configuration tools, and BIOS
updates. As such, this is the primary place to discuss
the hpasmd, hpasmcli, and hpacucli modules.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.python.name;</term>
<listitem>
<para><emphasis>Python on FreeBSD</emphasis></para>
<para>This is a list for discussions related to improving Python-support
on FreeBSD. This is a technical mailing list. It is for individuals
working on porting Python, its 3rd party modules and <application>Zope</application> stuff to
FreeBSD. Individuals interested in following the technical discussion
are also welcome.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.questions.name;</term>
<listitem>
<para><emphasis>User questions</emphasis></para>
<para>This is the mailing list for questions about FreeBSD. You
should not send <quote>how to</quote> questions to the technical
lists unless you consider the question to be pretty
technical.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.scsi.name;</term>
<listitem>
<para><emphasis>SCSI subsystem</emphasis></para>
<para>This is the mailing list for people working on the SCSI
subsystem for FreeBSD. This is a technical mailing list for
which strictly technical content is expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.security.name;</term>
<listitem>
<para><emphasis>Security issues</emphasis></para>
<para>FreeBSD computer security issues (DES, Kerberos, known
security holes and fixes, etc). This is a technical mailing
list for which strictly technical discussion is expected. Note
that this is not a question-and-answer list, but that
contributions (BOTH question AND answer) to the FAQ are
welcome.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.security-notifications.name;</term>
<listitem>
<para><emphasis>Security Notifications</emphasis></para>
<para>Notifications of FreeBSD security problems and
fixes. This is not a discussion list. The discussion
list is FreeBSD-security.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.small.name;</term>
<listitem>
<para><emphasis>Using FreeBSD in embedded
applications</emphasis></para>
<para>This list discusses topics related to unusually small and
embedded FreeBSD installations. This is a technical mailing
list for which strictly technical content is expected.</para>
<note>
<para>This list has been obsoleted by &a.embedded.name;.</para>
</note>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.stable.name;</term>
<listitem>
<para><emphasis>Discussions about the use of
&os.stable;</emphasis></para>
<para>This is the mailing list for users of &os.stable;. It
includes warnings about new features coming out in -STABLE that
will affect the users, and instructions on steps that must be
taken to remain -STABLE. Anyone running <quote>STABLE</quote>
should subscribe to this list. This is a technical mailing list
for which strictly technical content is expected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.standards.name;</term>
<listitem>
<para><emphasis>C99 &amp; POSIX Conformance</emphasis></para>
<para>This is a forum for technical discussions related to
FreeBSD Conformance to the C99 and the POSIX standards.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.usb.name;</term>
<listitem>
<para><emphasis>Discussing &os; support for
USB</emphasis></para>
<para>This is a mailing list for technical discussions
related to &os; support for USB.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.usergroups.name;</term>
<listitem>
<para><emphasis>User Group Coordination List</emphasis></para>
<para>This is the mailing list for the coordinators from each of
the local area Users Groups to discuss matters with each other
and a designated individual from the Core Team. This mail list
should be limited to meeting synopsis and coordination of
projects that span User Groups.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>&a.vendors.name;</term>
<listitem>
<para><emphasis>Vendors</emphasis></para>
<para>Coordination discussions between The FreeBSD Project and
Vendors of software and hardware for FreeBSD.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="eresources-mailfiltering">
<title>Filtering on the Mailing Lists</title>
<para>The &os; mailing lists are filtered in multiple ways to
avoid the distribution of spam, viruses, and other unwanted emails.
The filtering actions described in this section do not include all
those used to protect the mailing lists.</para>
<para>Only certain types of attachments are allowed on the
mailing lists. All attachments with a MIME content type not
found in the list below will be stripped before an email is
distributed on the mailing lists.</para>
<itemizedlist>
<listitem>
<para>application/octet-stream</para>
</listitem>
<listitem>
<para>application/pdf</para>
</listitem>
<listitem>
<para>application/pgp-signature</para>
</listitem>
<listitem>
<para>application/x-pkcs7-signature</para>
</listitem>
<listitem>
<para>message/rfc822</para>
</listitem>
<listitem>
<para>multipart/alternative</para>
</listitem>
<listitem>
<para>multipart/related</para>
</listitem>
<listitem>
<para>multipart/signed</para>
</listitem>
<listitem>
<para>text/html</para>
</listitem>
<listitem>
<para>text/plain</para>
</listitem>
<listitem>
<para>text/x-diff</para>
</listitem>
<listitem>
<para>text/x-patch</para>
</listitem>
</itemizedlist>
<note>
<para>Some of the mailing lists might allow attachments of
other MIME content types, but the above list should be
applicable for most of the mailing lists.</para>
</note>
<para>If an email contains both an HTML and a plain text version,
the HTML version will be removed. If an email contains only an
HTML version, it will be converted to plain text.</para>
</sect2>
</sect1>
<sect1 id="eresources-news">
<title>Usenet Newsgroups</title>
<para>In addition to two FreeBSD specific newsgroups, there are many
others in which FreeBSD is discussed or are otherwise relevant to
FreeBSD users. <ulink
url="http://minnie.tuhs.org/BSD-info/bsdnews_search.html">Keyword
searchable archives</ulink> are available for some of these newsgroups
from courtesy of Warren Toomey <email>wkt@cs.adfa.edu.au</email>.</para>
<sect2>
<title>BSD Specific Newsgroups</title>
<itemizedlist>
<listitem>
<para><ulink
url="news:comp.unix.bsd.freebsd.announce">comp.unix.bsd.freebsd.announce</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.unix.bsd.freebsd.misc">comp.unix.bsd.freebsd.misc</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:de.comp.os.unix.bsd">de.comp.os.unix.bsd</ulink> (German)</para>
</listitem>
<listitem>
<para><ulink
url="news:fr.comp.os.bsd">fr.comp.os.bsd</ulink> (French)</para>
</listitem>
<listitem>
<para><ulink
url="news:it.comp.os.freebsd">it.comp.os.freebsd</ulink> (Italian)</para>
</listitem>
<listitem>
<para><ulink
url="news:tw.bbs.comp.386bsd">tw.bbs.comp.386bsd</ulink> (Traditional Chinese)</para>
</listitem>
</itemizedlist>
</sect2>
<sect2>
<title>Other &unix; Newsgroups of Interest</title>
<itemizedlist>
<listitem>
<para><ulink url="news:comp.unix">comp.unix</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.unix.questions">comp.unix.questions</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.unix.admin">comp.unix.admin</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.unix.programmer">comp.unix.programmer</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.unix.shell">comp.unix.shell</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.unix.user-friendly">comp.unix.user-friendly</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.security.unix">comp.security.unix</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.sources.unix">comp.sources.unix</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.unix.advocacy">comp.unix.advocacy</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.unix.misc">comp.unix.misc</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.bugs.4bsd">comp.bugs.4bsd</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.bugs.4bsd.ucb-fixes">comp.bugs.4bsd.ucb-fixes</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.unix.bsd">comp.unix.bsd</ulink></para>
</listitem>
</itemizedlist>
</sect2>
<sect2>
<title>X Window System</title>
<itemizedlist>
<listitem>
<para><ulink
url="news:comp.windows.x.i386unix">comp.windows.x.i386unix</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.windows.x">comp.windows.x</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.windows.x.apps">comp.windows.x.apps</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.windows.x.announce">comp.windows.x.announce</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.windows.x.intrinsics">comp.windows.x.intrinsics</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.windows.x.motif">comp.windows.x.motif</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.windows.x.pex">comp.windows.x.pex</ulink></para>
</listitem>
<listitem>
<para><ulink
url="news:comp.emulators.ms-windows.wine">comp.emulators.ms-windows.wine</ulink></para>
</listitem>
</itemizedlist>
</sect2>
</sect1>
<sect1 id="eresources-web">
<title>World Wide Web Servers</title>
&chap.eresources.www.inc;
</sect1>
<sect1 id="eresources-email">
<title>Email Addresses</title>
<para>The following user groups provide FreeBSD related email addresses
for their members. The listed administrator reserves the right to
revoke the address if it is abused in any way.</para>
<informaltable frame="none" pgwide="1">
<tgroup cols="4">
<thead>
<row>
<entry>Domain</entry>
<entry>Facilities</entry>
<entry>User Group</entry>
<entry>Administrator</entry>
</row>
</thead>
<tbody>
<row>
<entry>ukug.uk.FreeBSD.org</entry>
<entry>Forwarding only</entry>
<entry><email>freebsd-users@uk.FreeBSD.org</email></entry>
<entry>Lee Johnston
<email>lee@uk.FreeBSD.org</email></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1>
<sect1 id="eresources-shell">
<title>Shell Accounts</title>
<para>The following user groups provide shell accounts for people who are
actively supporting the FreeBSD project. The listed administrator
reserves the right to cancel the account if it is abused in any
way.</para>
<informaltable frame="none" pgwide="1">
<tgroup cols="4">
<thead>
<row>
<entry>Host</entry>
<entry>Access</entry>
<entry>Facilities</entry>
<entry>Administrator</entry>
</row>
</thead>
<tbody>
<row>
<entry>dogma.freebsd-uk.eu.org</entry>
<entry>Telnet/FTP/SSH</entry>
<entry>Email, Web space, Anonymous FTP</entry>
<entry>Lee Johnston
<email>lee@uk.FreeBSD.org</email></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1>
</appendix>
<!--
Local Variables:
mode: sgml
sgml-declaration: "../appendix.decl"
sgml-indent-data: t
sgml-omittag: nil
sgml-always-quote-attributes: t
sgml-parent-document: ("../book.sgml" "part" "appendix")
End:
-->