| Weiwei Liu | 4f1afac | 2016-04-02 19:08:38 -0700 | [diff] [blame] | 1 | # Face Benchmark |
| 2 | |
| 3 | **face-benchmark** is a program to test the performance of the face system. It runs |
| 4 | on a node between n consumer nodes and n producer nodes. It creates a left face and |
| 5 | a right face for each pair of consumer node and producer node respectively. The left |
| 6 | and right faces in each pair are tied to each other at the Interest/Data/Nack layer, |
| 7 | which means that anything received on the left face is sent to the corresponding |
| 8 | right face, and anything received on the right face is sent to the corresponding |
| 9 | left face. The program passively waits for an incoming connection from one side which |
| 10 | triggers an outgoing connection to the other side. The FacePersistency is set to |
| 11 | "on-demand" for all incoming faces, and "persistent" for all outgoing faces. |
| 12 | |
| 13 | The FaceUris for each face pair can be configured via a configuration file. Each |
| 14 | line of the configuration file consists of a left FaceUri and a right FaceUri |
| 15 | separated by a space. FaceUri schemes "tcp4" and "udp4" are supported. The left face |
| 16 | and right face are allowed to have different FaceUri schemes. All FaceUris MUST be |
| 17 | in canonical form. |
| 18 | |
| 19 | Usage example: |
| 20 | |
| 21 | 1. Configure FaceUris in `face-benchmark.conf` |
| 22 | 2. On the router node, run `./face-benchmark face-benchmark.conf` |
| 23 | 3. Run NFD on the consumer/producer node pairs |