You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+44-1Lines changed: 44 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,6 +6,37 @@
6
6
# LCL CLI
7
7
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.
8
8
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
+
9
40
## Usage
10
41
11
42
```
@@ -25,7 +56,19 @@ SUBCOMMANDS:
25
56
cellular-sites Get info on SCN cellular sites
26
57
27
58
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):
0 commit comments