NAME¶
sc_attach
—
simple scamper driver.
SYNOPSIS¶
sc_attach |
[ -?dDv ]
[-c command ]
[-i infile ]
[-o outfile ]
[-p port ]
[-P priority ] |
DESCRIPTION¶
The
sc_attach
utility provides the ability to
connect to a running
scamper(1) instance, have a
set of commands defined in a file be executed, and the output be written into
a single file, in warts format. The options are as follows:
-
?
- prints a list of command line options and a synopsis of each.
-d
- prints each command sent to scamper(1) on
stderr.
-D
- causes
sc_attach
to operate as a
daemon.
-v
- prints the current revision of
sc_attach
and exits.
-c
command
- specifies the scamper(1) command to prepend
to each address in the input file.
-i
infile
- specifies the name of the input file which consists of a sequence of
scamper(1) commands or addresses (with the -c
option), one per line. If '-' is specified, commands are read from
stdin.
-o
outfile
- specifies the name of the output file to be written. The output file will
use the warts format. If '-' is specified, output will be sent to
stdout.
-p
port
- specifies the port on the local host where
scamper(1) is accepting control socket
connections.
-P
priority
- specifies the mixing priority scamper(1)
should assign to the source.
EXAMPLES¶
Given a set of commands in a file named infile.txt:
tbit -M 1280 -u '
http://www.example.com/' 2620:0:2d0:200::10 trace -P udp-paris
-M 192.0.2.1 ping -P icmp-echo 192.0.32.10
and a
scamper(1) daemon listening on port 31337,
then these commands can be executed using:
sc_attach -i infile.txt -o outfile.warts -p 31337
Given a set of addresses in a file named infile2.txt:
2620:0:2d0:200::10 192.0.2.1 192.0.32.10
these addresses can be pinged with
sc_attach
operating as a daemon with:
sc_attach -D -c 'ping' -i infile2.txt -o outfile2.warts -p 31337
SEE ALSO¶
scamper(1),
sc_wartsdump(1),
sc_warts2text(1)
AUTHORS¶
sc_attach
is written by Matthew Luckie
<mjl@luckie.org.nz>.