Skip to content

Commit 30670fa

Browse files
authored
Merge pull request #14 from tweedegolf/expand-readme
Expanded readme to better introduce current state of project.
2 parents 5132d4b + 9f70912 commit 30670fa

File tree

1 file changed

+20
-1
lines changed

1 file changed

+20
-1
lines changed

README.md

+20-1
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,22 @@
1+
# Rust implementation of PTP
2+
3+
This repository is work in progress for a rust implementation of PTP version 2.1 (IEEE 1588-2019). It is far from complete and not yet usable in any capacity.
4+
5+
## Rust version
6+
7+
For compiling this software we advise using the latest version of cargo/rustc as available through rustup. At time of writing this is `1.58.1`.
8+
9+
## Running with elevated privileges
10+
11+
Because of the use of ports 319 and 320 in the PTP protocol, the code here needs to be run as root. It is best to build the code as a non-root user with
12+
```
13+
cargo build
14+
```
15+
and then run it as root with
16+
```
17+
sudo ./target/debug/ptp
18+
```
19+
120
## PTPd setup for testing
221

322
PTPd can be used as a ptp master clock for testing. On Ubuntu, it can be installed with
@@ -8,7 +27,7 @@ You probably wont want to run this continuously as a service, so disable it with
827
```bash
928
service ptpd disable
1029
```
11-
Then, to start ptpd, run
30+
Then, to start ptpd, as root run
1231
```bash
1332
ptpd -n -M -i <INTERFACE>
1433
```

0 commit comments

Comments
 (0)