dhcp-address-block (nrcmd)			  dhcp-address-block (nrcmd)


NAME
    dhcp-address-block - Defines a contiguous range of IP address space
    from which the DHCP server may allocate subnets

SYNOPSIS
    dhcp-address-block <name> create <address> [<attribute>=<value> ...]
    dhcp-address-block <name> delete 
    dhcp-address-block list
    dhcp-address-block listnames
    dhcp-address-block <name> show
    dhcp-address-block <name> listsubnets
    
    dhcp-address-block <name> get <attribute>
    dhcp-address-block <name> set<attribute>=<value> [<attribute>=<value> ...]
    dhcp-address-block <name> unset <attribute>
    dhcp-address-block <name> enable <attribute>
    dhcp-address-block <name> disable <attribute>

DESCRIPTION
    The dhcp-address-block command creates and sets attributes
    for Network Registrar DHCP address blocks. The command applies
    only to address block objects that are designated in the 
    DHCP server for subnet allocation to clients. When a DHCP server
    receives a request to allocate a subnet to a client, it does so 
    by subdividing its available address-blocks. In this context, 
    a DHCP address block is a contiguous range of IP address space
    that is delegated to the DHCP server for assignment. The DHCP 
    server expects to subdivide these DHCP address blocks for 
    delegation to some other server or device, or for its own use in
    interaction with DHCP clients.

    DHCP address blocks can parent one or more subnets. Subnets are also
    contiguous ranges of IP address space that are bound to a specific 
    client, usually a router or another DHCP server. DHCP address blocks
    and subnets are similar to scopes in that they contain address ranges
    and other attributes necessary to configure the DHCP client-server 
    interaction. Unlike scopes, DHCP address blocks and subnets do not 
    have address ranges available for assignment to DHCP clients and do 
    not contain reserved addresses.

    In a virtual private network (VPN) deployment where multiple VPNs use 
    the same private address space, you can use logically identical DHCP 
    address blocks simultaneously on multiple VPNs.
    

EXAMPLES

    nrcmd> dhcp-address-block example1 create 10.10.0.0/16
    nrcmd> dhcp-address-block example1 set policy=p2
    nrcmd> dhcp-address-block example1 show

STATUS

SEE ALSO
    dhcp-subnet

PROPERTIES
  Attributes:

    address[2] (AT_SUBNET, Required, default: <none>)
        Determines the IP subnet address (in the address/mask format) of
        a DHCP address block. This value is defined when you create the
        address block.

    default-subnet-size[3] (AT_INT, Optional, default: 28)
        Sets the default subnet size for allocations from this address
        block.

    deprecated[10] (AT_BOOL, Optional, default: false)
        
        Determines whether the server deactivates a DHCP address block.
        The server ignores a deprecated DHCP address block for new subnet
        allocations. It allows existing clients to renew their subnets, but
        indicates to them that the subnet is deprecated. The client then
        prepares to release the deprecated subnet or subnets back to the
        server.

    embedded-policy[7] (AT_OBJ, Optional, default: <none>)
        Displays the embedded policy object for this DHCP address block.
        Read-only. Use the dhcp-address-block-policy command to set the
        embedded policy.

    name[1] (AT_STRING, Optional, default: <none>)
        Defines the name of the address-block. This value is defined
        when you create the address block.

    policy[6] (AT_NAMEREF(Policy), Required, default: default)
        Identifies the name of the policy associated with this address-block.

    segment-name[8] (AT_STRING, Optional, default: <none>)
        Designates the LAN segment name for this DHCP address block. To group
        multiple, logical IP subnets on a single, physical network, give each
        DHCP address block the same segment-name string. The server ignores
        character case when comparing values.

    selection-tags[9] (AT_STRING, Optional, default: <none>)
        Lists tag strings that are compared with incoming selection tags in
        an allocation request. All tags in the request must match a DHCP
        address blocks selection tags for that block to satisfy the request.
        Separate multiple tags with a comma (do not include commas in tag
        names).

    vpn-id[5] (AT_INT, Optional, default: 0)
        Sets the VPN identifier for the VPN that contains this address-block.

    vpn [] (AT_STRING, Optional, default: <none>)
	This is a "virtual" property.  Use this property to set or
	get the vpn-id by vpn name instead of by id.
