dhcp-subnet (nrcmd)					dhcp-subnet (nrcmd)


NAME
    dhcp-subnet - Describes a contiguous range of IP address space
    which the DHCP server has allocated to a client.

SYNOPSIS
    dhcp-subnet <dhcp-subnet-number> [show]
    dhcp-subnet <subnet-number> get <attribute>

    dhcp-subnet <subnet-number> force-available

DESCRIPTION
    The dhcp-subnet commands manipulate subnet objects that the DHCP
    server has leased to its clients. When the DHCP server receives a
    request for a subnet, it creates the subnet by subdividing its
    available address-blocks, and allocating the subnet to the client.

    The dhcp-subnet commands apply only to subnet objects that have
    been allocated to clients by the DHCP server.


EXAMPLES
    dhcp-subnet 10.10.1.0/24 show
 
STATUS

SEE ALSO
    dhcp-address-block

PROPERTIES
  Attributes:

    address[1] (AT_SUBNET, Optional, default: <none>)
        Displays the subnet address, including the mask.

    all-vpns[20] (AT_BOOL, Optional, default: <none>)
        Provides failover configuration information for this subnet.
        If true, this subnet is configured to use the same failover
        configuration for all VPNs. Read only.

    client-domain-name[13] (AT_STRING, Optional, default: <none>)
        Displays the domain name the client specified in its messages (if
        any).

    client-flags[11] (AT_FLAGSINT(), Optional, default: <none>)
        Displays either client-valid or client-id-created-from-mac-address
        (the client ID was created for internal use from the client MAC
        address).

    client-host-name[14] (AT_STRING, Optional, default: <none>)
        Displays the host name that the client specified (if any).

    client-id[10] (AT_BLOB, Optional, default: <none>)
        Displays the client-id of the subnet's client.

    client-last-transaction-time[15] (AT_DATE, Optional, default: <none>)
        Displays the time when the client last contacted the DHCP server.

    client-mac-addr[12] (AT_MACADDR, Optional, default: <none>)
        Displays the MAC address which the client presented to the DHCP
        server.

    expiration[8] (AT_DATE, Optional, default: <none>)
        Displays the expiration time of the subnet binding.

    high-water[4] (AT_INT, Optional, default: <none>)
        Displays the highest utilization level recorded since the last time
        that statistics were retrieved.

    in-use-addresses[2] (AT_INT, Optional, default: <none>)
        Displays the number of addresses currently being used by hosts.

    last-transaction-time[9] (AT_DATE, Optional, default: <none>)
        
        Displays the time at which the client last communicated with the
        server about this subnet. Read only.

    relay-agent-option[18] (AT_BLOB, Optional, default: <none>)
        Displays the contents of the relay agent information option from
        the most recent client interaction. Read only.

    selection-tags[19] (AT_STRING, Optional, default: <none>)
        Displays the selection-tag string that the client presented when
        it last leased or renewed the subnet binding. Read only.

    state[6] (AT_ENUMINT(), Optional, default: <none>)
        Displays the state of the subnet.

    unusable-addresses[3] (AT_INT, Optional, default: <none>)
        The number of addresses marked unusable.

    vpn-id[5] (AT_INT, Optional, default: 0)
        Identifies the VPN that contains this subnet.

