Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SC_ATTACH(1)		FreeBSD	General	Commands Manual		  SC_ATTACH(1)

NAME
     sc_attach -- simple scamper driver.

SYNOPSIS
     sc_attach [-?dDv] [-c command] [-i	infile]	[-o outfile] [-O options]
	       [-p [ip:]port] [-P priority] [-R	unix-domain] [-U unix-domain]

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 exe-
     cuted, 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.

     -O	options
	     allows the	behavior of sc_attach to be further tailored.  The
	     current choices for this option are:
	       -  random: shuffle the input commands randomly.
	       -  impatient: send commands to scamper without waiting for
		  scamper to ask for them.

     -p	[ip:]port
	     specifies the IP address and port where a scamper(1) is accepting
	     control socket connections.  If an	IP address is not specified,
	     sc_attach connects	to the specified port on the local host.

     -P	priority
	     specifies the mixing priority scamper(1) should assign to the
	     source.

     -R	unix-domain
	     specifies the unix	domain socket on the local host	where a	remote
	     scamper(1)	instance is accepting commands.

     -U	unix-domain
	     specifies the unix	domain socket on the local host	where a	local
	     scamper(1)	isntance is accepting commands.

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_warts2json(1)

AUTHORS
     sc_attach was written by Matthew Luckie <mjl@luckie.org.nz>.

FreeBSD	13.0		       February	2, 2016			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=sc_attach&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help