# SPDX-FileCopyrightText: 2004-2025 Univention GmbH
# SPDX-License-Identifier: AGPL-3.0-only
"""|UDM| module for |DHCP| subnets"""
from __future__ import annotations
import univention.admin.filter
import univention.admin.handlers
import univention.admin.localization
from univention.admin.layout import Group, Tab
from .__common import DHCPBaseSubnet, add_dhcp_options, rangeMap, rangeUnmap
translation = univention.admin.localization.translation('univention.admin.handlers.dhcp')
_ = translation.translate
module = 'dhcp/subnet'
operations = ['add', 'edit', 'remove', 'search']
superordinate = 'dhcp/service'
childs = True
childmodules = ['dhcp/pool']
short_description = _('DHCP: Subnet')
object_name = _('DHCP subnet')
object_name_plural = _('DHCP subnets')
long_description = _('The IP address range used in a dedicated (non-shared) physical network.')
# fmt: off
options = {
'default': univention.admin.option(
short_description=short_description,
default=True,
objectClasses=['top', 'univentionDhcpSubnet'],
),
}
property_descriptions = {
'subnet': univention.admin.property(
short_description=_('Subnet address'),
long_description=_('The network address.'),
syntax=univention.admin.syntax.ipv4Address,
include_in_default_search=True,
required=True,
may_change=False,
identifies=True,
),
'subnetmask': univention.admin.property(
short_description=_('Address prefix length (or Netmask)'),
long_description=_('The number of leading bits of the IP address used to identify the network.'),
syntax=univention.admin.syntax.v4netmask,
required=True,
),
'broadcastaddress': univention.admin.property(
short_description=_('Broadcast address'),
long_description=_('The IP addresses used to send data to all hosts inside the network.'),
syntax=univention.admin.syntax.ipv4Address,
),
'range': univention.admin.property(
short_description=_('Dynamic address assignment'),
long_description=_('Define a pool of addresses available for dynamic address assignment.'),
syntax=univention.admin.syntax.IPv4_AddressRange,
multivalue=True,
),
}
layout = [
Tab(_('General'), _('Basic settings'), layout=[
Group(_('General DHCP subnet settings'), layout=[
['subnet', 'subnetmask'],
'broadcastaddress',
'range',
]),
]),
]
mapping = univention.admin.mapping.mapping()
mapping.register('subnet', 'cn', None, univention.admin.mapping.ListToString)
mapping.register('subnetmask', 'dhcpNetMask', None, univention.admin.mapping.ListToString)
mapping.register('broadcastaddress', 'univentionDhcpBroadcastAddress', None, univention.admin.mapping.ListToString, encoding='ASCII')
mapping.register('range', 'dhcpRange', rangeMap, rangeUnmap)
# fmt: on
add_dhcp_options(__name__)
[docs]
class object(DHCPBaseSubnet):
module = module
[docs]
@staticmethod
def unmapped_lookup_filter() -> univention.admin.filter.conjunction:
return univention.admin.filter.conjunction('&', [
univention.admin.filter.expression('objectClass', 'univentionDhcpSubnet'),
univention.admin.filter.conjunction('!', [univention.admin.filter.expression('objectClass', 'univentionDhcpSharedSubnet')]),
])
[docs]
def identify(dn: str, attr: univention.admin.handlers._Attributes) -> bool:
return b'univentionDhcpSubnet' in attr.get('objectClass', []) and b'univentionDhcpSharedSubnet' not in attr.get('objectClass', [])
lookup_filter = object.lookup_filter
lookup = object.lookup
