windows-server-2003/ds/dns/server/dnsperf/readme.txt

//
// README:  PerfMon surport for DNS
//

dns\server\dnsperf:
    dnsperf.ini    //  (copied to 'systme32' dir)
                    //  counter NAMEs & HELPs

    dnsperf.h       //  (copied to 'systme32' dir)
                    //  counter offsets
                    //  public functions to change counter pointers
                    //      e.g. INC, DEC, ADD, SUB
                    //  public counter pointers as 'extern'
                    //  counter version defination:
                    //      DNS_PERFORMANCE_COUNTER_VERSION

    datadns.h       //  # of PerfMon obj: DNS_NUM_PERF_OBJECT_TYPES
                    //  counter data offset
                    //  define: DNS_DATA_DEFINITION
    perfconfig.h
    dnsperf.c       //  to generate dnsperf.dll
                    //  OpenDnsPerformanceData()
                    //  CollectDnsPerformanceData()
                    //  CloseDnsPerformanceData()
                    //
                    //  define datastructure for PerfMon: DnsDataDefinition
                    //  set 'CounterNameTitleIndex' & 'CounterHelpTitleIndex'
                    //    for each counter

    dnsperf.def     // for dnsperf.dll exports

    perfutil.h
    perfutil.c      //  GetQueryType()
                    //  IsNumberInUnicodeList()

dns\server\server:

    startperf.h
    startperf.c     // startPerf() -- called by startDnsServer()
                    // define & set the public counter pointers
                    //   -- accessed by other files to change counter values

    perfconfig.c    // GetConfigParam()

    other files     // may change counter values whereever needed, through:
                    //   public functions & public counter pointers (see dnsperf.h)


//====================================
NT setup:
  copy     dnsperf.ini  dnsperf.h  dnsperf.dll
    to  %windir%\system32\
//====================================


To add new counters for DNS:

    See datadns.h for help.

    Tip -- to view the places to be changed by following the example of
           the first counter, TotalQueryReceived :

        At  dns\server\server :
          type 'qgrep -y TotalQueryReceived *'
        At  dns\server\server :
          type 'qgrep -y TotalQueryReceived *'