← Back to branch summary

~ubuntu-branches/debian/stretch/arping/stretch

« back to all changes in this revision

Viewing changes to arping.8

  • Committer: Bazaar Package Importer
  • Author(s): Lenart Janos
  • Date: 2004-03-13 22:50:04 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20040313225004-49izij6cwiuhas35
Tags: 2.01-3
http://bugs.debian.org/234481
http://bugs.debian.org/230342
* Setgid removed (on control-directory).           (closes: Bug#234481)
* Bashism fixed.                                   (closes: Bug#230342)

Show diffs side-by-side

added added

removed removed

Lines of Context:
arping.8
1
 
.TH "arping" "8" "12th Feb, 2002" "arping" "" 
 
1
.TH "arping" "8" "21th June, 2003" "arping" "" 
2
2
.PP 
3
3
.SH "NAME" 
4
4
arping \- sends arp and/or ip pings to a given host
11
11
.PP 
12
12
One request is sent each second\&.
13
13
.PP 
 
14
When pinging an IP an ARP who-has query is sent\&. When pinging a MAC
 
15
address a directed broadcast ICMP Echo request is sent\&. For more
 
16
technical explaination and an FAQ, see the README file\&.
 
17
.PP 
14
18
\fIImportant note on timing\fP
15
19
.PP 
16
20
ARP packets are usually replied to (on a LAN) so fast that the OS task
30
34
.SH "OPTIONS" 
31
35
.PP 
32
36
.IP 
 
37
.IP "-0" 
 
38
Use this option to ping with source IP address 0\&.0\&.0\&.0\&. Use this
 
39
when you haven\&'t configured your interface yet\&.
 
40
Note that this may get the MAC-ping unanswered\&.
 
41
This is an alias for -S 0\&.0\&.0\&.0\&.
 
42
.IP "-a" 
 
43
Audiable ping\&.
 
44
.IP "-A" 
 
45
Only count addresses matching requested address (This *WILL*
 
46
break most things you do\&. Only useful if you are arpinging many
 
47
hosts at once\&. See arping-scan-net\&.sh for an example)\&.
 
48
.IP "-b" 
 
49
Like -0 but source broadcast source address (255\&.255\&.255\&.255)\&.
 
50
Note that this may get the arping unanswered since it\&'s not normal behavior
 
51
for a host\&.
 
52
.IP "-B" 
 
53
Use instead of host if you want to address 255\&.255\&.255\&.255\&.
 
54
.IP "-c \fIcount\fP" 
 
55
Only send \fIcount\fP requests\&.
 
56
.IP "-d" 
 
57
Find duplicate replies\&.
 
58
.IP "-F" 
 
59
Don\&'t try to be smart about the interface name\&. (even if this
 
60
switch is not given, -i overrides smartness\&.
33
61
.IP "-h" 
34
62
Displays a help message and exits\&.
 
63
.IP "-i \fIinterface\fP" 
 
64
Use the specified interface\&.
35
65
.IP "-q" 
36
66
Does not display messages, except error messages\&.
37
 
.IP "-a" 
38
 
Audiable ping\&.
39
 
.IP "-v" 
40
 
Verbose output\&. Use twice for more messages\&.
41
67
.IP "-r" 
42
68
Raw output: only the MAC/IP address is displayed for each reply\&.
43
69
.IP "-R" 
44
70
Raw output: Like -r but shows "the other one", can be combined with
45
71
-r\&.
46
 
.IP "-d" 
47
 
Find duplicate replies\&.
48
 
.IP "-B" 
49
 
Use instead of host if you want to address 255\&.255\&.255\&.255\&.
50
 
.IP "-0" 
51
 
Use this option to ping with source IP address 0\&.0\&.0\&.0\&. Use this
52
 
when you haven\&'t configured your interface yet\&.
53
 
Note that this may get the MAC-ping unanswered\&.
54
 
This is an alias for -S 0\&.0\&.0\&.0\&.
55
 
.IP "-b" 
56
 
Like -0 but source broadcast source address (255\&.255\&.255\&.255)\&.
57
 
Note that this may get the arping unanswered since it\&'s not normal behavior
58
 
for a host\&.
 
72
.IP "-s \fIMAC\fP" 
 
73
Set source MAC address\&. You may need to use -p with this\&.
59
74
.IP "-S \fIIP\fP" 
60
75
Like -b and -0 but with set source address\&.
61
76
Note that this may get the arping unanswered if the target does not have
62
77
routing to the IP\&. If you don\&'t own the IP you are using, you may need to turn
63
78
on promiscious mode on the interface (with -p)\&. With this switch you can find
64
79
out what IP-address a host has without taking an IP-address yourself\&.
 
80
.IP "-t \fIMAC\fP" 
 
81
Set target MAC address to use when pinging IP address\&.
65
82
.IP "-T \fIIP\fP" 
66
83
Use -T as target address when pinging MACs that won\&'t
67
84
respond to a broadcast ping but perhaps to a directed broadcast\&.
72
89
.IP "-p" 
73
90
Turn on promiscious mode on interface, use this if you don\&'t
74
91
"own" the MAC address you are using\&.
75
 
.IP "-s \fIMAC\fP" 
76
 
Set source MAC address\&. You may need to use -p with this\&.
77
 
.IP "-t \fIMAC\fP" 
78
 
Set target MAC address to use when pinging IP address\&.
79
 
.IP "-c \fIcount\fP" 
80
 
Only send \fIcount\fP requests\&.
81
 
.IP "-i \fIinterface\fP" 
82
 
Use the specified interface\&.
 
92
.IP "-v" 
 
93
Verbose output\&. Use twice for more messages\&.
 
94
.IP "-w" 
 
95
(arping 2\&.x only) Time to wait between pings, in microseconds\&.
83
96
.PP 
84
97
.SH "BUGS" 
85
98
.PP 
92
105
.PP 
93
106
.SH "AUTHOR" 
94
107
.PP 
95
 
Arping was written by Thomas Habets <thomas@habets\&.pp\&.se> aka
96
 
<marvin@rootbusters\&.net>
 
108
Arping was written by Thomas Habets <thomas@habets\&.pp\&.se>\&.