# @(#)83        1.1  src/tcpip/usr/samples/tcpip/dhcpv6/dhcpsdv6.cnf, tcpip_samples, tcpip720 4/13/04 10:00:07
# IBM_PROLOG_BEGIN_TAG 
# This is an automatically generated prolog. 
#  
# tcpip720 src/tcpip/usr/samples/tcpip/dhcpv6/dhcpsdv6.cnf 1.1 
#  
# Licensed Materials - Property of IBM 
#  
# Restricted Materials of IBM 
#  
# COPYRIGHT International Business Machines Corp. 2004 
# All Rights Reserved 
#  
# US Government Users Restricted Rights - Use, duplication or 
# disclosure restricted by GSA ADP Schedule Contract with IBM Corp. 
#  
# IBM_PROLOG_END_TAG 
# This file contains the directive that can be specifed by the user to configure
# the server.
# 
# Comment Syntax:
#
# '#', '//' is considered a comment line and the text to the right of the symbol
# ignored.
# /**/ cannot be nested, but is allowed to span multiple lines
#
# units - seconds, minutes, hours, weeks, months, years
#
# I. Logging
# Keyword               Value           Definition
# -------------------------------------------------------------------------------
# logging_info { <log_options> }        This stanza is not required to exist but if
#                                       present must be at the top of the configuration
#                                       file.
# <log_options> 
# logFileSize           0-n             size of the log file in kilobytes
# logFileName           ?filenme        name of the log file
# numLogFiles           0-n             number of log files for file rotation
# logItem                               types of logging interested in, can have more then
#                                       one instance of this stanza
#                       SYSERR  
#                       OBJERR  
#                       PROTERR 
#                       WARNING 
#                       EVENT           
#                       ACTION  
#                       INFO            
#                       ACNTING 
#                       TRACE
#
#II. Global Keywords - only valid outside of a container
#
# UsedIpAddressExpiredInterval  0-n [units]     Specifies how often addresses
#                                       placed in the BAD state are recouped and
#                                       retested for validity. If units is
#                                       not set, default to seconds.
#
# StatisticSnapShot     0-n [units]     Specifies how often statistics
#                                       are written to the log file in
#                                       seconds. If units is not set, we default to
#                                       seconds.
#
# leaseExpiredInterval  0-n [units]     Specifies how often addresses in
#                                       the BOUND state are checked to
#                                       see if they have expired. If the
#                                       address has expired, the state is moved to
#                                       EXPIRED.  If units is not set, we
#                                       default to seconds.
#
# reservedTime          0-n [units]     Specifies how long addresses should sit in
#                                       RESERVED state before being recouped into the
#                                       FREE state. If units is not set, we default to
#                                       seconds.
#
# reservedTimeInterval  0-n [units]     Specifies how often addresses in thei RESERVE
#                                       state are checked to see if they should be
#                                       recouped into the FREE state. If units is not
#                                       set, we default to seconds.
#
# saveInterval          0-n [units]     Specifies how often the DHCP server should
#                                       force a save of the open databases. For heavily
#                                       loaded servers, this should be 60 or 120
#                                       seconds. If units is not set, we default to
#                                       seconds.
#
# clientpruneintv       0-n [units]     Specifies how often the DHCP server has the
#                                       databases remove clients are not associated
#                                       with any address (in the UNKNOWN state). This
#                                       reduces the memory use of the DHCP server.
#                                       If units are not set, we default to seconds.
#
# numprocessthreads     1-n             Specifies the number of packet processors
#                                       threads to create. Minimum of one. Each
#                                       processthread handles one client. By default
#                                       it is 30.
#
# numpacketthreads      1-n             Specifies the number of packet threads to create.
#                                       Minimum of one, by default it is set to 5
#
# numloggingthreads     1-n             Specifies the number of logging threads. Default
#                                       is 1.
#
# numduidbuckets        1-n             This is used by the table manager, and has a
#                                       direct correlation to the numprocessthreads. By
#                                       default, we set this to 53.
#
# numclientbuckets      1-n             How many buckets will we have to store the client
#                                       records
#
# ignoreinterfacelist { interface interface } ignore these interfaces
#
# backupfile            "filename"      Specifies the file to use for database backups.
#

# checkpointfile        "filename"      Specifies the database checkpoint files. The
#                                       first checkpoint file is the path. The second
#                                       checkpoint file is path with the last character
#                                       replaced with a 2. So, the checkpoint file
#                                       should not end in 2. 
#
# clientrecorddb        "filename"      Specifies the database save file. The file
#                                       contains all the client records the DHCP server
#                                       has serviced.
#
#
# duid                                  duid of the server
#                       <1> <interface>
#                       <2> <enterprise number> <identifier>
#                       <3> <interface>
#                       <0,... , values > 3 > <identifier>
#
# preference-number     0-255           The preference number, allows the clients to
#                                       identify the server it prefers to obtain
#                                       information from. The higher the value, the
#                                       greater the chance the client will use this
#                                       server for it's services. Num <= 255
#
# unicast-enable        policy          unicast policy for the server, this allows the
#                                       server to communicate using unicast
#
# tablemgr-policy       policy          allows the server to have a table manager to
#                                       better manage incoming clients.

