Whole document tree 2. InstallationIn order to install this package, you'll need
2.1. The Binary RPMsIf you do not wish to futz with extracting and building the source yourself, the ATM tools are also distributed in RPM format. The RPM can be installed as follows: 2.2. The Source TreeFirst, extract the ATM on Linux distribution: When extracted the distribution will create the linux-atm-x.x.x/ directory with several sub-directories. The following sub-directories are of note:
2.3. Kernel Configuration
After unpacking the kernel distribution, do the usual make config, make menuconfig, or make xconfig in the top-level of your Linux kernel source tree. First, enable
The burst settings of the ENI driver can be fine-tuned. This may be necessary if the default settings lead to buffer overruns in the PCI chipset. See the on-line help on "CONFIG_ATM_ENI_TUNE_BURST" for a detailed discussion of the implications of changing the burst settings. Note that the file drivers/atm/nicstar.h contains a few configurable settings for the IDT 77201 driver. Some drivers can also be used with certain compatible cards. The latest information about compatible cards can be found at ATM on Linux information page. Then build your kernel and reboot. 2.4. Driver MessagesIf you've configured the ENI155p-MF driver, you should see two lines like these (512kB for the -C version, 2048kB for the -S version.): If you've configured the ZN1221/ZN1225 driver, you will get something like:
Note that if you've configured only the ATM over TCP driver, there are no messages at startup, because ATM over TCP devices are created later using the atmtcp command. 2.5. Memory DebuggingIf you want to enable debugging for options for memory allocations, you need to install MPR before compiling the ATM tools. If you chose to download the binary RPM package, you can install MPR like so: If you chose to download the source, extract mpr-x.x.tar.gz like so: Then do:Detection of some general mis-use of malloc and free is automatically performed if the program was compiled with MPR present. Tracing of allocations is enabled by setting MPRPC and MPRFI. See doc/mpr.html or doc/mpr.ps in the MPR distribution for details. Only little run-time overhead is incurred if memory debugging is included, but those environment variables are not set. 2.6. ATM ToolsNow, as the final step, configure and build the ATM tools. Configuration is only necessary if your switch uses UNI 3.1 or 4.0, or if it has certain bugs. The configuration options selected by passing the appropriate options to the ./configure script in the linux-atm distribution.
The ATM tools are built with the following commands: Unless otherwise specified when invoking ./configure, make install will install executables in the directory /usr/local/bin and /usr/local/sbin, respectively. Configuration files (except for hosts.atm which is installed in /etc) are installed in /usr/local/etc. Libraries and header files are installed in /usr/local/lib and /usr/local/include, respectively. Man pages are installed in /usr/local/man.2.7. Extra PackagesSome programs are based on large packages that are already distributed outside of the ATM context. For some packages, patches are contained in the ATM on Linux distribution. They are contained in the src/extra directory of the ATM on Linux distribution. Currently, the following extra packages are available:
Note that text2atm automatically uses ANS if available, so ans only needs to be installed on systems providing name server functionality or if ATM-aware maintenance tools nslookup, etc.) are needed. A script hosts2ans.pl to convert a /etc/hosts.atm file to ANS zone files are provided in the src/extra/ANS/ directory. Its use is described at the beginning of the file. |