mirror of
https://framagit.org/bortzmeyer/echoping
synced 2024-11-10 19:10:34 +00:00
110 lines
4.7 KiB
Plaintext
110 lines
4.7 KiB
Plaintext
echoping appears to compile and run at least on Linux, FreeBSD,
|
|
NetBSD, MacOS X, Solaris (gcc only) and Tru64. On Mac OS X, you'll
|
|
probably need a version >= 10.2. Some versions of RedHat 7 ship with a
|
|
completely broken C compiler (echoping displays negative times).
|
|
|
|
You do not have to be root to install it.
|
|
|
|
Just type "./configure", then "make", "make test" if you wish (some
|
|
tests depend on local servers and/or Internet access, interpret with
|
|
care) and then (as root if necessary), "make install". Since
|
|
echoping's configure script is quite slow, it is highly recommended to
|
|
use --config-cache or to have a config.site where it is the default
|
|
(see autoconf documentation).
|
|
|
|
There is also a 'make fulltest' if you want to test more things (which
|
|
may not be available on your platform).
|
|
|
|
"configure" has some options:
|
|
--disable-http (suppress the HTTP support)
|
|
--disable-smtp (suppress the SMTP support)
|
|
--enable-icp (add the ICP support, to monitor Web proxies like Squid)
|
|
--without-libidn (suppress the IDN support, the handling of Unicode - multi-script - domain names, see RFC 3490)
|
|
--with-libidn[=/where/is/libidn] (tell the system where to find the GNU libidn library <http://www.josefsson.org/libidn/>)
|
|
--with-gnutls[=/where/is/gnutls] (add the SSL/TLS support, you will need
|
|
the GNU TLS library <http://www.gnutls.org/>)
|
|
--with-ssl[=/where/is/ssl] (add the SSL/TLS support, you will need
|
|
the OpenSSL library <http://www.openssl.org/>)
|
|
--disable-ttcp (suppress the T/TCP support which is enabled only if
|
|
your system supports it - FreeBSD does. See
|
|
<http://www.kohala.com/start/ttcp.html>)
|
|
--enable-max-iterations=MAX (limit the number of iterations (-n option for
|
|
repeated tests) to MAX)
|
|
--enable-max-request-size=MAX (limit the size of the request (-s option) to MAX)
|
|
--enable-plugin=LIST (list of plugins to build)
|
|
|
|
There is no option to disable IPv6. echoping now uses the new (RFC
|
|
3493, but first specified in RFC 2133 in september 1997) socket
|
|
interface, with getnameinfo/getaddrinfo. If your system does not
|
|
support it (Mac OS X <= 10.1), you have no other choices than using
|
|
echoping 4.
|
|
|
|
There is no option to disable the use of dlopen() or the popt
|
|
library. dlopen() is necessary for the plugins (and, in the future,
|
|
all protocol code will be in plugins). The popt library provides a
|
|
better and easier parsing of options and, more important, is necessary
|
|
for resuming parsing, something that the plugins rely heavily on. If
|
|
your system does not support dlopen() or if you do not want to install
|
|
the popt library (which is free and runs on every Unix), you have no
|
|
other choices than using echoping 5. popt can be retrieved from, for
|
|
instance, ftp://ftp.rpm.org/pub/rpm/dist/rpm-4.1.x/popt-1.7.tar.gz or
|
|
ask Freshmeat at http://freshmeat.net/projects/popt/.
|
|
|
|
Standard "autoconf/configure" options are supported such as --prefix
|
|
to set the installation root directory.
|
|
|
|
If 'echoping -h' replies with a "404" error while the file really exists,
|
|
check first that you use the FQDN of the server on the command line
|
|
(this is a consequence of the HTTP 1.1 protocol, not a bug in echoping
|
|
and this will show only if the HTTP server uses "virtual hosting").
|
|
|
|
The SSL support (with OpenSSL *or* GNU TLS) is not established by
|
|
default, mostly because cryptography software's status is still
|
|
unclear in some countries. You have to use --with-ssl (which should be
|
|
--with--openssl, I know, there are two libraries, with incompatible
|
|
APIs) or --with-gnutls
|
|
|
|
************* Bug reports ***********************
|
|
|
|
To report a bug, email Stephane Bortzmeyer
|
|
<bortz@users.sourceforge.net> (if you have an account at SourceForge,
|
|
you can use their bug reporting tool, too, at
|
|
http://sourceforge.net/tracker/?group_id=4581&atid=104581).
|
|
|
|
If the problem is at the "./configure" step, do not forget to send
|
|
configure's output *and* the config.log.
|
|
|
|
If the problem is at run-time, please send the output of "echoping -V"
|
|
(capital V).
|
|
|
|
If echoping segfaults, please send me debugging info. To do so:
|
|
make clean
|
|
make debug
|
|
gdb ./echoping
|
|
run the-options-that-exhibits-the-problem
|
|
where
|
|
list
|
|
print the-variables-displayed
|
|
|
|
********** System-specific notes **************
|
|
|
|
HP-UX: echoping probably cannot run because it depends on a feature
|
|
called "back-linking" (the main program must be able to export its
|
|
symbols to the plugins, and not only the other way around). HP-UX is
|
|
apparently the only Unix without it (see libtool documentation). No
|
|
solution yet.
|
|
|
|
FreeBSD: popt is a port, so "pkg_add -r popt" will work (or
|
|
"portinstall popt").
|
|
|
|
NetBSD: popt is a port, so "pkg_add popt" will work.
|
|
|
|
Debian: echoping is a Debian package so you typically do not need to
|
|
compile it. If you want to do it, do not forget to install the
|
|
development versions of the libraries ("apt-get install libpopt-dev").
|
|
|
|
$Id$
|
|
|
|
|
|
|