old-www/HOWTO/ATM-Linux-HOWTO/introduction.html

459 lines
8.0 KiB
HTML

<HTML
><HEAD
><TITLE
>Introduction</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.63
"><LINK
REL="HOME"
TITLE="ATM on Linux HOWTO"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="ATM on Linux HOWTO"
HREF="index.html"><LINK
REL="NEXT"
TITLE="Installation"
HREF="installation.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>ATM on Linux HOWTO</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="index.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="installation.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="INTRODUCTION"
>1. Introduction</A
></H1
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="INTRODUCTION.ACKNOWLEDGEMENTS"
>1.1. Acknowledgements and Thanks</A
></H2
><P
>This document is largely derived from the
<I
CLASS="CITETITLE"
>Usage Instructions</I
> document that was included with the
<EM
>ATM on Linux</EM
> distribution up until version 0.79. That
previous document was written by Werner Almesberger
<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:wa@almsesberger.net"
>wa@almsesberger.net</A
>&#62;</TT
> while he was at the
<A
HREF="http://icawww.epfl.ch/"
TARGET="_top"
>Institute for computer Communications and Applications (ICA)</A
>.</P
><P
>The section
<A
HREF="signaling.html#SIGNALING.RUNNING-TWO-ATM-NICS-BACK-TO-BACK"
><I
>Running Two ATM NICs Back-to-Back</I
></A
>
was primarily written by Richard Jones <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:rjones@imcl.com"
>rjones@imcl.com</A
>&#62;</TT
>.</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="INTRODUCTION.COPYRIGHT"
>1.2. Copyright</A
></H2
><P
>Copyright 2001 IBM Corporation</P
><P
>Permission is granted to copy, distribute and/or modify this document under the
terms of the
<A
HREF="http://www.gnu.org/copyleft/fdl.html"
TARGET="_top"
>GNU Free Documentation License</A
>, Version 1.1 or any later
version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts.
A copy of the license can be found at
<A
HREF="http://www.gnu.org/copyleft/fdl.html"
TARGET="_top"
>http://www.gnu.org/copyleft/fdl.html</A
>.</P
><P
>A large portion of this document is derived from the
<I
CLASS="CITETITLE"
>Usage Instructions</I
> included with the
<EM
>ATM on Linux</EM
> distribution up to version 0.79
which was released under the
BSD License, GNU General Public License (GPL), and GNU Lesser General
Public License (LGPL).</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="INTRODUCTION.MAILING-LIST"
>1.3. Mailing List</A
></H2
><P
>There is also a mailing list on which to discuss ATM on Linux. If you have any
comments, questions, suggestions, or would just like to get involved, please
join the list. You can <EM
>subscribe</EM
> and
<EM
>unsubscribe</EM
> to it at
<A
HREF="http://lists.sourceforge.net/lists/listinfo/linux-atm-general"
TARGET="_top"
>http://lists.sourceforge.net/lists/listinfo/linux-atm-general</A
>.</P
><P
>The mailing list is archived at
<A
HREF="http://www.geocrawler.com/lists/3/SourceForge/6487/0/"
TARGET="_top"
>http://www.geocrawler.com/lists/3/SourceForge/6487/0/</A
>. </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="INTRODUCTION.CVS-ACCESS"
>1.4. CVS Access</A
></H2
><P
>Users are encouraged to continue to use the releases instead of automatically
assuming they should grab the latest version out of CVS. However,
if you like living on the edge, here is how to do it.</P
><P
>First, log in anonymously:
<DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN58"
></A
><P
></P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
>% cvs -d:pserver:anonymous@cvs.linux-atm.sourceforge.net.:/cvsroot/linux-atm login</PRE
></FONT
></TD
></TR
></TABLE
><P
></P
></DIV
>
Just hit return when prompted for a password. Then, checkout the repository:
<DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN60"
></A
><P
></P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
>% cvs -z6 -d:pserver:anonymous@cvs.linux-atm.sourceforge.net.:/cvsroot/linux-atm co -P linux-atm</PRE
></FONT
></TD
></TR
></TABLE
><P
></P
></DIV
>
You may also specify a branch to check out specifically:
<DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN62"
></A
><P
></P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
>% cvs -z6 -d:pserver:anonymous@cvs.linux-atm.sourceforge.net.:/cvsroot/linux-atm co -r V2_5_0 linux-atm</PRE
></FONT
></TD
></TR
></TABLE
><P
></P
></DIV
>
In either case, this will create a directory called "linux-atm" with the latest sources in it. When working inside this directory you will not need to
specify the '-d' option to CVS. For instance, you could just do
<DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN64"
></A
><P
></P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
>% cvs -z6 up -d</PRE
></FONT
></TD
></TR
></TABLE
><P
></P
></DIV
>
To grab any changes that have been put in the repository (the '-d' option in
the above example is to the "up" sub-command and is different than the
'-d' used to specify the CVS root directory) </P
><P
>After you have checked out the source tree, you will need to run the
<SPAN
CLASS="APPLICATION"
>autotools</SPAN
> script in the top level directory before
you can configure, build, and install from that source tree:
<DIV
CLASS="INFORMALEXAMPLE"
><A
NAME="AEN68"
></A
><P
></P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
># ./autotools
Running aclocal...
Running autoconf...
Running autoheader...
Running automake...
automake: configure.in: installing `./install-sh'
automake: configure.in: installing `./mkinstalldirs'
automake: configure.in: installing `./missing'
configure.in: 26: required file `./ltconfig' not found
automake: Makefile.am: installing `./INSTALL'
automake: configure.in: installing `src/lane/ylwrap'
Finished... Now run './configure' and 'make'...</PRE
></FONT
></TD
></TR
></TABLE
><P
></P
></DIV
>&#13;</P
><P
>&#13;If you wish to
create a tarred, gzipped distribution file or a RPM distribution file, run
<TT
CLASS="USERINPUT"
><B
>make dist</B
></TT
> or <TT
CLASS="USERINPUT"
><B
>make rpm</B
></TT
>
respectively. The tarred, gzipped file will be placed in the top level of
the source tree and the RPM file will be placed in the
<TT
CLASS="FILENAME"
>src/extra/RPMS</TT
> directory.</P
><P
>The CVS archive may also be browsed on the web at:
<A
HREF="http://cvs.linux-atm.sourceforge.net/cgi-bin/viewcvs.cgi/linux-atm/linux-atm/"
TARGET="_top"
>http://cvs.linux-atm.sourceforge.net/cgi-bin/viewcvs.cgi/linux-atm/linux-atm/</A
>.</P
><P
>Finally, if you would like to receive email including every diff that is committed to the repository as they go in, there is a mailing list called
"linux-atm-commits":
<A
HREF="http://lists.sourceforge.net/lists/listinfo/linux-atm-commits"
TARGET="_top"
>http://lists.sourceforge.net/lists/listinfo/linux-atm-commits</A
>.</P
><P
>This mailing list should be treated as receive-only. NO discussion or questions are allowed (even of patches which are sent through that list). All
discussion should be kept on the linux-atm-general mailing list. </P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="index.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="installation.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>ATM on Linux HOWTO</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Installation</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>