---
name: "wiplcExec"
section: "1"
platform: "linux"
package: "wipl-client-exec"
version: "20020601-11.3"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/wiplcExec"
---

# wiplcExec(1)

Execute programs written in the wipl programming language

## NAME

wiplcExec - Execute programs written in the wipl programming language

## SYNOPSIS

**wiplcExec \[ -d daemonfile \] \[ -f file \| -e statements \]**

## DESCRIPTION

This programs will connect to the **wipld** daemon and execute a program written in the **wipl programming language** as described in **[wipllang(5)](/wipllang/5.md).**

## OPTIONS

- **-d daemonfile --daemon=daemonfile**

  Connect to the daemon through the file **daemonfile**

- **-e statements --eval=statements**

  Set the program to execute to the content of the **statements** parameter.

- **-f file --file=file**

  Read the program to execute from the file **file.** If neither the **-e** nor the **-f** parameter is given the program is tried read from stdin.

- **-r --readonly**

  If this option is given the client will not try to obtain write access to the shared memory area.

## EXAMPLES

NOTE: Some of the following examples assumes that you are running **wipld** in MAC based addressing mode. If you are running it in IP based addressing the examples need to be modified.

To delete all entries from the table you can use the following program:

```
int a=TBLcardcnt()-1;
while(a>=0) {
  TBLidxdel(a);
  a=a-1;
}
```

The following program will set the value of counter 0 for the MAC address  **11:22:33:44:55:66** to 42K:

```
11:22:33:44:55:66[0]=42*1024;
```

This can be used to set values based on other sources than the packets seen by **wipld.** To delete this card from the list use:

```
TBLidxdel(TBLgetidx(11:22:33:44:55:66));
```

To print the value of counter 0 for the the netcard with MAC address **11:22:33:44:55:66** as an unsigned 32 bit integer use:

```
prints(11:22:33:44:55:66[0]);
```

To print the sum of counter 1 for all the cards in the table as an unsigned 32 bit integer use:

```
int i=TBLcardcnt()-1;
int result=0;
while(i>=0) {
  result+=TBLgetmacaddr(i)[1];
  i=i-1;
}
prints(result);
```

The two examples above are useful to feed other programs with the  counter values. An example of such other program is the **mrtg** (Multi Router Traffic Grapher) program by Tobias Oetiker and Dave Rand, homepage  **http://ee-staff.ethz.ch/~oetiker/webtools/mrtg/mrtg.html.** The  **mrtg** program can be used to create nice graphs based on the counters.

I will finish with an example that is bit more complicated. The following program  **A** will print a program  **B** so that when **wiplcExec** is run on **B** the counters will be set to the values they had when **A** was run. This can be used to save the counters and restore them later:

```
#!/usr/bin/wiplcExec -f
// Print program that deletes all the current cards:
print("int card=TBLcardcnt()-1;\n");
print("while(card>=0) {        \n");
print("  TBLidxdel(card);      \n");
print("  card=card-1;          \n");
print("}                       \n");
// And print program that sets all the counters:
int card=TBLcardcnt()-1;
while(card>=0) {
  int cnt=TBLcntcnt()-1;
  while(cnt>=0) {
    maca ma=MACgetmacaddr(card);
    print(ma); print("["); prints(cnt); print("]=");
    print(ma[cnt]); print(";");
    cnt=cnt-1;
  }
  card=card-1;
  print("\n");
}
```

If this program is put to a file named **A** the following command will save the counters to the file **B:**

```
cat A | wiplcExec > B
```

And the following program will restore the counters:

```
cat B | wiplcExec
```

Note that the command:

```
cat A | wiplcExec | wiplcExec
```

Will not deadlock. This is because **wiplcExec** always reads the whole program before it starts executing it. Also refer to  **BUGS** below.

## FILES

**/etc/wipld.conf**

Default daemonfile.

## BUGS

The shared memory area with the counters is locked as long as the program executes. So if the output is piped to a program which only consumes the data very slowly the memory area might be locked for so long that packets are dropped by the **wipld** program. In such a situation you might want to write the output of **wiplcExec** to a file and then pipe the contest of this file to the other program afterwards.

Programs must have write permission to the statistics, even if they don't modify them. See **[wipld(8)](/wipld/8.md)** for information about how to set the permissons.

## SEE ALSO

**[wipl(1)](/wipl/1.md),** **[wipllang(5)](/wipllang/5.md)**