4.3 Logger Usage

The FCM logger requires that the Router module be loaded and active on the system. See Section 4.1 for information on how to use the Router module. This section will assume that the Router module has been loaded as described in Section 4.1, and also that the Logger has been installed as described in Section 3.

The logger is named rami-logger and is run using this name.

The logger accepts two options, both of which are required. Both options require an argument. The arguments are:

-interval

(Or abbreviated as -i) - (Required) This option specifies the interval at which measurements are made by the logger, and hence the rate at which output is produced. The units are tenths of a second. For example, a value of 10 would mean that a record of output is produced once every second.

-duration

(Or abbreviated as -d) - (Required) This option specifies the length of time over which the logging will take place. Once logging has occurred for this length of time, the logger will exit. The units for the required argument is seconds. For example, a value of 60 would mean that logging lasts for 1 minute (or 60 seconds).

Following the two arguments (which may be specified in either order), a filename must be given. This filename is used for the output file. The user must have permission to open a file of that name for writing. Any data in the file will be erased and a new file created.

For example, to create a log for 1 minute with an interval of 1 second between records, into the file output.nlog the following command would be used:

rami-logger -interval 10 -duration 60 output.nlog

If you wish to read the files written, the format should be fairly self explanatory. Values are separated by spaces.