├── MANIFEST.in ├── SECURITY.md ├── netbox_ipv4_tools ├── __init__.py ├── urls.py ├── views.py ├── navigation.py ├── static │ └── netbox_ipv4_tools │ │ └── js │ │ ├── range.js │ │ ├── supernet.js │ │ └── netmask.js └── templates │ └── netbox_ipv4_tools │ ├── cidr-to-range.html │ ├── supernet-calculator.html │ └── cidr.html ├── setup.py ├── .github └── workflows │ └── python-publish.yml ├── README.md ├── .gitignore └── LICENSE /MANIFEST.in: -------------------------------------------------------------------------------- 1 | recursive-include netbox_ipv4_tools/static * 2 | recursive-include netbox_ipv4_tools/templates * 3 | prune netbox_ipv4_tools/api/__pycache__ -------------------------------------------------------------------------------- /SECURITY.md: -------------------------------------------------------------------------------- 1 | # Security Policy 2 | 3 | ## Supported Versions 4 | 5 | 6 | | Version | Supported | 7 | | ------- | ------------------ | 8 | | > 3.0 | :white_check_mark: | 9 | | < 3.0 | :x: | 10 | 11 | ## Reporting a Vulnerability 12 | 13 | Please create an issue when you encounter a Security issue. 14 | -------------------------------------------------------------------------------- /netbox_ipv4_tools/__init__.py: -------------------------------------------------------------------------------- 1 | from netbox.plugins import PluginConfig 2 | 3 | class NetBoxIPV4ToolsConfig(PluginConfig): 4 | name = 'netbox_ipv4_tools' 5 | verbose_name = ' NetBox IPv4 Tools' 6 | description = 'Work with ipv4 in NetBox' 7 | version = '1.0.4' 8 | base_url = 'ipv4-tools' 9 | 10 | config = NetBoxIPV4ToolsConfig -------------------------------------------------------------------------------- /netbox_ipv4_tools/urls.py: -------------------------------------------------------------------------------- 1 | from django.urls import path 2 | from . import views 3 | 4 | urlpatterns = ( 5 | path('cidr-table/', views.CIDRTableView.as_view(), name='cidr_table'), 6 | path('cidr-to-range/', views.CIDRToIpRangeView.as_view(), name='cidr_to_range'), 7 | path('supernet-calculator/', views.SupernetCalculatorView.as_view(), name='supernet_calculator'), 8 | ) -------------------------------------------------------------------------------- /netbox_ipv4_tools/views.py: -------------------------------------------------------------------------------- 1 | from django.shortcuts import render 2 | from django.views.generic import View 3 | from django.contrib.auth.mixins import LoginRequiredMixin 4 | 5 | class CIDRTableView(LoginRequiredMixin, View): 6 | def get(self, request): 7 | return render( 8 | request, 9 | "netbox_ipv4_tools/cidr.html", 10 | ) 11 | 12 | class CIDRToIpRangeView(LoginRequiredMixin, View): 13 | def get(self, request): 14 | return render( 15 | request, 16 | "netbox_ipv4_tools/cidr-to-range.html", 17 | ) 18 | 19 | class SupernetCalculatorView(LoginRequiredMixin, View): 20 | def get(self, request): 21 | return render( 22 | request, 23 | "netbox_ipv4_tools/supernet-calculator.html", 24 | ) -------------------------------------------------------------------------------- /netbox_ipv4_tools/navigation.py: -------------------------------------------------------------------------------- 1 | from netbox.plugins import PluginMenu, PluginMenuItem 2 | 3 | menu = PluginMenu( 4 | label='IPv4 Tools', 5 | groups=( 6 | ( 7 | 'TOOLS', 8 | ( 9 | PluginMenuItem( 10 | link='plugins:netbox_ipv4_tools:cidr_table', 11 | link_text='CIDR Conversion Table' 12 | ), 13 | PluginMenuItem( 14 | link='plugins:netbox_ipv4_tools:cidr_to_range', 15 | link_text='CIDR to IP Range' 16 | ), 17 | PluginMenuItem( 18 | link='plugins:netbox_ipv4_tools:supernet_calculator', 19 | link_text='Supernet calculator' 20 | ), 21 | ), 22 | ), 23 | ), 24 | icon_class='mdi mdi-ip-network', 25 | ) -------------------------------------------------------------------------------- /setup.py: -------------------------------------------------------------------------------- 1 | from pathlib import Path 2 | 3 | from setuptools import find_packages, setup 4 | 5 | readme = Path(__file__).parent / "README.md" 6 | long_description = readme.read_text() 7 | 8 | setup( 9 | name="netbox-ipv4-tools", 10 | version="1.0.4", 11 | description="Work with ipv4 in NetBox", 12 | long_description=long_description, 13 | long_description_content_type="text/markdown", 14 | url="https://github.com/mlongo4290/netbox-ipv4-tools", 15 | author="Michael Longo", 16 | license="Apache 2.0", 17 | install_requires=[], 18 | packages=find_packages(), 19 | include_package_data=True, 20 | keywords=["netbox-plugin"], 21 | classifiers=[ 22 | "Programming Language :: Python", 23 | "Programming Language :: Python :: 3", 24 | "Programming Language :: Python :: 3 :: Only", 25 | ], 26 | project_urls={ 27 | "Source": "https://github.com/mlongo4290/netbox-ipv4-tools", 28 | }, 29 | ) 30 | -------------------------------------------------------------------------------- /.github/workflows/python-publish.yml: -------------------------------------------------------------------------------- 1 | # This workflow will upload a Python Package using Twine when a release is created 2 | # For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries 3 | 4 | # This workflow uses actions that are not certified by GitHub. 5 | # They are provided by a third-party and are governed by 6 | # separate terms of service, privacy policy, and support 7 | # documentation. 8 | 9 | name: Upload Python Package 10 | 11 | on: 12 | release: 13 | types: [published] 14 | 15 | permissions: 16 | contents: read 17 | 18 | jobs: 19 | deploy: 20 | 21 | runs-on: ubuntu-latest 22 | 23 | steps: 24 | - uses: actions/checkout@v3 25 | - name: Set up Python 26 | uses: actions/setup-python@v3 27 | with: 28 | python-version: '3.x' 29 | - name: Install dependencies 30 | run: | 31 | python -m pip install --upgrade pip 32 | pip install build 33 | - name: Build package 34 | run: python -m build 35 | - name: Publish package 36 | uses: pypa/gh-action-pypi-publish@27b31702a0e7fc50959f5ad993c78deac1bdfc29 37 | with: 38 | user: __token__ 39 | password: ${{ secrets.PYPI_API_TOKEN }} 40 | -------------------------------------------------------------------------------- /netbox_ipv4_tools/static/netbox_ipv4_tools/js/range.js: -------------------------------------------------------------------------------- 1 | document.addEventListener("DOMContentLoaded", () => { 2 | let cidr_input = document.querySelector('#cidr'); 3 | let btn_cidr_range = document.querySelector('#btn_cidr_range'); 4 | let card_result = document.querySelector('#card-result'); 5 | 6 | cidr_input.addEventListener("keypress", ev => { 7 | let keycode = (ev.keyCode ? ev.keyCode : ev.which); 8 | if (keycode == '13') { 9 | btn_cidr_range.trigger("click"); 10 | } 11 | }); 12 | 13 | btn_cidr_range.addEventListener("click", () => { 14 | card_result.classList.add("d-none"); 15 | cidr_input.classList.remove("is-invalid"); 16 | try 17 | { 18 | let cidr = new Netmask(cidr_input["value"]); 19 | 20 | document.querySelector("#td-mask").innerHTML = cidr.mask; 21 | document.querySelector("#td-wildcard").innerHTML= cidr.hostmask; 22 | document.querySelector("#td-network").innerHTML = cidr.base; 23 | document.querySelector("#td-broadcast").innerHTML = cidr.broadcast; 24 | document.querySelector("#td-first").innerHTML = cidr.first; 25 | document.querySelector("#td-last").innerHTML = cidr.last; 26 | document.querySelector("#td-size").innerHTML = cidr.size; 27 | card_result.classList.remove("d-none"); 28 | } 29 | catch 30 | { 31 | cidr_input.classList.add("is-invalid"); 32 | } 33 | }); 34 | }); -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ## netbox-ipv4-tools 2 | 3 | Work with ipv4 in NetBox. 4 | This project includes code from [netmask](https://github.com/rs/node-netmask) (rewritten in Vanilla Javascript), which is licensed under the MIT license: [original license](https://github.com/rs/node-netmask/blob/master/LICENSE.md) 5 | 6 | This plugin offers a place to retrieve 7 | - A table with the CIDR to netmask conversion, inluding the wildcard bits and the total hosts available per CIDR 8 | - A tool to convert a CIDR into an IP range including information such the usable host count, the netmask in decimal dotted format and the wildcard bits 9 | 10 | ## Install 11 | 12 | The plugin is available as a Python package and can be installed with pip. 13 | 14 | Run `pip install netbox-ipv4-tools` in your virtual env. 15 | 16 | Create a file named `local_requirements.txt` (if not already existing) in the NetBox root directory (alongside `requirements.txt`) and list the `netbox-ipv4-tools` package: 17 | 18 | ```no-highlight 19 | # echo netbox-ipv4-tools >> local_requirements.txt 20 | ``` 21 | 22 | Once installed, the plugin needs to be enabled in your `configuration.py` 23 | 24 | ```python 25 | # In your configuration.py 26 | PLUGINS = ["netbox_ipv4_tools"] 27 | ``` 28 | 29 | First run `source /opt/netbox/venv/bin/activate` to enter the Python virtual environment. 30 | 31 | 32 | Then run 33 | ```bash 34 | cd /opt/netbox/netbox 35 | pip3 install netbox-ipv4-tools 36 | python3 manage.py collectstatic --no-input 37 | ``` 38 | 39 | ### Versions 40 | This plugin requires netbox >= 4.0.0 41 | 42 | ### Thanks 43 | Thanks to [rs](https://github.com/rs) for the work on [netmask](https://github.com/rs/node-netmask) 44 | Thanks to [mattieserver](https://github.com/mattieserver) and his project [netbox-topology-view](https://github.com/mattieserver/netbox-topology-views). I used his work to get a working plugin and to publish it to pypi 45 | -------------------------------------------------------------------------------- /netbox_ipv4_tools/templates/netbox_ipv4_tools/cidr-to-range.html: -------------------------------------------------------------------------------- 1 | {% extends 'base/layout.html' %} 2 | {% load static %} 3 | 4 | {% block title %}CIDR to IP Range{% endblock %} 5 | 6 | {% block content %} 7 |
8 |
9 |
10 |
11 |
12 | 13 | 14 |
15 | Please provide a CIDR. 16 |
17 |
18 | 19 |
20 |
21 |
22 |
23 |
24 |
25 |
Result
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 |
Netmask
Wildcard Bits
Network IP
Broadcast IP
First usable IP
Last usable IP
Size
60 |
61 |
62 |
63 |
64 | {% endblock content %} 65 | 66 | {% block javascript %} 67 | 68 | 69 | {% endblock javascript %} -------------------------------------------------------------------------------- /netbox_ipv4_tools/templates/netbox_ipv4_tools/supernet-calculator.html: -------------------------------------------------------------------------------- 1 | {% extends 'base/layout.html' %} 2 | {% load static %} 3 | 4 | {% block title %}CIDR to supernet{% endblock %} 5 | 6 | {% block content %} 7 |
8 |
9 |
10 |
11 |
12 | 13 | 14 |
15 | Please provide a CIDR. 16 |
17 |
18 | 19 |
20 |
21 |
22 |
23 |
24 |
25 |
Result
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 |
Supernet address
Netmask
Wildcard Bits
Network IP
Broadcast IP
First usable IP
Last usable IP
Usable Host
64 |
65 |
66 |
67 |
68 | {% endblock content %} 69 | 70 | {% block javascript %} 71 | 72 | 73 | {% endblock javascript %} -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # Byte-compiled / optimized / DLL files 2 | __pycache__/ 3 | *.py[cod] 4 | *$py.class 5 | 6 | # C extensions 7 | *.so 8 | 9 | # Distribution / packaging 10 | .Python 11 | build/ 12 | develop-eggs/ 13 | dist/ 14 | downloads/ 15 | eggs/ 16 | .eggs/ 17 | lib/ 18 | lib64/ 19 | parts/ 20 | sdist/ 21 | var/ 22 | wheels/ 23 | pip-wheel-metadata/ 24 | share/python-wheels/ 25 | *.egg-info/ 26 | .installed.cfg 27 | *.egg 28 | MANIFEST 29 | 30 | # PyInstaller 31 | # Usually these files are written by a python script from a template 32 | # before PyInstaller builds the exe, so as to inject date/other infos into it. 33 | *.manifest 34 | *.spec 35 | 36 | # Installer logs 37 | pip-log.txt 38 | pip-delete-this-directory.txt 39 | 40 | # Unit test / coverage reports 41 | htmlcov/ 42 | .tox/ 43 | .nox/ 44 | .coverage 45 | .coverage.* 46 | .cache 47 | nosetests.xml 48 | coverage.xml 49 | *.cover 50 | *.py,cover 51 | .hypothesis/ 52 | .pytest_cache/ 53 | 54 | # Translations 55 | *.mo 56 | *.pot 57 | 58 | # Django stuff: 59 | *.log 60 | local_settings.py 61 | db.sqlite3 62 | db.sqlite3-journal 63 | 64 | # Flask stuff: 65 | instance/ 66 | .webassets-cache 67 | 68 | # Scrapy stuff: 69 | .scrapy 70 | 71 | # Sphinx documentation 72 | docs/_build/ 73 | 74 | # PyBuilder 75 | target/ 76 | 77 | # Jupyter Notebook 78 | .ipynb_checkpoints 79 | 80 | # IPython 81 | profile_default/ 82 | ipython_config.py 83 | 84 | # pyenv 85 | .python-version 86 | 87 | # pipenv 88 | # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control. 89 | # However, in case of collaboration, if having platform-specific dependencies or dependencies 90 | # having no cross-platform support, pipenv may install dependencies that don't work, or not 91 | # install all needed dependencies. 92 | #Pipfile.lock 93 | 94 | # PEP 582; used by e.g. github.com/David-OConnor/pyflow 95 | __pypackages__/ 96 | 97 | # Celery stuff 98 | celerybeat-schedule 99 | celerybeat.pid 100 | 101 | # SageMath parsed files 102 | *.sage.py 103 | 104 | # Environments 105 | .env 106 | .venv 107 | env/ 108 | venv/ 109 | ENV/ 110 | env.bak/ 111 | venv.bak/ 112 | 113 | # Spyder project settings 114 | .spyderproject 115 | .spyproject 116 | 117 | # Rope project settings 118 | .ropeproject 119 | 120 | # mkdocs documentation 121 | /site 122 | 123 | # mypy 124 | .mypy_cache/ 125 | .dmypy.json 126 | dmypy.json 127 | 128 | # Pyre type checker 129 | .pyre/ 130 | 131 | node_modules 132 | app.js.map -------------------------------------------------------------------------------- /netbox_ipv4_tools/static/netbox_ipv4_tools/js/supernet.js: -------------------------------------------------------------------------------- 1 | document.addEventListener("DOMContentLoaded", () => { 2 | let cidr_input = document.querySelector('#cidr'); 3 | let btn_cidr_supernet = document.querySelector('#btn_cidr_supernet'); 4 | let card_result = document.querySelector('#card-result'); 5 | 6 | btn_cidr_supernet.addEventListener("click", () => { 7 | card_result.classList.add("d-none"); 8 | cidr_input.classList.remove("is-invalid"); 9 | 10 | let supernet_binary = ""; 11 | let supernet_length = 32; 12 | let cidrs = cidr_input["value"].split(/[\n,\s]+/g); 13 | cidrs.every(c => { 14 | c = c.trim(); 15 | if(!c) 16 | return false; 17 | try 18 | { 19 | let cidr = new Netmask(c); 20 | let network = cidr.base.split(".").map(b => {return parseInt(b)}); 21 | let binary_network = ""; 22 | for(let i = 0; i < 4; i++) 23 | { 24 | let b = network[i].toString(2); 25 | b = "00000000".substr(b.length) + b; 26 | binary_network += b; 27 | } 28 | 29 | if(supernet_binary.length == 0) 30 | { 31 | supernet_binary = binary_network; 32 | } 33 | else 34 | { 35 | let local_length = 0; 36 | for(let i = 0; i < 32; i++) 37 | { 38 | 39 | if(supernet_binary[i] != binary_network[i]) 40 | { 41 | done = true; 42 | break; 43 | } 44 | 45 | local_length++; 46 | } 47 | 48 | if(local_length < supernet_length) 49 | { 50 | supernet_length = local_length; 51 | } 52 | } 53 | return true; 54 | } 55 | catch(error) 56 | { 57 | cidr_input.classList.add("is-invalid"); 58 | return false; 59 | } 60 | }); 61 | 62 | let supernet = ["", "", "", ""]; 63 | let x = -1; 64 | for(let i = 0; i < 32; i++) 65 | { 66 | if(i%8 == 0) 67 | { 68 | x++; 69 | } 70 | if(i < supernet_length) 71 | { 72 | supernet[x] += supernet_binary[i]; 73 | } 74 | else 75 | { 76 | supernet[x] += "0"; 77 | } 78 | } 79 | 80 | for(let i = 0; i < 4; i++) 81 | { 82 | supernet[i] = parseInt(supernet[i], 2); 83 | } 84 | supernet = new Netmask(supernet.join(".") + "/" + supernet_length); 85 | document.querySelector("#td-address").innerHTML = supernet.toString(); 86 | document.querySelector("#td-mask").innerHTML = supernet.mask; 87 | document.querySelector("#td-wildcard").innerHTML= supernet.hostmask; 88 | document.querySelector("#td-network").innerHTML = supernet.base; 89 | document.querySelector("#td-broadcast").innerHTML = supernet.broadcast; 90 | document.querySelector("#td-first").innerHTML = supernet.first; 91 | document.querySelector("#td-last").innerHTML = supernet.last; 92 | document.querySelector("#td-hosts").innerHTML = supernet.size; 93 | card_result.classList.remove("d-none"); 94 | }); 95 | }); -------------------------------------------------------------------------------- /netbox_ipv4_tools/static/netbox_ipv4_tools/js/netmask.js: -------------------------------------------------------------------------------- 1 | const long2ip = long => { 2 | let a = (long & (0xff << 24)) >>> 24; 3 | let b = (long & (0xff << 16)) >>> 16; 4 | let c = (long & (0xff << 8)) >>> 8; 5 | let d = long & 0xff; 6 | return [a, b, c, d].join('.'); 7 | } 8 | 9 | const ip2long = ip => { 10 | let b = []; 11 | for(let i in [0,1,2,3]) 12 | { 13 | if(ip.length == 0) 14 | break; 15 | if(i > 0) 16 | { 17 | if(ip[0] != '.') 18 | throw new Error('Invalid IP'); 19 | ip = ip.substring(1); 20 | } 21 | let [n, c] = atob(ip); 22 | ip = ip.substring(c); 23 | b.push(n); 24 | } 25 | 26 | if(ip.length != 0) 27 | throw new Error('Invalid IP'); 28 | 29 | switch(b.length) 30 | { 31 | case 1: 32 | //Long input notation 33 | if(b[0] > 0xFFFFFFFF) 34 | throw new Error('Invalid IP'); 35 | return b[0] >>> 0; 36 | case 2: 37 | //Class A notation 38 | if(b[0] > 0xFF || b[1] > 0xFFFFFF) 39 | throw new Error('Invalid IP'); 40 | return (b[0] << 24 | b[1]) >>> 0; 41 | case 3: 42 | //Class B notation 43 | if(b[0] > 0xFF || b[1] > 0xFF || b[2] > 0xFFFF) 44 | throw new Error('Invalid IP'); 45 | return (b[0] << 24 | b[1] << 16 | b[2]) >>> 0; 46 | case 4: 47 | //Dotted quad notation 48 | if(b[0] > 0xFF || b[1] > 0xFF || b[2] > 0xFF || b[3] > 0xFF) 49 | throw new Error('Invalid IP'); 50 | return (b[0] << 24 | b[1] << 16 | b[2] << 8 | b[3]) >>> 0; 51 | default: 52 | throw new Error('Invalid IP'); 53 | } 54 | } 55 | 56 | const chr = b => { 57 | return b.charCodeAt(0); 58 | } 59 | 60 | const chr0 = chr('0'); 61 | const chra = chr('a'); 62 | const chrA = chr('A'); 63 | 64 | const atob = s => { 65 | let n = 0; 66 | let base = 10; 67 | let dmax = '9'; 68 | let i = 0; 69 | if(s.length > 1 && s[i] == '0') 70 | { 71 | if(s[i+1] == 'x' || s[i+1] == 'X') 72 | { 73 | i += 2; 74 | base = 16; 75 | } 76 | else if('0' <= s[i+1] && s[i+1] <= '9') 77 | { 78 | i++; 79 | base = 8; 80 | dmax = '7'; 81 | } 82 | } 83 | let start = i; 84 | while(i < s.length) 85 | { 86 | if('0' <= s[i] && s[i] <= dmax) 87 | n = (n*base + (chr(s[i])-chr0)) >>> 0; 88 | else if(base == 16) 89 | { 90 | if('a' <= s[i] && s[i] <= 'f') 91 | n = (n*base + (10+chr(s[i])-chra)) >>> 0; 92 | else if('A' <= s[i] && s[i] <= 'F') 93 | n = (n*base + (10+chr(s[i])-chrA)) >>> 0; 94 | else 95 | break; 96 | } 97 | else 98 | break; 99 | if(n > 0xFFFFFFFF) 100 | throw new Error('too large'); 101 | i++; 102 | } 103 | if(i == start) 104 | throw new Error('empty octet'); 105 | return [n, i]; 106 | } 107 | 108 | class Netmask { 109 | constructor(net, mask) { 110 | if(typeof net != "string") 111 | throw new Error("Missing `net' parameter"); 112 | if(!mask) 113 | //try to find the mask in the net (i.e.: 1.2.3.4/24 or 1.2.3.4/255.255.255.0) 114 | [net, mask] = net.split('/'); 115 | if(!mask) 116 | mask = 32; 117 | if(typeof mask == 'string' && mask.indexOf('.') > -1) 118 | { 119 | //Compute bitmask, the netmask as a number of bits in the network portion of the address for this block (eg.: 24) 120 | try 121 | { 122 | this.maskLong = ip2long(mask); 123 | } 124 | catch(error) 125 | { 126 | throw new Error("Invalid mask: #{mask}"); 127 | } 128 | for(let i = 32; i >= 0; i++) 129 | { 130 | if(this.maskLong == (0xffffffff << (32 - i)) >>> 0) 131 | { 132 | this.bitmask = i; 133 | break; 134 | } 135 | } 136 | } 137 | else if (mask || mask == 0) 138 | { 139 | //The mask was passed as bitmask, compute the mask as long from it 140 | this.bitmask = parseInt(mask, 10); 141 | this.maskLong = 0; 142 | if (this.bitmask > 0) 143 | this.maskLong = (0xffffffff << (32 - this.bitmask)) >>> 0; 144 | } 145 | else 146 | throw new Error("Invalid mask: empty"); 147 | 148 | try 149 | { 150 | this.netLong = (ip2long(net) & this.maskLong) >>> 0; 151 | } 152 | catch(error) 153 | { 154 | throw new Error("Invalid net address: #{net}"); 155 | } 156 | 157 | if(this.bitmask > 32) 158 | { 159 | throw new Error("Invalid mask for ip4: #{mask}"); 160 | } 161 | 162 | //The number of IP address in the block (eg.: 254) 163 | this.size = Math.pow(2, 32 - this.bitmask); 164 | //The address of the network block as a string (eg.: 216.240.32.0) 165 | this.base = long2ip(this.netLong); 166 | //The netmask as a string (eg.: 255.255.255.0) 167 | this.mask = long2ip(this.maskLong); 168 | //The host mask, the opposite of the netmask (eg.: 0.0.0.255) 169 | this.hostmask = long2ip(~this.maskLong); 170 | //The first usable address of the block 171 | this.first = this.bitmask <= 30 ? long2ip(this.netLong + 1) : this.base; 172 | //The last usable address of the block 173 | this.last = this.bitmask <= 30 ? long2ip(this.netLong + this.size - 2) : long2ip(this.netLong + this.size - 1); 174 | //The block's broadcast address: the last address of the block (eg.: 192.168.1.255) 175 | this.broadcast = this.bitmask <= 30 ? long2ip(this.netLong + this.size - 1) : ""; 176 | } 177 | 178 | //Returns true if the given ip or netmask is contained in the block 179 | contains = ip => { 180 | if (typeof ip == 'string' && (ip.indexOf('/') > 0 || ip.split('.').length != 4)) 181 | ip = new Netmask(ip); 182 | 183 | if (ip instanceof Netmask) 184 | return this.contains(ip.base) && this.contains((ip.broadcast || ip.last)); 185 | else 186 | return (ip2long(ip) & this.maskLong) >>> 0 == (this.netLong & this.maskLong) >>> 0; 187 | } 188 | 189 | //Returns the Netmask object for the block which follow this one 190 | next = (count=1) =>{ 191 | return new Netmask(long2ip(this.netLong + (this.size * count)), this.mask); 192 | } 193 | 194 | forEach = fn => { 195 | //this implementation is not idiomatic but avoids large memory allocations (2 arrays, one for range and one for the results) in cases when then netmask is large 196 | let long = ip2long(this.first); 197 | let lastLong = ip2long(this.last); 198 | let index = 0; 199 | while(long <= lastLong) 200 | { 201 | fn(long2ip(long), long, index); 202 | index++; 203 | long++; 204 | } 205 | return; 206 | } 207 | 208 | //Returns the complete netmask formatted as `base/bitmask` 209 | toString = () => 210 | { 211 | return this.base + "/" + this.bitmask; 212 | } 213 | } 214 | //exports.ip2long = ip2long 215 | //exports.long2ip = long2ip 216 | //exports.Netmask = Netmask 217 | -------------------------------------------------------------------------------- /netbox_ipv4_tools/templates/netbox_ipv4_tools/cidr.html: -------------------------------------------------------------------------------- 1 | {% extends 'base/layout.html' %} 2 | {% block title %}CIDR Conversion Table{% endblock %} 3 | 4 | {% block content %} 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 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | 143 | 144 | 145 | 146 | 147 | 148 | 149 | 150 | 151 | 152 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 161 | 162 | 163 | 164 | 165 | 166 | 167 | 168 | 169 | 170 | 171 | 172 | 173 | 174 | 175 | 176 | 177 | 178 | 179 | 180 | 181 | 182 | 183 | 184 | 185 | 186 | 187 | 188 | 189 | 190 | 191 | 192 | 193 | 194 | 195 | 196 | 197 | 198 | 199 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 209 | 210 |
CIDR prefix lengthNetmaskWildcard BitsNumber of Usable IPs
/1128.0.0.0127.255.255.2552,147,483,646
/2192.0.0.063.255.255.2551,073,741,822
/3224.0.0.031.255.255.255536,870,910
/4240.0.0.015.255.255.255268,435,454
/5248.0.0.07.255.255.255134,217,726
/6252.0.0.03.255.255.25567,108,862
/7254.0.0.01.255.255.25533,554,430
/8255.0.0.00.255.255.25516,777,214
/9255.128.0.00.127.255.2558,388,606
/10255.192.0.00.63.255.2554,194,302
/11255.224.0.00.31.255.2552,097,150
/12255.240.0.00.15.255.2551,048,574
/13255.248.0.00.7.255.255524,286
/14255.252.0.00.3.255.255262,142
/15255.254.0.00.1.255.255131,070
/16255.255.0.00.0.255.25565,534
/17255.255.128.00.0.127.25532,766
/18255.255.192.00.0.63.25516,382
/19255.255.224.00.0.31.2558,190
/20255.255.240.00.0.15.2554,094
/21255.255.248.00.0.7.2552,046
/22255.255.252.00.0.3.2551,022
/23255.255.254.00.0.1.255510
/24255.255.255.00.0.0.255254
/25255.255.255.1280.0.0.127126
/26255.255.255.1920.0.0.6362
/27255.255.255.2240.0.0.3130
/28255.255.255.2400.0.0.1514
/29255.255.255.2480.0.0.76
/30255.255.255.2520.0.0.32
/31255.255.255.2540.0.0.10
/32255.255.255.2550.0.0.01
211 |
212 |
213 | {% endblock content %} -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "[]" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright [yyyy] [name of copyright owner] 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | --------------------------------------------------------------------------------