gnh1201/wasm-micro-runtime
1
0
Fork 0
mirror of https://github.com/bytecodealliance/wasm-micro-runtime.git synced 2025-05-08 12:46:14 +00:00
Code Issues Actions 9 Packages Projects Releases Wiki Activity

Update socket API samples doc to cover UDP client/server and addr_resolve samples (#1538)

Browse Source 
Also fix installing `addr_resolve.wasm` example.

Resolves #1534
This commit is contained in:
Marcin Kolny 2022-09-29 11:16:16 +01:00 committed by GitHub
parent 2a5451a35c
commit dc2c6c75f5
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 62 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
samples/socket-api/CMakeLists.txt
View File

@ -87,6 +87,7 @@ ExternalProject_Add(wasm-app
${CMAKE_CURRENT_SOURCE_DIR}/wasm-src ${CMAKE_CURRENT_SOURCE_DIR}/wasm-src
BUILD_COMMAND ${CMAKE_COMMAND} --build . BUILD_COMMAND ${CMAKE_COMMAND} --build .
INSTALL_COMMAND ${CMAKE_COMMAND} -E copy INSTALL_COMMAND ${CMAKE_COMMAND} -E copy
addr_resolve.wasm ${CMAKE_BINARY_DIR}
tcp_client.wasm ${CMAKE_BINARY_DIR} tcp_client.wasm ${CMAKE_BINARY_DIR}
tcp_server.wasm ${CMAKE_BINARY_DIR} tcp_server.wasm ${CMAKE_BINARY_DIR}
send_recv.wasm ${CMAKE_BINARY_DIR} send_recv.wasm ${CMAKE_BINARY_DIR}

64
samples/socket-api/README.md
View File

@ -18,14 +18,21 @@ cmake ..
make make
``` ```
`iwasm` and three Wasm modules, `tcp_server.wasm`, `tcp_client.wasm`, `send_recv.wasm` `iwasm` and the following Wasm modules (along with their corresponding native version) will be generated:
will be generated. And their corresponding native version, `tcp_server`, * `addr_resolve.wasm`, `addr_resolve`
`tcp_client`, `send_recv` are generated too. * `send_recv.wasm`, `send_recv`
* `socket_opts.wasm`, `socket_opts`
* `tcp_client.wasm`, `tcp_client`
* `tcp_server.wasm`, `tcp_server`
* `udp_client.wasm`, `udp_client`
* `udp_server.wasm`, `udp_server`
> Note that iwasm is built with libc-wasi and lib-pthread enabled. > Note that iwasm is built with libc-wasi and lib-pthread enabled.
## Run workload ## Run workload
### TCP client/server
Start the tcp server, which opens port 1234 and waits for clients to connect. Start the tcp server, which opens port 1234 and waits for clients to connect.
```bash ```bash
@ -82,6 +89,8 @@ Data:
And mourns for us And mourns for us
``` ```
### Socket options
`socket_opts.wasm` shows an example of getting and setting various supported socket options `socket_opts.wasm` shows an example of getting and setting various supported socket options
```bash ```bash
$ ./iwasm ./socket_opts.wasm $ ./iwasm ./socket_opts.wasm
@ -98,4 +107,53 @@ SO_RCVTIMEO tv_usec is expected
[Client] Close sockets [Client] Close sockets
``` ```
### Domain name server resolution
`addr_resolve.wasm` demonstrates the usage of resolving a domain name
```
$ ./iwasm --allow-resolve=*.com addr_resolve.wasm github.com
```
The command displays the host name and its corresponding IP address:
```
Host: github.com
IPv4 address: 140.82.121.4 (TCP)
```
### UDP client/server
Start the UDP server, which opens port 1234 and waits for clients to send a message.
```bash
cd build
./iwasm --addr-pool=0.0.0.0/15 udp_server.wasm
```
Start the tcp client, which sends a message to the server and waits for the response.
```bash
cd build
./iwasm --addr-pool=127.0.0.1/15 udp_client.wasm
```
The output of client is like:
```bash
[Client] Create socket
[Client] Client send
[Client] Client receive
[Client] Buffer recieved: Hello from server
[Client] BYE
```
The output of the server is like:
```
[Server] Create socket
[Server] Bind socket
[Server] Wait for clients to connect ..
[Server] received 17 bytes from 127.0.0.1:60927: Hello from client
```
## Documentation
Refer to [socket api document](../../doc/socket_api.md) for more details. Refer to [socket api document](../../doc/socket_api.md) for more details.