File: prips.1

package info (click to toggle)
prips 1.1.1-3%2Bdeb11u1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 220 kB
  • sloc: ansic: 391; sh: 361; makefile: 80
file content (133 lines) | stat: -rw-r--r-- 3,125 bytes parent folder | download | duplicates (6)
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
.\" Copyright (C) 2001-2003  Daniel Kelly
.\" Copyright (C) 2009, 2011, 2016  Peter Pentchev
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License along
.\" with this program; if not, write to the Free Software Foundation, Inc.,
.\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.Dd March 1, 2011
.Dt PRIPS 1
.Os
.Sh NAME
.Nm prips
.Nd print the IP addresses in a given range
.Sh SYNOPSIS
.Nm
.Op Fl c
.Op Fl d Ar delim
.Op Fl e Ar exclude
.Op Fl f Ar format
.Op Fl i Ar incr
.Ar start
.Ar end
.Nm
.Op Fl c
.Op Fl d Ar delim
.Op Fl e Ar exclude
.Op Fl f Ar format
.Op Fl i Ar incr
.Ar CIDR-block
.Nm
.Fl h
.Sh DESCRIPTION
The
.Nm
tool can be used to print all of the IP addresses in a given range.
It can enhance tools that only work on one host at a time, e.g.
.Xr whois 1 .
.Pp
The
.Nm
tool accepts the following command-line options:
.Bl -tag -width indent
.It Fl c
Print the range in CIDR notation.
.It Fl d Ar delim
Set the delimiter to the character with ASCII code
.Ar delim
where 0 <=
.Ar delim
<= 255.
.It Fl e Ar <x.x.x,x.x>
Exclude ranges from the output.
.It Fl f Ar format
Set the format of addresses (hex, dec, or dot).
.It Fl h
Show summary of options.
.It Fl i Ar incr
Set the increment to 'x'.
.El
.Sh ENVIRONMENT
The
.Nm
tool's operation is not influenced by any environment variables.
.Sh FILES
The
.Nm
tool's operation is not influenced by any files.
.Sh EXAMPLES
Display all the addresses in a reserved subnet:
.Pp
.Dl prips 192.168.32.0 192.168.32.255
.Pp
The same, using CIDR notation:
.Pp
.Dl prips 192.168.32.0/24
.Pp
Display only the usable addresses in a class A reserved subnet using
a space instead of a newline for a delimiter:
.Pp
.Dl prips -d 32 10.0.0.1 10.255.255.255
.Pp
Display every fourth address in a weird block:
.Pp
.Dl prips -i 4 192.168.32.7 192.168.33.5
.Pp
Determine the smallest CIDR block containing two addresses:
.Pp
.Dl prips -c 192.168.32.5 192.168.32.11
.Pp
.Sh DIAGNOSTICS
.Ex -std
.Sh SEE ALSO
.Xr ipsc 1 ,
.Xr gipsc 1
.Sh STANDARDS
No standards were harmed in the writing of the
.Nm
tool.
.Sh HISTORY
The
.Nm
tool was originally written by
.An Daniel Kelly
and later adopted by
.An Peter Pentchev .
This manual page was originally written by
.An Juan Alvarez
for the Debian GNU/Linux system and later added to the
.Nm
distribution and converted to mdoc format by
.An Peter Pentchev .
.Sh AUTHORS
.An Daniel Kelly
.Aq dan@vertekcorp.com
.An Juan Alvarez
.Aq jalvarez@fluidsignal.com
.An Peter Pentchev
.Aq roam@ringlet.net
.Sh BUGS
Please report any bugs in the
.Nm
tool to its current maintainer,
.An Peter Pentchev .