inet6 Applications, Release 0.36
================================

Introduction
============

  This is a kit of IPv6-aware applications designed to replace many of the
basic networking programs that come with your system. Most of these support
IPv4, IPv6, and UNIX domain sockets. All of the software here is copyrighted
but free. See doc/README.Copyrights for more details.

  The current version of this kit is intended for recent versions of Linux
with Linux IPv6 and NRL IPsec and for recent versions of BSD with NRL IPv6 and
IPsec. It should run on other systems that implement the IPv6 basic and
advanced APIs as interpreted and implemented in the Linux and NRL code bases.
Parts of this kit are unlikely to work on systems that don't implement this
API.

  This kit contains applications that can use IPv6 and/or IPsec but does not
implement either. If you don't already have IPv6 and/or IPsec support in your
system, this kit will not do you any good.

Contents
========

  This kit contains:

  finger				finger client
  fingerd				finger server
  ftp					ftp client
  ftpd					ftp server
  inetd					Internet super-server daemon
  lib					IPv6+IPsec support library
  man					general info in man page form
  misc/gendata				very simple test pattern generator
  misc/socktest				socket client/server
  ping					echo diagnostic
  tftp					tftp client

  You will also need netstat, route, and ifconfig for your system. Linux users
should obtain these from the latest net-tools package. BSD users should obtain
these from the latest NRL IPv6+IPsec software distribution.

Home
====

  The home FTP site for this software is:

  Via IPv6: ftp.ipv6.inner.net:/pub/ipv6
  Via IPv4: ftp.inner.net:/pub/ipv6

  Note that software appears first on the IPv6 FTP server; if you can, check
there. If you did not get this kit from one of these sites, it may be old.
Please make sure that you have the latest version before trying to use this
kit.

Building from source
====================

  This kit REQUIRES:

  * GNU make (for things like makefile if/then and inclusion)
  * GNU C (GCC) version 2 or some derivative (for include_next)
  * (For Linux) GNU libc 2.1. Other versions WILL NOT WORK.

  It might be possible to port this kit to systems that lack these things. It
is almost definitely better to just install these tools and be happy.

  Edit the file 'GNUmakefile.config' and make any adjustments you need to,
then run 'make'. Hopefully, it will build and install without any problems.

If you have problems
====================

  Do you have the latest version of this kit? If not, try that first.

  The official distribution sites are:

  Via IPv6:  ftp.ipv6.inner.net        Via IPv4:  ftp.inner.net

  The official mirror site is:

  Via IPv4:  wrath.wcug.wwu.edu:/pub/ipv6/mirrors/ftp.inner.net

  If you obtained this kit from anywhere else, you got it from an unauthorized
mirror.

  If you are using Linux, send problem reports to the linux-ipv6 mailing list.
You can subscribe to this list by sending a message reading "subscribe" to
<linux-ipv6-request@inner.net>.

  If you are using the NRL IPv6+IPsec distribution, send problem reports to
the (NRL) ipv6-users mailing list. You can subscribe to this list by sending a
message reading "subscribe" to <ipv6-users-request@itd.nrl.navy.mil>.

  If you are using some other system, you are on your own.

  Generally speaking, the following information will be needed to figure out
how to solve your problem:

  * What OS, distribution, and version you are using
  * What version of this kit you are using
  * (Linux) What version of the C runtime library you are using

  If you don't provide this information, don't be surprised if you get
responses that are questions rather than answers.

More documentation!
===================

  See the doc directory and the program subdirectories for more documentation
on this kit and its components.
