X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=FS%2FFS%2Faddr_block.pm;h=0fe2476a2a47dad768a679b86823b882878b1017;hb=387c96b0d8f224f3ade27bed9348f37b432bbb8a;hp=1fb60606da9cd363d255f0a3adc3b33a704ec1d7;hpb=2041a9143fac20b79ead4a1ae01224dedf5b27c2;p=freeside.git diff --git a/FS/FS/addr_block.pm b/FS/FS/addr_block.pm index 1fb60606d..0fe2476a2 100755 --- a/FS/FS/addr_block.pm +++ b/FS/FS/addr_block.pm @@ -7,6 +7,7 @@ use FS::router; use FS::svc_broadband; use FS::Conf; use NetAddr::IP; +use Carp qw( carp ); @ISA = qw( FS::Record ); @@ -47,6 +48,10 @@ block is assigned. =item ip_netmask - the netmask of the block, expressed as an integer. +=item manual_flag - prohibit automatic ip assignment from this block when true. + +=item agentnum - optional agent number (see L) + =back =head1 METHODS @@ -84,6 +89,28 @@ sub delete { Replaces OLD_RECORD with this one in the database. If there is an error, returns the error, otherwise returns false. +At present it's not possible to reallocate a block to a different router +except by deallocating it first, which requires that none of its addresses +be assigned. This is probably as it should be. + +sub replace_check { + my ( $new, $old ) = ( shift, shift ); + + unless($new->routernum == $old->routernum) { + my @svc = $self->svc_broadband; + if (@svc) { + return 'Block has assigned addresses: '. + join ', ', map {$_->ip_addr} @svc; + } + + return 'Block is already allocated' + if($new->routernum && $old->routernum); + + } + + ''; +} + =item check Checks all fields to make sure this is a valid record. If there is an error, @@ -99,6 +126,8 @@ sub check { $self->ut_number('routernum') || $self->ut_ip('ip_gateway') || $self->ut_number('ip_netmask') + || $self->ut_enum('manual_flag', [ '', 'Y' ]) + || $self->ut_agentnum_acl('agentnum', 'Broadband global configuration') ; return $error if $error; @@ -158,21 +187,34 @@ Returns a NetAddr::IP object for this block's address and netmask. sub NetAddr { my $self = shift; + new NetAddr::IP ($self->ip_gateway, $self->ip_netmask); +} + +=item cidr + +Returns a CIDR string for this block's address and netmask, i.e. 10.4.20.0/24 + +=cut - return new NetAddr::IP ($self->ip_gateway, $self->ip_netmask); +sub cidr { + my $self = shift; + $self->NetAddr->cidr; } =item next_free_addr Returns a NetAddr::IP object corresponding to the first unassigned address in the block (other than the network, broadcast, or gateway address). If -there are no free addresses, returns false. +there are no free addresses, returns false. There are never free addresses +when manual_flag is true. =cut sub next_free_addr { my $self = shift; + return '' if $self->manual_flag; + my $conf = new FS::Conf; my @excludeaddr = $conf->config('exclude_ip_addr'); @@ -192,7 +234,7 @@ my @used = } -=item allocate +=item allocate -- deprecated Allocates this address block to a router. Takes an FS::router object as an argument. @@ -205,25 +247,18 @@ be assigned. This is probably as it should be. sub allocate { my ($self, $router) = @_; - - return 'Block is already allocated' - if($self->router); + carp "deallocate deprecated -- use replace"; return 'Block must be allocated to a router' unless(ref $router eq 'FS::router'); - my @svc = $self->svc_broadband; - if (@svc) { - return 'Block has assigned addresses: '. join ', ', map {$_->ip_addr} @svc; - } - my $new = new FS::addr_block {$self->hash}; $new->routernum($router->routernum); return $new->replace($self); } -=item deallocate +=item deallocate -- deprecated Deallocates the block (i.e. sets the routernum to 0). If any addresses in the block are assigned to services, it fails. @@ -231,13 +266,9 @@ block are assigned to services, it fails. =cut sub deallocate { + carp "deallocate deprecated -- use replace"; my $self = shift; - my @svc = $self->svc_broadband; - if (@svc) { - return 'Block has assigned addresses: '. join ', ', map {$_->ip_addr} @svc; - } - my $new = new FS::addr_block {$self->hash}; $new->routernum(0); return $new->replace($self); @@ -318,6 +349,29 @@ sub split_block { To be implemented. +=item agent + +Returns the agent (see L) for this address block, if one exists. + +=cut + +sub agent { + qsearchs('agent', { 'agentnum' => shift->agentnum } ); +} + +=item label + +Returns text including the router name, gateway ip, and netmask for this +block. + +=cut + +sub label { + my $self = shift; + my $router = $self->router; + ($router ? $router->routername : '(unallocated)'). ':'. $self->NetAddr; +} + =back =head1 BUGS