]> sjero.net Git - dccpping/blob - README
Add README, License, changelog, and copyright messages.
[dccpping] / README
1 dccpping is a ping-like utility using DCCP Request packets to elict a response
2 from another host. It is designed to determine whether a remote host is DCCP
3 aware and whether or not a middle box is blocking DCCP packets.
4
5 In order to build this program, please simply type "make" at the commandline.
6 I have not included a ./configure script with this program because this
7 program will only compile on linux anyway (we need the dccp header include file)
8 and it comprises only a few files. If you have problems, simply modify the
9 makefile as needed. Contact me, if major problems arise.
10
11
12 Usage is pretty simple:
13 dccpping: [-d] [-v] [-h] [-6|-4] [-c count] [-p port] [-i interval]
14           [-t ttl] [-S srcaddress] remote_host
15
16           -d   Debug. May be repeated for aditional verbosity
17           -v   Version information
18           -h   Help
19           -6   Force IPv6 mode
20           -4   Force IPv4 mode
21                   -c   Number of requests to make. The default is unlimited.
22                   -p   The DCCP port to send requests to. The default is 33434.
23                   -i   Interval between requests in seconds. The default is 1 second.
24                   -t   The TTL to set in the sent requests. The default is 64.
25                   -S   Source Address. The address to send packets from. Should
26                            only be needed if the autodetection fails.
27                            
28                   remote_host can be either an IP address (IPv4 or IPv6) or a hostname.
29                   
30 The default behavior is for dccpping to encode its PID into the source port
31 of the requests it sends. This behavior can be turned off by setting the
32 SRC_PORT_AS_PID_MULTIPLEX #define in dccpping.c to 0.
33
34 dccpping is free software: you can redistribute it and/or modify
35 it under the terms of the GNU General Public License as published by
36 the Free Software Foundation, either version 3 of the License, or
37 (at your option) any later version.
38
39 dccpping is distributed in the hope that it will be useful,
40 but WITHOUT ANY WARRANTY; without even the implied warranty of
41 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
42 GNU General Public License for more details.
43
44 You should have received a copy of the GNU General Public License
45 along with dccpping.  If not, see <http://www.gnu.org/licenses/>.
46
47
48 Copyright 2012
49 Samuel Jero
50 Masters Student
51 Computer Science
52 Internetworking Research Group
53 Ohio University
54 sj323707@ohio.edu