List File Events


NSS volumes keep track of files that have changed during an interval called an Epoch. The file list was originally called a Modified File List (MFL). However, the MFL did not account for changes to metadata. The MFL has been deprecated and the EFL (Event File List) is the current way to track changed files, which includes changes to metadata. This perl script uses the listFileEvents API to list the modified files.

This tool will print a list of files on an NSS volume that have changed during a specified EFL Epoch. It uses the Virtual File Services (Originally called Virtual File Services for NetWare) which were ported over to Linux. The SDK for this API set can be downloaded from The objective of the tool is to add a trustee to a file using XML as specified in the VFS for NetWare specification. It is intended to be used as a sample script for developers that may want to use the VFS API set to view and manage storage.

How to Use the file: is a Perl Script. So Perl must be installed and running on the Linux server that this file is being loaded on. NSS must be installed to get the VFS support. RELATED: Other EFL Utilities include linuxListEpochs, linuxStartEventEpoch, linuxStoptEventEpoch, and linuxListAllFiles.

To run the perl script type:

perl VOLUME_NAME <enter>

Where VOLUME_NAME is the name of the NSS volume where the active EFL Epoch is to be stopped.

The user will be prompted to type in one of the 37 digit Epoch Numbers displayed above the prompt. Type in one of the active Epochs or the utility will fail, then press enter.

Example: perl VOL1 <enter>

A sample output would be the following:

grep57:/a # perl NSS1
file is now open </_admin/Manage_NSS/Volume/NSS1/FileEvents.xml
<epoch value="4468a904-7f08-01db-80-00-993f4a82c9da"/>
<epoch value="e5d831be-7680-01db-80-00-bd1cd5b47e57"/>
<epoch value="4468a904-7f08-01db-80-00-993f4a82c9da"/>
<result value="0"><description>success</description></result>

Choose an epoch and type in the complete 37 letter code including dashes.

<nssRequest><fileEventList><listFileEvents epochNumber="4468a904-7f08-01db-80-00-993f4a82c9da"/></fileEventList></nssRequest>
<result value="0"><description>zOK</description></result>

The specifications explain the XML tags.


How To-Best Practice
Comment List
Related Discussions