1. Introduction

1.1. Acknowledgements and Thanks

This document is largely derived from the Usage Instructions document that was included with the ATM on Linux distribution up until version 0.79. That previous document was written by Werner Almesberger while he was at the Institute for computer Communications and Applications (ICA).

The section Running Two ATM NICs Back-to-Back was primarily written by Richard Jones .

1.2. Copyright

Copyright 2001 IBM Corporation

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, 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 http://www.gnu.org/copyleft/fdl.html.

A large portion of this document is derived from the Usage Instructions included with the ATM on Linux 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).

1.3. Mailing List

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 subscribe and unsubscribe to it at http://lists.sourceforge.net/lists/listinfo/linux-atm-general.

The mailing list is archived at http://www.geocrawler.com/lists/3/SourceForge/6487/0/.

1.4. CVS Access

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.

First, log in anonymously:

% cvs -d:pserver:anonymous@cvs.linux-atm.sourceforge.net.:/cvsroot/linux-atm login

Just hit return when prompted for a password. Then, checkout the repository:

% cvs -z6 -d:pserver:anonymous@cvs.linux-atm.sourceforge.net.:/cvsroot/linux-atm co -P linux-atm

You may also specify a branch to check out specifically:

% cvs -z6 -d:pserver:anonymous@cvs.linux-atm.sourceforge.net.:/cvsroot/linux-atm co -r V2_5_0 linux-atm

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

% cvs -z6 up -d

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)

After you have checked out the source tree, you will need to run the autotools script in the top level directory before you can configure, build, and install from that source tree:

# ./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'...

If you wish to create a tarred, gzipped distribution file or a RPM distribution file, run make dist or make rpm 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 src/extra/RPMS directory.

The CVS archive may also be browsed on the web at: http://cvs.linux-atm.sourceforge.net/cgi-bin/viewcvs.cgi/linux-atm/linux-atm/.

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": http://lists.sourceforge.net/lists/listinfo/linux-atm-commits.

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.