559a0502f1
Implement socket-api `recvmsg()` and `sendmsg()` for wasm app, add sample and update document.
2.0 KiB
"socket-api" sample introduction
This sample demonstrates how to use WAMR socket-api to develop wasm network applications. Two wasm applications are provided: tcp-server and tcp-client, and this sample demonstrates how they communicate with each other.
Preparation
Please install WASI SDK, download the wasi-sdk release and extract the archive to default path /opt/wasi-sdk.
And install wabt, download the wabt release and extract the archive to default path /opt/wabt
Build the sample
mkdir build
cd build
cmake ..
make
iwasm and three Wasm modules, tcp_server.wasm, tcp_client.wasm, send_recv.wasm
will be generated. And their corresponding native version, tcp_server,
tcp_client, send_recv are generated too.
Note that iwasm is built with libc-wasi and lib-pthread enabled.
Run workload
Start the tcp server, which opens port 1234 and waits for clients to connect.
cd build
./iwasm --addr-pool=0.0.0.0/15 tcp_server.wasm
Start the tcp client, which connects the server and receives message.
cd build
./iwasm --addr-pool=127.0.0.1/15 tcp_client.wasm
The output of client is like:
[Client] Create socket
[Client] Connect socket
[Client] Client receive
[Client] 115 bytes received:
Buffer recieved:
Say Hi from the Server
Say Hi from the Server
Say Hi from the Server
Say Hi from the Server
Say Hi from the Server
[Client] BYE
send_recv.wasm contains a thread as a server and a thread as a client. They
send and receive data via 127.0.0.1:1234.
$ ./iwasm --addr-pool=127.0.0.1/0 ./send_recv.wasm
The output is:
Server is online ...
Client is running...
Start receiving.
Start sending.
Send 106 bytes successfully!
Receive 106 bytes successlly!
Data:
The stars shine down
It brings us light
Light comes down
To make us paths
It watches us
And mourns for us
Refer to socket api document for more details.