6.1 Queue Information File Format

To assist in collection of statistics about the queue, a file will be created by the FCM Router module in the /proc filesystem. Such a file is not actually a file on disk, but instead provides easy access to information contained within the kernel module.

The file must provide the following information:

1. A unique identifier for the queue
2. Current queue size in packets
3. Current queue size in Bytes
4. Current value for $p(q)$
5. Number of packets which have passed through
6. Number of packets which have been modified
7. The maximum transmission rate as given to the module
8. The value of $b$ as given to the module
9. The value of $q_{\rm min}$ as given to the module
10. The maximum size of the queue, in Bytes

In keeping with Linux conventions for files in the /proc filesystem, the file will be a plain text file which is human readable. The file will be named fcm_queue and will be found in the directory net of the proc filesystem. Typically this will mean the file is found as /proc/net/fcm_queue.

The file will contain a header line, and then one line for every instance of the queue which has been created. If the module has been loaded, but not used, then there will simply be a header line.

6.1.1 Example

An example of the file follows:

id queue_packets queue_bytes p(q) packets_passed packets_modified maxrate bval
q_min limit
0 3 34234 23 56222 53822 10000 10 30 150000

6.1.2 Grammar

file -> header, line*, EOF
header -> field+, newline
line -> values+
values -> integer+
newline -> '\n'