---
name: "sc_pinger"
section: "1"
platform: "linux"
package: "scamper"
version: "20211212-1.2+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/sc_pinger"
---

# sc\_pinger(1)

scamper driver to run ping with different probe methods on a list of addresses.

## NAME

**sc\_pinger** – scamper driver to run ping with different probe methods on a list of addresses.

## SYNOPSIS

**sc\_pinger** \[**-?D**\] \[**-a** *infile*\] \[**-o** *outfile*\] \[**-p** *port*\] \[**-U** *unix-socket*\] \[**-c** *probe-count*\] \[**-m** *method*\] \[**-t** *logfile*\]

## DESCRIPTION

The **sc\_pinger** utility provides the ability to connect to a running [scamper(1)](/scamper/1.md) instance and run ping on a set of IPv4 and IPv6 addresses. For each address in the file, **sc\_pinger** will try ICMP, UDP, and TCP-ack probe methods to solicit responses from the address. **sc\_pinger** will not try all methods if one method obtains responses. The output of **sc\_pinger** is written to a warts(5) file, which can then be processed to extract details of responses. The options are as follows:

- **-**?

  prints a list of command line options and a synopsis of each.

- **-D**

  causes **sc\_pinger** to detach and become a daemon.

- **-a** *infile*

  specifies the name of the input file which consists of a sequence of IPv4 and IPv6 addresses, one per line.

- **-o** *outfile*

  specifies the name of the output file to be written. The output file will use the warts(5) format.

- **-p** *port*

  specifies the port on the local host where [scamper(1)](/scamper/1.md) is accepting control socket connections.

- **-U** *unix-socket*

  specifies the name of a unix domain socket where [scamper(1)](/scamper/1.md) is accepting control socket connections.

- **-c** *probe-count*

  specifies the number of probes to send for each method. **sc\_pinger** accepts two formats: a single integer that specifies the number of probes (and responses) desired; or, two integers, separated by /, that specify the number of responses desired and maximum number of probes to send. By default, **sc\_pinger** seeks three responses from up to five probes.

- **-m** *method*

  specifies a single probe method to try. The available probe methods are the same as scamper's ping implementation, listed in [scamper(1)](/scamper/1.md) manual page. By default, **sc\_pinger** uses ICMP-echo, UDP-dport, and TCP-ack-sport to destination port 80.

- **-t** *logfile*

  specifies the name of a file to log output from **sc\_pinger** generated at run time.

## EXAMPLES

Given a set of IPv4 and IPv6 address sets in a file named infile.txt:

```
192.0.2.1
192.0.32.10
192.0.31.60
2001:db8::1
```

and a [scamper(1)](/scamper/1.md) daemon listening on port 31337, then these addresses can be probed using

```
sc_pinger -a infile.txt -o outfile.warts -p 31337
```

To send 4 probes, and stop after receiving two responses:

```
sc_pinger -a infile.txt -o outfile.warts -p 31337 -c 2/4
```

To use ICMP-echo and TCP-syn probes to destination port 443

```
sc_pinger -a infile.txt -o outfile.warts -p 31337 -m icmp-echo -m 'tcp-syn -d 443'
```

## SEE ALSO

[scamper(1)](/scamper/1.md), [sc\_wartsdump(1)](/sc_wartsdump/1.md), [sc\_warts2json(1)](/sc_warts2json/1.md), [sc\_warts2text(1)](/sc_warts2text/1.md)

## AUTHORS

**sc\_pinger** was written by Matthew Luckie \<mjl@luckie.org.nz\>.