ripcal

Crates.ioripcal
lib.rsripcal
version0.6.1
sourcesrc
created_at2023-07-03 17:16:35.628428
updated_at2024-07-14 14:38:20.788179
descriptionConvert IP address strings to/from integers
homepage
repositoryhttps://github.com/fractalb/ripcal
max_upload_size
id907214
size51,997
Balaji Marisetti (fractalb)

documentation

README

ripcal

Convert IP addresses dotted quads to/from integers Also, Converts IP subnets to/from IP ranges

    ripcal [-i | -x | -q ] [-r] <ip-address>...
            Converts each <ip-address> to different formats
            If no option is provided then ip-quads will be
            converted to hexa-decimal integers and all
            integers will be converted to ipv4 dotted quads.

    Options:
            --integer or -i
                    Converts to a deca-decimal integer
            --hex or -x
                    Converts to a hexa-decimal integer
            --ipv4 or -q
                    Converts to an ip-quad
            --reverse-bytes or -r
                    Reverses the byte order

    ripcal <ip-addr/subnet> | "<ip-start - ip-end>"
            ip-addr/subnet will be converted to the corresponding
            ip-range ("start - end"). "start - end" (ip-range)
            will be converted to the minimal ip-addr/subnet which
            covers the given range.

    ripcal <ip-addr/subnet> | "<ip-start - ip-end>"
            ip-addr/subnet will be converted to ip-range ("start - end").
            "start_ip - end_ip" (ip-range) will be converted to minimal
            ip-addr/subnet which covers the given range.

    ripcal -m <ip-addr/subnet> | "<ip-start - ip-end>"
            Merge overlapping subnets and/or ip-ranges and print a minimal
            set of ip-ranges (and subnets) that cover all the input
            ip-ranges (and/or) subnets.

    ripcal -h or ripcal --help
            displays this help

    ripcal --version
            displays the program version\n"

Converts each :

  • from dotted quad to hexadecimal integer
  • from hexadecimal/decimal integers to dotted quad

Converts ip-address/subnet representation to/from ip-address range

Examples:

    $ ripcal 192.168.2.4 0xc0a80204 3232236036
    192.168.2.4 = 0xc0a80204
    0xc0a80204 = 192.168.2.4
    3232236036 = 192.168.2.4

    $ ripcal -q 192.168.2.4 0xc0a80204 3232236036
    192.168.2.4 = 192.168.2.4
    0xc0a80204 = 192.168.2.4
    3232236036 = 192.168.2.4

    $ ripcal -x 192.168.2.4 0xc0a80204 3232236036
    192.168.2.4 = 0xc0a80204
    0xc0a80204 = 0xc0a80204
    3232236036 = 0xc0a80204

    $ ripcal -i 192.168.2.4 0xc0a80204 3232236036
    192.168.2.4 = 3232236036
    0xc0a80204 = 3232236036
    3232236036 = 3232236036

    $ ripcal 0xc0a80204 -r 0xc0a80204
    0xc0a80204 = 192.168.2.4
    Reverse 0xc0a80204 = 4.2.168.192

    $ ripcal 64420102 0x64420102
    64420102 = 3.214.249.6
    0x64420102 = 100.66.1.2

    $ ripcal 0xa141e28 a141e28
    0xa141e28 = 10.20.30.40
    a141e28 = 10.20.30.40

    $ ripcal 192.168.1.0/24
    192.168.1.0/24 = 192.168.1.0/24
    192.168.1.0/24 = 192.168.1.0 - 192.168.1.255

    $ ripcal "192.168.1.1 - 192.168.1.127"
    192.168.1.1 - 192.168.1.127 = 192.168.1.0/25
    192.168.1.0/25 = 192.168.1.0 - 192.168.1.127

Note1: "192.168.1.1 - 192.168.1.127" is converted to "192.168.1.0 - 192.168.1.127" since the given input cannot be represented as an exact subnet. So, the input is converted into minimal enclosing subnet (192.168.1.0/25)

Note2: The quotes around the IP address range ("192.168.1.1 - 192.168.1.127") is needed because there is a space in between the ip-addresses. Alternatively, 192.168.1.1-192.168.1.127, with no spaces, will work without quotes.

    $ ripcal -m "192.168.1.1 - 192.168.1.127"
    [192.168.1.1 - 192.168.1.127]
    [192.168.1.1/32, 192.168.1.2/31, 192.168.1.4/30, 192.168.1.8/29, 192.168.1.16/28, 192.168.1.32/27, 192.168.1.64/26]

    $ ripcal -m "192.168.2.3 - 192.168.2.255" 192.168.3.0/24 192.168.2.0-192.168.2.2
    [192.168.2.0 - 192.168.3.255]
    [192.168.2.0/23]

    $ ripcal -m "192.168.1.0 - 192.168.1.255" "192.168.3.0 - 192.168.3.255"
    [192.168.1.0 - 192.168.1.255, 192.168.3.0 - 192.168.3.255]
    [192.168.1.0/24, 192.168.3.0/24]

When no ip-address arguments are given on the command, then the program will read from stdin and write to stdout (filter mode).

    $ ripcal
    1.2.3.4
    0x1020304
    3232236036
    192.168.2.4
    ^D

    $ echo "192.168.2.3" | ripcal
    0xc0a80203

The command expects only one IP address per line in filter mode. The below commands won't work as expected

    $ ripcal <<<"192.168.2.3 192.168.3.2"
    Invaid IP address: 192.168.2.3 192.168.3.2

    $ echo "192.168.2.3 192.168.3.2" | ripcal
    Invaid IP address: 192.168.2.3 192.168.3.2
Commit count: 36

cargo fmt