1SC_ALLY(1)                BSD General Commands Manual               SC_ALLY(1)
2

NAME

4     sc_ally — scamper driver to run Ally on a list of candidate aliases.
5

SYNOPSIS

7     sc_ally [-?D] [-i infile] [-o outfile] [-p port] [-U unix-socket]
8             [-f fudge] [-i probe-wait] [-q attempts] [-t logfile]
9             [-w waittime]
10

DESCRIPTION

12     The sc_ally utility provides the ability to connect to a running
13     scamper(1) instance and have a set of IPv4 address-pairs tested for
14     aliases using the Ally technique.  For each address pair in the file,
15     sc_ally establishes which probe methods (UDP, TCP-ack, ICMP-echo) solicit
16     an incrementing IP-ID value, and then uses the Ally technique on pairs
17     where a probe method is able to obtain an incrementing IP-ID for both
18     addresses.  The output is written to a warts file.  The options are as
19     follows:
20
21     -?      prints a list of command line options and a synopsis of each.
22
23     -D      causes sc_ally to detach and become a daemon.
24
25     -i infile
26             specifies the name of the input file which consists of a sequence
27             of IPv4 address-pairs, one pair per line.
28
29     -o outfile
30             specifies the name of the output file to be written.  The output
31             file will use the warts format.
32
33     -p port
34             specifies the port on the local host where scamper(1) is accept‐
35             ing control socket connections.
36
37     -U unix-socket
38             specifies the name of a unix domain socket where scamper(1) is
39             accepting control socket connections.
40
41     -f fudge
42             specifies the fudge factor to use when (1) inferring if IPIDs are
43             assigned from a counter, and (2) inferring if two addresses share
44             the same counter.
45
46     -i probe-wait
47             specifies the inter-probe gap for both ping and Ally measure‐
48             ments, in milliseconds.  The default is 1000ms (1 second); the
49             minimum is 200ms, and the maximum is 2000ms.
50
51     -q attempts
52             specifies the number of times to try Ally when one of the
53             addresses is unresponsive.
54
55     -t logfile
56             specifies the name of a file to log output from sc_ally generated
57             at run time.
58
59     -w waittime
60             specifies the minimum length of time, in seconds, to wait between
61             completing a measurement to a particular IP address and issuing
62             the next.
63

EXAMPLE

65     Given a set of IPv4-address pairs in a file named infile.txt:
66
67        192.0.2.1 192.0.32.10
68        192.0.2.2 192.0.31.8
69        192.0.2.3 192.0.30.64
70
71     and a scamper(1) daemon listening on port 31337, then these address-pairs
72     can be tested for aliases using
73
74     sc_ally -i infile.txt -o outfile.warts -p 31337
75

SEE ALSO

77     N. Spring, R. Mahajan, and D. Wetherall, Measuring ISP topologies with
78     Rocketfuel, Proc. ACM SIGCOMM 2002.  scamper(1), sc_wartsdump(1),
79     sc_warts2text(1)
80

AUTHORS

82     sc_ally is written by Matthew Luckie <mjl@luckie.org.nz>.
83
84BSD                              March 1, 2011                             BSD
Impressum