NAME

       ripcalc - a tool for network addresses

SYNOPSIS

       ripcalc 127.0.0.1

       ripcalc -4/--ipv4 127.0.0.1

       ripcalc -6/--ipv6 ::1

       ripcalc -f/--format “%a/%c” 127.0.0.1

       ripcalc -m/--mask 28 127.0.0.1

       ripcalc -c/--csv path/to/csv [-i/--field network] 127.0.0.1

       ripcalc -l/--list 127.0.0.1

       ripcalc -a/--available

       ripcalc -s/--file [-] 127.0.0.1

       ripcalc -e/--encapsulating [-s/--file name]

       ripcalc -s/--file name [--inside/--outside] 127.0.0.1

       ripcalc -b/--base [8, 10, 16 etc]

       ripcalc -d/--divide [CIDR] 127.0.0.1/24

       ripcalc -h/--help

DESCRIPTION

       ripcalc  can  read  IPv4/IPv6  addresses  from  command  line or standard input and output
       different formats or associated networks from CSV.

       ripcalc can format network addresses, find matches in CSV or process a list.

       ripcalc can convert input addresses that are in other number formats such as hex or octal.

       Given a list of IP addresses, print only those that match the network.  When s and  inside
       are  used,  only addresses from -s are printed if they are that are inside of the input IP
       network from the command line.  This can be reversed with --outside,  (e.g. ripcalc  -s  -
       --inside 192.168.0.0/16).

       When  -a  is  used,  addresses  read  from -s will not be shown when listing -l a network,
       showing only available addresses.

       When --reverse is used the inputs, sources or both can be treated as back-to-front.

       ripcalc can return a list of subnets when a network is  provided  along  with  the  divide
       argument and a subnet CIDR mask.

       When --encapsulating is used the containing network will be returned.

CSV

       Network matches can be returned from a CSV.

              $ cat nets.csv
              network,range,owner
              rfc1918,192.168.0.0/16,bob
              rfc1918,172.16.0.0/12,cliff
              rfc1918,10.0.0.0/8,mr nobody
              $ ripcalc --csv nets.csv -i range --format '%{owner}\n' 192.168.0.0
              bob

       Addresses can be read via file or from stdin (-):

              $ cat list
              127.0.0.1/28
              10.0.0.1/28
              192.168.1.1/30
              172.18.1.1/30
              10.0.0.0/30
              $ ripcalc --csv nets.csv -i range --format '%{range} %{owner}\n' -s list
              10.0.0.0/8 mr nobody
              192.168.0.0/16 bob
              172.16.0.0/12 cliff
              10.0.0.0/8 mr nobody

FORMAT

       % denotes a format control character, followed by one of the following:

       placeholder   effect
       ───────────────────────────────────────
       %a            IP address string
       %n            Network address string
       %s            Subnet address string
       %w            Wildcard address string
       %b            Broadcast address string

       Additional characters prefixing the above placeholder can control the representation:

       placeholder   effect
       ───────────────────────────────────────────────
       %B            Binary address string
       %S            Split binary at network boundary
                     string
       %l            Unsigned integer string
       %L            Signed integer string
       %x            Hex address string

       Other format characters:

       placeholder   effect
       ───────────────────────────────────────────────
       %c            CIDR mask
       %t            Network size
       %r            Network reservation  information
                     (if available)
       %d            Matching device interface by IP
       %m            Matching media link interface by
                     network
       %k            RBL-style format
       %%            %
       \n            Line break
       \t            Tab character

       %xa gives the address in hex, or %Sa to return the binary address, split  at  the  network
       boundary.

       When using CSV fields can be matched by name when network matched:

              --format '%{name}'

   inside/outside
       When  --inside  or  --outside  are  given  addresses that match --file are printed.  If no
       matches are found ripcalc will exit non-zero.

AUTHORS

       Ed Neville (ed-ripcalc@s5h.net).