Copyright ARM Ltd 2011
$Rev: 172664 $: 
$Date: 2011-11-24 15:41:02 +0000 (Thu, 24 Nov 2011) $:
$Author: lizhar01 $:
$URL: http://cam-svn1.cambridge.arm.com/svn/devsys/rvct/peglib/trunk/licensing/utilities/timestampscanner/customer_instructions.txt $:
$Id: customer_instructions.txt 172664 2011-11-24 15:41:02Z lizhar01 $:

 
About TimeStampScanner
------------------------
To identify such problem files, please use the timestampscanner utility that I have attached to this email.  

Note that this utility is license managed, though it will run on any machine during the time that the included license for it is valid. This is solely because it is not something we want becoming too widely available.

Description of Use
-------------------
To use the tool, extract the files into a temporary directory, open a command line interface at that directory.

Setting up for Linux
--------------------
If you are using csh or tcsh, you can set the environment variable for a single server as follows:

  setenv ARMLMD_LICENSE_FILE ./clockchecker.lic

If you are using bash or sh, an example would be:

  ARMLMD_LICENSE_FILE=./clockchecker.lic
  export ARMLMD_LICENSE_FILE

Setting up for Windows
-----------------------
Set the environment variable for a the license file as follows:

  set ARMLMD_LICENSE_FILE=./clockchecker.lic  
  
Running timestampscanner
-------------------------
Run the timestampscanner executable, including any supported options if required:

  ./timestampscanner [...]

To obtain a list of options enter:

  ./timestampscanner --help

Once run, the timestamp checker looks for files with future timestamp and flags these up.

If it does detect a problem file then you will get an error message in the output reporting the file name in the form:

  Bad file: <<filename>>

Fixing Bad Time Stamps
-----------------------
On Linux, in order to correct the problem, you will need to use the "touch" command to modify the timestamp dates of the flagged files.

On Windows, there are many programs available on the net that can do this under Windows. For example 
a quick google just identified the following program

  http://www.3d2f.com/programs/24-874-express-timestamp-toucher-download.shtml

[though note that we have not tested these.]

Note that it is quite possible that some of these touch tool will only set the modified time. 
Some touch utilities also allow you to set the created/accessed dates too.

Note that you can see all three of these timestamps in a Windows Explorer window. If you right 
click on the title bar at the top of a directory display, this allows you to select "Date 
created" and also, using the "More.." entry, "Date accessed".  This may help to identify which 
timestamp is actually causing the problem for the licensing system.
