[ Table Of Contents | Keyword Index ]

ns_adp_stats(n) 4.99 "NaviServer Built-in Commands"

NAME

ns_adp_stats - Return statistics about cached ADP pages

TABLE OF CONTENTS

    TABLE OF CONTENTS
    SYNOPSIS
    DESCRIPTION
    COMMANDS
    EXAMPLES

SYNOPSIS

ns_adp_stats
dev
ino
mtime
refcnt
evals
size
blocks
scripts

DESCRIPTION

Returns statistics about ADP pages that have been cached. The result is a list of lists, where each sublist contains 2 items: File, Statistics. File is the complete path in the file system to a cached adp file, Statistics is a list containing statistics about that cached file in a format similar to Tcl's array get format. Currently, the keys in Statistics are:

COMMANDS

ns_adp_stats
dev
Drive number of the disk containing the file.

ino
Number of the information node (the inode) for the file. The inode describes the file date and time stamps, permissions, and content on UNIX file systems.

mtime
Time the file was last modified,

refcnt
Reference Count, the adp will be removed from the cache if this reaches zero.

evals
Number of times this adp has been evaluated.

size
Size of the file in bytes.

blocks
Total number of blocks in the adp file, including html blocks and script blocks.

scripts
Number of script blocks in the adp file.

EXAMPLES

 
   % foreach {file stats} <strong>ns_adp_stats</strong> {
         append output "\nFILE: ${file}\n"
         foreach {key value} $stats {
             append output "    ${key} ==> ${value}\n"
         }
     }
     set output

See stats.tcl in the standard NaviServer distribution for a more complicated example.

NOTES On the Windows platform, adp filenames are used as Hash table keys instead of dev and ino, so dev and ino will always be reported as 0 when running NaviServer on Windows.