@statEntry(FSNAME, [SHOW], [ATTRS])

Insert server file system entry which you would like to have "stat" information available.

The following parameters are recognized:

FSNAME

File system name (like: "/etc/hosts" or "/home").

[SHOW]

What to present in the HTML output (if omitted, we used FSNAME).

[ATTRS]

Any additional attributes (other than "class" or "title") you would like to include.

This macro is intended to be used when one wants to insert the name of a file or directory (any file system entry) which exists on the server. The HTML is inserted in a manner such that if one loads the "stat.js" JavaScript file and using the NstDom class to span enhance the page, the user should be able to get lots of useful information when they click on the filename. NOTE: This only works for files which the web server can "stat".

Example of using the macro:

@p("Check the @statEntry("/etc/hosts") file
and the @statEntry("/etc/sysconfig/network-scripts") directory.")

Assuming the com.ccg.macros.at.All class is within your CLASSPATH and the config/html.at macros file has been generated (Hint: run make atmacros in the wui directory), a developer should be able to run the above example by copy/pasting from below:

[root@probe root]# java com.ccg.macros.at.All <<EOF
@include("config/html.at",,"d")
@p("Check the @statEntry("/etc/hosts") file
and the @statEntry("/etc/sysconfig/network-scripts") directory.")
EOF

This macro is defined as:

<span@htmlAttr("class","stat")@htmlAttr("title","@param(0)")@ifEqual("@param(2)",,," @param(2)")>@fnb("@param(1)","@param(0)")</span>