#
# III. NON-NESTED CONTAINER STATEMENTS
#                                       Can only exist as part of the GLOBAL KEYWORDS
# subnet subnetid prefix-length [range]{OPTIONS}
#                                       subnet to be used
#
# subnetid              ipv6 address    ipv6 address used to identify the subnet
# prefix-length         0 - n           n <  128, the part of the subnetid that
#                                       will be mask with big endian
# default                               create a default subnet
#
# IV.NESTED CONTAINER STATEMENTS
#                                       Can only exist as an option inside subnet.
#                                       All containers can have other containers nested
#                                       within it unless otherwise stated.
#                                       The maximum depth of nesting is seven, including
#                                       subnet.  Vendor containers cannot have any other
#                                       containers nested within it.
#
# class name [range] { OPTIONS|COMMON OPTIONS}

#                                       class container
#
# vendor name [range] { OPTIONS | COMMON OPTIONS }
#                                       vendor container
# name:                                 one string, space seperated strings, regular
#                                       expression, hex 0xabc, 0xabc
#
# client <duid|0 hex|regular expression> <ip|range|none|any>  { OPTIONS|COMMON OPTIONS }
#                                       client container
#
# inoption icode keytomatch [range]     inoption container
#                       icode           the incoming option code or number to be
#                                       specified by the client
#                       keytomatch      the option data to be matched against.
#                                       <hex|string|regexp>

# V. OPTION 
#                                       These keywords can only exist inside a container.
# exclude               range           ip range to exclude from the current range
# exclude               ip              ip address to exclude from the current range
# range                 range           ip range use to extend the current range
# range                 ip              ip address to add, used to extend the range

# stealfromchildren     policy          steal address from children containers if all
#                                       addresses are exhausted
# steafrompeer          policy          steal addresses from peer containers if all
#                                       addresses are exhausted
# steafromparent        policy          steal addresses from parent containers if all
#                                       addresses are exhausted
#
# balance-option { balance-policy | <option | option option ...>}
#                                       balance options container, options specified
#                                       within this container will be given to the
#                                       clients base on the policy. This keyword can
#                                       only exist under the subnet container.
# balance-policy        b_policy        b_policy can be fill, or rotate
#
# interface-id          "interface"     this can only be listed under subnet. Clients
#                                       requests received on this interface will be
#                                       allowed to obtain addresses.
#
# VI. COMMON OPTIONS
#                                       These can exist inside the containers or
#                                       outside in the global section
#
# reconfig-policy       policy          allows the container, or if globaly set, the
#                                       server to send recofig message to the client
#
# rapid-commit          policy          allows for the server to do rapid commit for
#                                       the container or globably set.
#
# prefered-lifetime     0-n [units]     the prefered lifetime of the IANA or IATA
# valid-lifetime        0-n [units]     the valid lifetime of the IANA or IATA
# rebind-percent        0-n             T1, the rebind time percent 0-100 for the address
# renew-percent         0-n             T2, the renew time percent 0-100 for the address
# unicast-option        policy          allows a containers to offer message exchange by
#                                       unicasting, this can use used to turn on/off
#                                       individual containers and subnets even if the
#                                       server policy differs.
#
# option [string|hex]
#                                       similar to dhcpv4 options
# change-optiontable    optiontable     only allowed within a vendor container
#
# optiontable:
# undefined currently
#
# supportUnlistedClients        policy 
#                                       support unlisted clients
# appenddomain          policy          append domain names for non-FQDN clients
# proxyarec             proxy_policy    Specifies what options and methods should be
#                                       used for A record updates in the DNS. never
#                                       means never update the A record.
#
# addressassigned       "string"        what to log when an address is assigned to a
#                                       client
# addressreleased       "string"        what to log when an address is released
# releasednsA           "string"        execute a release of the A record
# releasednsP           "string"        execute a release of the PTR record
# updatednsa            "string"        execute an update of the A record
# updatednsp            "string"        execute an update of the A record

# hostnamepolicy         h_policy       Specifies which hostname to return to the
#                                       client. Default policy is to prefer the defined
#                                       hostname and domain name over suggested names.
#                                       Other policies imply strict adherence
#                                       (for example: defined will return the
#                                       defined name or none if no name is defined
#                                       in the configuration). Also, policies using
#                                       the always modifier will dictate the server
#                                       to return the hostname option regardless of
#                                       whether the client requested it through the
#                                       parameter list option. 
#
# rapid-commit-percentlease     0-n     n < 100, how long to give out an address when
#                                       rapid commit is in place
#units:
#------
#second
#seconds
#minute
#minutes
#hour
#hours
#day
#days
#week
#weeks
#month
#months
#year
#years 
#
#interface:
#----------
#en0 en1 tr0
#
#identifier:
#numbers or characters
#
#policy:
#-------
#yes
#no
#true
#false
#
#range:

#------
#ipv6addresss-ipv6addresss
#
#regular expression:
#--------------------
#"!epressiong to match$"
#"!epressiong to match^"
#
#proxy_policy:
#-------------
#never 
#usedhcpddns
#usedhcpddnsplus
#always
#usedhcpddnsprotected
#usedhcpddnsplusprotected
#alwaysprotected
#standard
#protected 
#
#h_policy:
#---------
#suggested
#resolved
#always_resolved
#defined
#always_defined
#default