.\"
.\" sc_attach.1
.\"
.\" Author: Matthew Luckie <mjl@luckie.org.nz>
.\"
.\" Copyright (c) 2010 University of Waikato
.\"                    All rights reserved
.\"
.\" $Id: sc_attach.1,v 1.2.10.1 2012/03/20 17:51:44 mjl Exp $
.\"
.\"  nroff -man sc_attach.1
.\"  groff -man -Tascii sc_attach.1 | man2html -title sc_attach.1
.\"
.Dd October 15, 2010
.Dt SC_ATTACH 1
.Os
.Sh NAME
.Nm sc_attach
.Nd simple scamper driver.
.Sh SYNOPSIS
.Nm
.Bk -words
.Op Fl ?v
.Op Fl i Ar infile
.Op Fl o Ar outfile
.Op Fl p Ar port
.Ek
.\""""""""""""
.Sh DESCRIPTION
The
.Nm
utility provides the ability to connect to a running
.Xr 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:
.Bl -tag -width Ds
.It Fl ?
prints a list of command line options and a synopsis of each.
.It Fl i Ar infile
specifies the name of the input file which consists of a sequence
of
.Xr scamper 1
commands, one per line.
If '-' is specified, commands are read from stdin.
.It Fl o Ar 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.
.It Fl p Ar port
specifies the port on the local host where
.Xr scamper 1
is accepting control socket connections.
.It Fl v
prints the current revision of
.Nm
and exits.
.El
.Sh EXAMPLE
Given a set of commands in a file named infile.txt:
.Pp
.in +.3i
.nf
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
.fi
.in -.3i
.Pp
and a
.Xr scamper 1
daemon listening on port 31337, then these commands can be executed using
.Pp
sc_attach -i infile.txt -o outfile.warts -p 31337
.Sh SEE ALSO
.Xr scamper 1 ,
.Xr sc_wartsdump 1 ,
.Xr sc_warts2text 1
.Sh AUTHORS
.Nm
is written by Matthew Luckie <mjl@luckie.org.nz>.