NaviServer - programmable web server


[ Main Table Of Contents | Table Of Contents | Keyword Index ]

ns_adp_stats(n) 4.99.8 naviserver "NaviServer Built-in Commands"

Name

ns_adp_stats - Return statistics about cached ADP pages

Table Of Contents

Synopsis

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.