You are looking at historical revision 29186 of this page. It may differ significantly from its current revision.


eping is a Scheme implementation of the ICMP ping utility. Although it can be used like an average OS ping utility, eping is intended to be used programmatically (e.g. for gathering statistics, monitoring). It uses raw sockets thus a privileged account must be used.

[procedure] (eping HOST #!key (mode 'probe)
                              (count #f)
                              (timeout 1000)
                              (interval 1000)
                              (ttl 64)
                              (tos 0)
                              (dont-fragment #f)
                              (src-addr #f)
                              (id #f)
                              (seq-start 0)
                              (size 56)
                              (pattern "")
                              (recv-min #f)
                              (lost-max #f)
                              (cons-recv-min #f)
                              (cons-lost-max #f)
                              (msg1 "%i is alive%n")
                              (msg2 "")
                              (dotcols 0)
                              (quiet #t))

HOST can be either an IPv4 address or an hostname: ' , "" , ', "" are all valid hosts.

eping supports four modes of operation: probe (default), stats, dot and mtu.

Probe mode

In this mode eping returns true or false if it considers an host alive or unreachable respectively. The default behavior is to consider an host alive as soon as an echo reply is received. If no reply is received in count attempts, the host is considered unreachable. If not specified, count is 5 by default. Probe mode is the default one so it can be omitted as parameter.

(eping "")

===> #t