1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
.\"
.\" sc_attach.1
.\"
.\" Author: Matthew Luckie <mjl@luckie.org.nz>
.\"
.\" Copyright (c) 2010 University of Waikato
.\" 2012 The Regents of the University of California
.\" All rights reserved
.\"
.\" $Id: sc_attach.1,v 1.6 2013/09/04 19:26:23 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 ?dDv
.Op Fl c Ar command
.Op Fl i Ar infile
.Op Fl o Ar outfile
.Op Fl p Ar port
.Op Fl P Ar priority
.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 d
prints each command sent to
.Xr scamper 1
on stderr.
.It Fl D
causes
.Nm
to operate as a daemon.
.It Fl v
prints the current revision of
.Nm
and exits.
.It Fl c Ar command
specifies the
.Xr scamper 1
command to prepend to each address in the input file.
.It Fl i Ar infile
specifies the name of the input file which consists of a sequence
of
.Xr scamper 1
commands or addresses (with the -c option), 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 P Ar priority
specifies the mixing priority
.Xr scamper 1
should assign to the source.
.El
.Sh EXAMPLES
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
.Pp
Given a set of addresses in a file named infile2.txt:
.Pp
.in +.3i
.nf
2620:0:2d0:200::10
192.0.2.1
192.0.32.10
.fi
.in -.3i
.Pp
these addresses can be pinged with
.Nm
operating as a daemon with:
.Pp
sc_attach -D -c 'ping' -i infile2.txt -o outfile2.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>.
|
