[tor-commits] [pluggable-transports/snowflake] 26/31: Add document for LoadBridgeInfo input

[gitolite role]

This is an automated email from the git hooks/post-receive script.

shelikhoo pushed a commit to branch main
in repository pluggable-transports/snowflake.

commit 8ba89179f1f862a4957ed28a88b6a08167b653e9
Author: Shelikhoo <xiaokangwang at outlook.com>
AuthorDate: Wed May 18 14:11:35 2022 +0100

    Add document for LoadBridgeInfo input
---
 broker/bridge-list.go | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/broker/bridge-list.go b/broker/bridge-list.go
index 8a80f6a..4433a12 100644
--- a/broker/bridge-list.go
+++ b/broker/bridge-list.go
@@ -1,3 +1,24 @@
+/* (*BridgeListHolderFileBased).LoadBridgeInfo loads a Snowflake Server bridge info description file,
+   its format is as follows:
+
+   This file should be in newline-delimited JSON format(https://jsonlines.org/).
+   For each line, the format of json data should be in the format of:
+   {"displayName":"default", "webSocketAddress":"wss://snowflake.torproject.net/", "fingerprint":"2B280B23E1107BB62ABFC40DDCC8824814F80A72"}
+
+   displayName:string is the name of this bridge. This value is not currently used programmatically.
+
+   webSocketAddress:string is the WebSocket URL of this bridge.
+   This will be the address proxy used to connect to this snowflake server.
+
+   fingerprint:string is the identifier of the bridge.
+   This will be used by a client to identify the bridge it wishes to connect to.
+
+   The existence of ANY other fields is NOT permitted.
+
+   The file will be considered invalid if there is at least one invalid json record.
+   In this case, an error will be returned, and none of the records will be loaded.
+*/
+
 package main
 
 import (

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.