Skip to content

Commit 552903d

Browse files
committed
add: [doc] README
1 parent 6591d9f commit 552903d

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

README.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Main features
2+
3+
**d4-pyclient** is python implemention of the [D4 encapsulation
4+
protocol](https://github.com/D4-project/architecture/tree/master/format).
5+
6+
It is a low-barrier entry for anyone interested into tinkering with the D4
7+
protocol or embedding a d4 client into another project. It supports both regular
8+
types and types defined by meta-header.
9+
10+
# Launching
11+
12+
```shell
13+
./d4-pyclient.py -h
14+
usage: d4-pyclient.py [-h] -c CONFIG [-cc]
15+
16+
optional arguments:
17+
-h, --help show this help message and exit
18+
-c CONFIG, --config CONFIG
19+
config directory
20+
-cc, --check_certificate
21+
check server certificate
22+
```
23+
24+
# Configuration Files
25+
26+
of the client configuration can be stored in folder containing the following files:
27+
28+
- key: your Pre-Shared-Key
29+
- snaplen: default is 4096
30+
- source: stdin or d4server
31+
- destination: stdout, [fe80::ffff:ffff:ffff:a6fb]:4443, 127.0.0.1:4443
32+
- type: D4 packet type, see [types](https://github.com/D4-project/architecture/tree/master/format)
33+
- uuid: generated automatically if empty
34+
- version: protocol version
35+
- rootCA.crt: optional : CA certificate to check the server certificate
36+
- metaheader.json: optional : a json file describing feed's meta-type [types](https://github.com/D4-project/architecture/tree/master/format)

0 commit comments

Comments
 (0)