Provided by: ipcalc-ng_1.0.1-3_amd64 
NAME
ipcalc-ng - Perform simple operations on IP addresses and networks
SYNOPSIS
ipcalc-ng [OPTION]... IP address[/prefix] [netmask]
Description
ipcalc-ng provides a simple way to calculate IP information for a host or network.
Depending on the options specified, it may be used to provide IP network information in
human readable format, in a format suitable for parsing in scripts, generate random
private addresses, resolve an IP address, or check the validity of an address.
By default or when the --info or --all-info parameters are specified the information
provided is free form and human readable. Otherwise the output is JSON formatted when -j
is specified, or when specific options are given (e.g., --prefix) the output is in the
VAR=VALUE format.
The various options specify what information ipcalc-ng should display on standard output.
Multiple options may be specified. It is required to specify an IP address; several
operations require a netmask or a CIDR prefix as well.
Options
• -c, --check Validate the IP address under the specified family.
• -i, --info Display generic information on the provided network in human readable
format. This is the default option if no other options are provided.
• --all-info Display verbose information on the provided network and addresses in human
readable format. That includes GeoIP information.
• -S, --split Split the provided network using the specified prefix or netmask. That is,
split up the network into smaller chunks of a specified prefix. When combined with
no-decorate mode (--no-decorate), the split networks will be printed in raw form.
Example "ipcalc-ng -S 26 192.168.1.0/24".
• -d, --deaggregate Deaggregates the provided address range. That is, print the networks
that cover the range. The range is given using the '-' separator, e.g.,
"192.168.1.3-192.168.1.23". When combined with no-decorate mode (--no-decorate), the
networks are printed in raw form.
• -r, --random-private Generate a random private address using the supplied prefix or
mask. By default it displays output in human readable format, but may be combined with
other options (e.g., --network) to display specific information in VAR=VALUE format.
• -h, --hostname Display the hostname for the given IP address. The variable exposed is
HOSTNAME.
• -o, --lookup-host Display the IP address for the given hostname. The variable exposed
is ADDRESS.
• -4, --ipv4 Explicitly specify the IPv4 address family.
• -6, --ipv6 Explicitly specify the IPv6 address family.
• -b, --broadcast Display the broadcast address for the given IP address and netmask.
The variable exposed is BROADCAST (if available).
• -a, --address Display the IP address for the given input. The variable exposed is
ADDRESS (if available).
• -g, --geoinfo Display geographic information for the given IP address. This option
requires libGeoIP/libmaxminddb to be available. The variables exposed are COUNTRYCODE,
COUNTRY, CITY and COORDINATES (when available).
• -m, --netmask Calculate the netmask for the given IP address. If no mask or prefix is
provided, in IPv6 a 128-bit mask is assumed, while in IPv4 it assumes that the IP
address is in a complete class A, B, or C network. Note, however, that many networks
no longer use the default netmasks in IPv4. The variable exposed is NETMASK.
• -p, --prefix Show the prefix for the given mask/IP address. The variable exposed is
PREFIX.
• --class-prefix Assign the netmask of the provided IPv4 address based on the address
class. This was the default in previous versions of this software.
• -n, --network Display the network address for the given IP address and netmask. The
variable exposed is NETWORK.
• --reverse-dns Display the reverse DNS for the given IP address and netmask. The
variable exposed is REVERSEDNS.
• --minaddr Display the minimum host address in the provided network. The variable
exposed is MINADDR.
• --maxaddr Display the maximum host address in the provided network. The variable
exposed is MAXADDR.
• --addresses Display the number of host addresses in the provided network. The variable
exposed is ADDRESSES.
• --addrspace Display address space allocation information for the provided network. The
variable exposed is ADDRSPACE.
• --no-decorate Print only the requested information. That when combined with split
networks option, will only print the networks without any additions for readability.
• -j, --json When used with -i or -S, print the info as a JSON object instead of the
usual output format.
• -s, --silent Don't ever display error messages.
Examples
Display all information of an IPv4
$ ipcalc-ng --all-info 193.92.150.2/24
Address: 193.92.150.2
Network: 193.92.150.0/24
Netmask: 255.255.255.0 = 24
Broadcast: 193.92.150.255
Reverse DNS: 150.92.193.in-addr.arpa.
Address space: Internet
Address class: Class C
HostMin: 193.92.150.1
HostMax: 193.92.150.254
Hosts/Net: 254
Country code: GR
Country: Greece
Display information in key-value format
$ ipcalc-ng -pnmb --minaddr --maxaddr --geoinfo --addrspace 193.92.150.2/255.255.255.224
NETMASK=255.255.255.224
PREFIX=27
BROADCAST=193.92.150.31
NETWORK=193.92.150.0
MINADDR=193.92.150.1
MAXADDR=193.92.150.30
ADDRSPACE="Internet"
COUNTRY="Greece"
Display all information of an IPv6
$ ipcalc-ng --all-info 2a03:2880:20:4f06:face:b00c:0:14/64
Full Address: 2a03:2880:0020:4f06:face:b00c:0000:0014
Address: 2a03:2880:20:4f06:face:b00c:0:14
Full Network: 2a03:2880:0020:4f06:0000:0000:0000:0000/64
Network: 2a03:2880:20:4f06::/64
Netmask: ffff:ffff:ffff:ffff:: = 64
Reverse DNS: 6.0.f.4.0.2.0.0.0.8.8.2.3.0.a.2.ip6.arpa.
Address space: Global Unicast
HostMin: 2a03:2880:20:4f06::
HostMax: 2a03:2880:20:4f06:ffff:ffff:ffff:ffff
Hosts/Net: 2^(64) = 18446744073709551616
Country code: IE
Country: Ireland
Display JSON output
$ ipcalc-ng --all-info -j 2a03:2880:20:4f06:face:b00c:0:14/64
{
"FULLADDRESS":"2a03:2880:0020:4f06:face:b00c:0000:0014",
"ADDRESS":"2a03:2880:20:4f06:face:b00c:0:14",
"FULLNETWORK":"2a03:2880:0020:4f06:0000:0000:0000:0000",
"NETWORK":"2a03:2880:20:4f06::",
"NETMASK":"ffff:ffff:ffff:ffff::",
"PREFIX":"64",
"REVERSEDNS":"6.0.f.4.0.2.0.0.0.8.8.2.3.0.a.2.ip6.arpa.",
"ADDRSPACE":"Global Unicast",
"MINADDR":"2a03:2880:20:4f06::",
"MAXADDR":"2a03:2880:20:4f06:ffff:ffff:ffff:ffff",
"ADDRESSES":"18446744073709551616",
"COUNTRYCODE":"IE",
"COUNTRY":"Ireland",
"COORDINATES":"53.000000,-8.000000"
}
Lookup of a hostname
$ ipcalc-ng --lookup-host localhost --no-decorate
::1
IPv4 lookup of a hostname
$ ipcalc-ng --lookup-host localhost --no-decorate -4
127.0.0.1
Reverse lookup of a hostname
$ ipcalc-ng -h 127.0.0.1 --no-decorate
localhost
Authors
Nikos Mavrogiannopoulos <nmav@redhat.com>
Erik Troan <ewt@redhat.com>
Preston Brown <pbrown@redhat.com>
David Cantrell <dcantrell@redhat.com>
Reporting Bugs
Report bugs at https://gitlab.com/ipcalc/ipcalc/issues
Copyright
Copyright © 1997-2020 Red Hat, Inc. This is free software; see the source for copying
conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.
December 2020 IPCALC-NG(1)