Skip to content

Commit 3b30664

Browse files
infrared0johnnzhou
andauthored
Update README.md (#7)
Co-authored-by: Zhennan Zhou <[email protected]>
1 parent 90e8752 commit 3b30664

File tree

1 file changed

+44
-1
lines changed

1 file changed

+44
-1
lines changed

README.md

Lines changed: 44 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,37 @@
66
# LCL CLI
77
LCL CLI is a cross-platform cli tool written in Swift. It is designed to measure the network performance and latency through LCL's cellular network measurement testbed. While this tool is design for Local Connectivity Lab researchers and Seattle Community Network volunteers and users, everyone is welcome to use this tool to measure their network performance.
88

9+
## Build
10+
11+
### Dev version
12+
To contribute to the tool, make sure you have docker installed.
13+
14+
Run
15+
```
16+
make dev
17+
```
18+
to drop into the toolchain coontainer, which includes all the dependencies required by the tool.
19+
To build the _debug_ version, simply run `swift build` or `make build-test`. The debug binary will be placed under `.build/debug` directory.
20+
21+
### Release version
22+
To build the release version of the tool, make sure you have docker installed.
23+
24+
On Linux, make sure the systemd service is running.
25+
Then run:
26+
27+
```
28+
./scripts/build_release.sh ubuntu
29+
```
30+
31+
(or debian or macos, depending on your system).
32+
33+
When the build is complete, go into the "release" folder and run the executable as instructed. For example:
34+
35+
```
36+
./lcl-cli-1.0.4-x86_64-ubuntu
37+
```
38+
will print out the help text for arguments that can be added.
39+
940
## Usage
1041

1142
```
@@ -25,7 +56,19 @@ SUBCOMMANDS:
2556
cellular-sites Get info on SCN cellular sites
2657
2758
See 'lcl help <subcommand>' for detailed help.
28-
```
59+
```
60+
### Examples
61+
Run the following to do an icmp ping test (may not work on some linux systems due to permissioning):
62+
63+
```./lcl-cli-1.0.4-x86_64-ubuntu ping icmp --host 1.1.1.1```
64+
65+
Run the following to do a HTTP-based test:
66+
67+
```./lcl-cli-1.0.4-x86_64-ubuntu ping http --url https://www.google.com```
68+
69+
Run the following to do a download speedtest (upload and both ul/dl are possible):
70+
71+
```./lcl-cli-1.0.4-x86_64-ubuntu speedtest --type download```
2972

3073
## Features
3174
- ICMP and HTTP test with `Server-Timing` support.

0 commit comments

Comments
 (0)