From 9de6c5ed69c09fb3340acb6dfe5999679bccd9a4 Mon Sep 17 00:00:00 2001 From: Syncthing Release Automation Date: Mon, 15 Sep 2025 03:52:28 +0000 Subject: [PATCH] chore(gui, man, authors): update docs, translations, and contributors --- gui/default/assets/lang/lang-be.json | 1 + gui/default/assets/lang/lang-et.json | 48 ++++-- gui/default/assets/lang/lang-fr.json | 4 +- gui/default/assets/lang/lang-he-IL.json | 2 + man/stdiscosrv.1 | 2 +- man/strelaysrv.1 | 2 +- man/syncthing-bep.7 | 2 +- man/syncthing-config.5 | 2 +- man/syncthing-device-ids.7 | 2 +- man/syncthing-event-api.7 | 2 +- man/syncthing-faq.7 | 2 +- man/syncthing-globaldisco.7 | 2 +- man/syncthing-localdisco.7 | 2 +- man/syncthing-networking.7 | 2 +- man/syncthing-relay.7 | 5 +- man/syncthing-rest-api.7 | 2 +- man/syncthing-security.7 | 2 +- man/syncthing-stignore.5 | 2 +- man/syncthing-versioning.7 | 2 +- man/syncthing.1 | 203 +++++++++++++++--------- 20 files changed, 193 insertions(+), 98 deletions(-) diff --git a/gui/default/assets/lang/lang-be.json b/gui/default/assets/lang/lang-be.json index 14cd19de1..74c334cff 100644 --- a/gui/default/assets/lang/lang-be.json +++ b/gui/default/assets/lang/lang-be.json @@ -27,6 +27,7 @@ "Allowed Networks": "Дазволеныя Сеткі", "Alphabetic": "Па Алфавіту", "Altered by ignoring deletes.": "Зменена з-за ігнаравання выдаленняў.", + "Always turned on when the folder type is \"{%foldertype%}\".": "Заўсёды ўключана для папак з тыпам \"{{foldertype}}\".", "An external command handles the versioning. It has to remove the file from the shared folder. If the path to the application contains spaces, it should be quoted.": "Знешняя каманда утрымлівае версіянаванне. Яно патрабуе выдалення файла з агульнай дырэкторыі. Калі шлях да прыкладання ўтрымлівае прабелы, трэба іх выдаліць.", "Anonymous Usage Reporting": "Ананімная Спрадвыздача Аб Выкарыстанні", "Anonymous usage report format has changed. Would you like to move to the new format?": "Фармат ананімнай спрадвыздачы аб выкарыстанні быў зменены. Ці жадаеце вы выкарыстоўваць новы фармат?", diff --git a/gui/default/assets/lang/lang-et.json b/gui/default/assets/lang/lang-et.json index 32e510993..28f286e04 100644 --- a/gui/default/assets/lang/lang-et.json +++ b/gui/default/assets/lang/lang-et.json @@ -1,6 +1,7 @@ { "A device with that ID is already added.": "Sellise tunnusega seade on juba lisatud.", "A negative number of days doesn't make sense.": "Negatiivne päevade arv ei ole loogiline.", + "A new major version may not be compatible with previous versions.": "Uus põhiversioon ei pruugi ühilduv varasemate versioonidega.", "API Key": "API võti", "About": "Rakenduse teave", "Action": "Tegevus", @@ -19,20 +20,34 @@ "Apply": "Rakenda", "Automatic upgrades": "Automaatsed uuendused", "Be careful!": "Ettevaatust!", - "Cancel": "Loobu", - "Changelog": "Muudatuste nimekiri", + "Bugs": "Vead", + "Cancel": "Katkesta", + "Cannot be enabled when the folder type is \"{%foldertype%}\".": "Kui kausta tüüp on „{{foldertype}}“, siis seda ei saa kasutada.", + "Changelog": "Muudatuste ajalugu", "Close": "Sulge", + "Compression": "Pakkimine", + "Configuration Directory": "Seadistuste kaust", + "Configuration File": "Seadistuste fail", "Configured": "Seadistatud", + "Connected (Unused)": "Ühendatud (pole kasutusel)", "Connection Error": "Ühenduse viga", + "Connection Management": "Ühenduste haldus", "Connection Type": "Ühenduse tüüp", + "Connections": "Ühendused", "Copied from elsewhere": "Kopeeritud mujalt", + "Copied from original": "Kopeeritud algallikast", + "Copied!": "Kopeeritud!", "Delete": "Kustuta", "Device": "Seade", "Device \"{%name%}\" ({%device%} at {%address%}) wants to connect. Add new device?": "Seade \"{{name}}\" ({{device}} aadressil {{address}}) soovib luua ühendust. Kas lisada uus seade?", - "Device ID": "Seadme ID", + "Device Certificate": "Seadme sertifikaat", + "Device ID": "Seadme tunnus", + "Device Identification": "Seadme tuvastamine", "Device Name": "Seadme nimi", "Devices": "Seadmed", "Disconnected": "Ühendus puudub", + "Do not restore": "Ära taasta", + "Do not restore all": "Ära taasta kõiki", "Documentation": "Dokumentatsioon", "Download Rate": "Allalaadimise Kiirus", "Downloaded": "Alla laetud", @@ -55,33 +70,48 @@ "GUI Authentication User": "GUI Autentimise Kasutajatunnus", "GUI Theme": "GUI Teema", "Generate": "Genereeri", - "Global State": "Globaalne Olek", - "Help": "Abi", + "Global State": "Üldine olek", + "Help": "Abiteave", "Ignore": "Ignoreeri", "Ignore Patterns": "Ignoreeri Mustreid", "Ignore Permissions": "Ignoreeri Õigusi", - "Incoming Rate Limit (KiB/s)": "Siseneva Kiiruse Piirang (KiB/s)", + "Ignored Devices": "Eiratud seadmed", + "Ignored Folders": "Eiratud kaustad", + "Incoming Rate Limit (KiB/s)": "Siseneva liikluse kiiruspiirang (KiB/s)", "Keep Versions": "Säilita Versioone", "LDAP": "LDAP", "Largest First": "Suurim Enne", + "Last 30 Days": "Viimased 30 päeva", + "Last 7 Days": "Viimased 7 päeva", + "Last Month": "Viimane kuu", + "Last Scan": "Viimane skaneerimine", "Last seen": "Viimati nähtud", "Latest Change": "Viimane Muudatus", "Learn more": "Veel infot", + "Learn more at {%url%}": "Lisateavet leiad siit: {{url}}", "Local State": "Kohalik Olek", "Local State (Total)": "Kohalik Olek (Summaarne)", - "Maximum Age": "Maksimaalne Vanus", - "Metadata Only": "Ainult Meta-andmed", + "Maximum Age": "Maksimaalne vanus", + "Maximum single entry size": "Maksimaalne ühe objekti maht", + "Maximum total size": "Maksimaalne kogumaht", + "Metadata Only": "Ainult metaandmed", "Minimum Free Disk Space": "Minimaalne Vaba Kettaruum", + "More than a month ago": "Enam, kui kuu tagasi", + "More than a week ago": "Enam, kui nädal tagasi", + "More than a year ago": "Enam, kui aasta tagasi", "Move to top of queue": "Liiguta järjekorra algusesse", "Never": "Eikunagi", "New Device": "Uus Seade", "New Folder": "Uus Kaust", "Newest First": "Uusimad Ennem", "No": "Ei", + "Number of Connections": "Ühenduste arv", "OK": "Sobib", "Oldest First": "Vanimad Ennem", "Options": "Valikud", - "Outgoing Rate Limit (KiB/s)": "Väljuva Kiiruse Piirang (KiB/s)", + "Out of Sync": "Pole sünkroonis", + "Out of Sync Items": "Sünkroonimata objektid", + "Outgoing Rate Limit (KiB/s)": "Väljuva kiiruse piirang (KiB/s)", "Override Changes": "Kirjuta Muudatused Üle", "Pause": "Peata", "Pause All": "Peata Kõik", diff --git a/gui/default/assets/lang/lang-fr.json b/gui/default/assets/lang/lang-fr.json index 2311440ec..0b5d249bf 100644 --- a/gui/default/assets/lang/lang-fr.json +++ b/gui/default/assets/lang/lang-fr.json @@ -256,8 +256,8 @@ "Maximum total size": "Taille maximum totale", "Metadata Only": "Métadonnées uniquement", "Minimum Free Disk Space": "Espace disque libre minimum", - "Mod. Device": "Appareil modificateur", - "Mod. Time": "Date de modification", + "Mod. Device": "Modificateur", + "Mod. Time": "Dernière modif.", "More than a month ago": "Plus d'un mois", "More than a week ago": "Plus d'une semaine", "More than a year ago": "Plus d'un an", diff --git a/gui/default/assets/lang/lang-he-IL.json b/gui/default/assets/lang/lang-he-IL.json index 7cf9bad88..7ff0a4fff 100644 --- a/gui/default/assets/lang/lang-he-IL.json +++ b/gui/default/assets/lang/lang-he-IL.json @@ -82,6 +82,7 @@ "Custom Range": "טווח מותאם אישית", "Danger!": "סכנה!", "Database Location": "מיקום מסד נתונים", + "Debug": "איתור באגים", "Debugging Facilities": "מתקני דיבוג", "Default": "ברירת מחדל", "Default Configuration": "תצורת ברירת מחדל", @@ -210,6 +211,7 @@ "Incoming Rate Limit (KiB/s)": "מגבלת קצב נכנס (KiB/s)", "Incorrect configuration may damage your folder contents and render Syncthing inoperable.": "תצורה שגויה עלולה לגרום נזק לתכולת התיקייה שלך ולהפוך את Syncthing לבלתי ניתן להפעלה.", "Incorrect user name or password.": "שם משתמש או סיסמה שגויים.", + "Info": "מידע", "Internally used paths:": "נתיבים בשימוש פנימי:", "Introduced By": "הוצג על ידי", "Introducer": "מציג", diff --git a/man/stdiscosrv.1 b/man/stdiscosrv.1 index f0f89aac2..6a6aaec29 100644 --- a/man/stdiscosrv.1 +++ b/man/stdiscosrv.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "STDISCOSRV" "1" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "STDISCOSRV" "1" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME stdiscosrv \- Syncthing Discovery Server .SH SYNOPSIS diff --git a/man/strelaysrv.1 b/man/strelaysrv.1 index 9bdc592ef..6928382b7 100644 --- a/man/strelaysrv.1 +++ b/man/strelaysrv.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "STRELAYSRV" "1" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "STRELAYSRV" "1" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME strelaysrv \- Syncthing Relay Server .SH SYNOPSIS diff --git a/man/syncthing-bep.7 b/man/syncthing-bep.7 index 9dfed198d..f575d7d1f 100644 --- a/man/syncthing-bep.7 +++ b/man/syncthing-bep.7 @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-BEP" "7" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-BEP" "7" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-bep \- Block Exchange Protocol v1 .SH INTRODUCTION AND DEFINITIONS diff --git a/man/syncthing-config.5 b/man/syncthing-config.5 index 2db7ab9ea..d075d99e4 100644 --- a/man/syncthing-config.5 +++ b/man/syncthing-config.5 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-CONFIG" "5" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-CONFIG" "5" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-config \- Syncthing Configuration .SH OVERVIEW diff --git a/man/syncthing-device-ids.7 b/man/syncthing-device-ids.7 index aa620ba23..b45ddf5fa 100644 --- a/man/syncthing-device-ids.7 +++ b/man/syncthing-device-ids.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-DEVICE-IDS" "7" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-DEVICE-IDS" "7" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-device-ids \- Understanding Device IDs .sp diff --git a/man/syncthing-event-api.7 b/man/syncthing-event-api.7 index 99854bbcb..8984b9a47 100644 --- a/man/syncthing-event-api.7 +++ b/man/syncthing-event-api.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-EVENT-API" "7" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-EVENT-API" "7" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-event-api \- Event API .SH DESCRIPTION diff --git a/man/syncthing-faq.7 b/man/syncthing-faq.7 index e4e5504ee..0cf8952c3 100644 --- a/man/syncthing-faq.7 +++ b/man/syncthing-faq.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-FAQ" "7" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-FAQ" "7" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-faq \- Frequently Asked Questions .INDENT 0.0 diff --git a/man/syncthing-globaldisco.7 b/man/syncthing-globaldisco.7 index a5dbf8add..5ef677c35 100644 --- a/man/syncthing-globaldisco.7 +++ b/man/syncthing-globaldisco.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-GLOBALDISCO" "7" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-GLOBALDISCO" "7" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-globaldisco \- Global Discovery Protocol v3 .SH ANNOUNCEMENTS diff --git a/man/syncthing-localdisco.7 b/man/syncthing-localdisco.7 index 4c495b1bf..594ade574 100644 --- a/man/syncthing-localdisco.7 +++ b/man/syncthing-localdisco.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-LOCALDISCO" "7" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-LOCALDISCO" "7" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-localdisco \- Local Discovery Protocol v4 .SH MODE OF OPERATION diff --git a/man/syncthing-networking.7 b/man/syncthing-networking.7 index 4a4222ce5..f2a76efa1 100644 --- a/man/syncthing-networking.7 +++ b/man/syncthing-networking.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-NETWORKING" "7" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-NETWORKING" "7" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-networking \- Firewall Setup .SH ROUTER SETUP diff --git a/man/syncthing-relay.7 b/man/syncthing-relay.7 index 4421d1c88..ec68fe0a1 100644 --- a/man/syncthing-relay.7 +++ b/man/syncthing-relay.7 @@ -28,7 +28,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-RELAY" "7" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-RELAY" "7" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-relay \- Relay Protocol v1 .SH WHAT IS A RELAY? @@ -237,9 +237,10 @@ ResponseNotFound \- Session key is invalid ResponseAlreadyConnected \- Session is full (both sides already connected) .IP 3. 3 ResponseSuccess \- You have successfully joined the session +.IP 4. 3 +RelayFull \- Relay limits are too strict for you to be able to join the session. .UNINDENT .sp -4. RelayFull \- Relay limits are too strict for you to be able to join the session. The relay immediately terminates the connection after sending this. .sp After the successful response, all the bytes written and received will be diff --git a/man/syncthing-rest-api.7 b/man/syncthing-rest-api.7 index 8aae9c435..4a825a4bc 100644 --- a/man/syncthing-rest-api.7 +++ b/man/syncthing-rest-api.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-REST-API" "7" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-REST-API" "7" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-rest-api \- REST API .sp diff --git a/man/syncthing-security.7 b/man/syncthing-security.7 index c2e98c818..36e4dc6dd 100644 --- a/man/syncthing-security.7 +++ b/man/syncthing-security.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-SECURITY" "7" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-SECURITY" "7" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-security \- Security Principles .sp diff --git a/man/syncthing-stignore.5 b/man/syncthing-stignore.5 index dc14ab88f..3663105d2 100644 --- a/man/syncthing-stignore.5 +++ b/man/syncthing-stignore.5 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-STIGNORE" "5" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-STIGNORE" "5" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-stignore \- Prevent files from being synchronized to other nodes .SH SYNOPSIS diff --git a/man/syncthing-versioning.7 b/man/syncthing-versioning.7 index 02f386405..31dda023e 100644 --- a/man/syncthing-versioning.7 +++ b/man/syncthing-versioning.7 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING-VERSIONING" "7" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING-VERSIONING" "7" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing-versioning \- Keep automatic backups of deleted files by other nodes .sp diff --git a/man/syncthing.1 b/man/syncthing.1 index ace5a7d27..314aa4118 100644 --- a/man/syncthing.1 +++ b/man/syncthing.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "SYNCTHING" "1" "Sep 06, 2025" "v2.0.0" "Syncthing" +.TH "SYNCTHING" "1" "Sep 14, 2025" "v2.0.0" "Syncthing" .SH NAME syncthing \- Syncthing .SH SYNOPSIS @@ -43,10 +43,12 @@ syncthing [serve] [\-\-gui\-address=
] [\-\-gui\-apikey=] [\-\-log\-level=] [\-\-log\-file=] [\-\-log\-max\-old\-files=] [\-\-log\-max\-size=] + [\-\-log\-format\-timestamp=] [\-\-no\-log\-format\-level\-string] + [\-\-log\-format\-level\-syslog] [\-\-no\-browser] [\-\-no\-console] [\-\-no\-port\-probing] [\-\-no\-restart] [\-\-no\-upgrade] [\-\-paused] [\-\-unpaused] - [\-\-verbose] [\-\-version] [\-\-help] [\-\-debug\-*] + [\-\-version] [\-\-help] [\-\-debug\-*] syncthing cli [\-\-home= | \-\-config= \-\-data=] @@ -112,7 +114,7 @@ few log messages. .SH COMMON OPTIONS .INDENT 0.0 .TP -.B \-\-home=, \-H +.B \-\-home=, \-H ($STHOMEDIR) Set common configuration and data directory. The default configuration directory is \fB$XDG_STATE_HOME/syncthing\fP or \fB$HOME/.local/state/syncthing\fP (Unix\-like), @@ -121,13 +123,13 @@ directory is \fB$XDG_STATE_HOME/syncthing\fP or .UNINDENT .INDENT 0.0 .TP -.B \-\-config=, \-C +.B \-\-config=, \-C ($STCONFDIR) Set configuration directory. Alternative to \fB\-\-home\fP and must be used together with \fB\-\-data\fP\&. .UNINDENT .INDENT 0.0 .TP -.B \-\-data=, \-D +.B \-\-data=, \-D ($STDATADIR) Set data (e.g. database) directory. Alternative to \fB\-\-home\fP and must be used together with \fB\-\-config\fP\&. .UNINDENT @@ -140,36 +142,38 @@ given subcommand. .SH SERVE OPTIONS .INDENT 0.0 .TP -.B \-\-allow\-newer\-config +.B \-\-allow\-newer\-config ($STALLOWNEWERCONFIG) Try loading a config file written by a newer program version, instead of failing immediately. .UNINDENT .INDENT 0.0 .TP -.B \-\-audit +.B \-\-audit ($STAUDIT) Write events to timestamped file \fBaudit\-YYYYMMDD\-HHMMSS.log\fP\&. .UNINDENT .INDENT 0.0 .TP -.B \-\-auditfile= +.B \-\-auditfile= ($STAUDITFILE) Use specified file or stream (\fB\(dq\-\(dq\fP for stdout, \fB\(dq\-\-\(dq\fP for stderr) for audit events, rather than the timestamped default file name. .UNINDENT .INDENT 0.0 .TP -.B \-\-db\-maintenance\-interval= +.B \-\-db\-maintenance\-interval= ($STDBMAINTENANCEINTERVAL) Database maintenance interval – internal database maintenance routines -run this often. +run this often. The format is that of a Go duration string (see +\X'tty: link https://pkg.go.dev/time#ParseDuration'\fI\%https://pkg.go.dev/time#ParseDuration\fP\X'tty: link'). .UNINDENT .INDENT 0.0 .TP -.B \-\-db\-delete\-retention\-interval= +.B \-\-db\-delete\-retention\-interval= ($STDBDELETERETENTIONINTERVAL) Database deleted item retention interval – deleted items are forgotten -from the database after this interval. +from the database after this interval. The format is that of a Go duration +string (see \X'tty: link https://pkg.go.dev/time#ParseDuration'\fI\%https://pkg.go.dev/time#ParseDuration\fP\X'tty: link'). .UNINDENT .INDENT 0.0 .TP -.B \-\-gui\-address=
+.B \-\-gui\-address=
($STGUIADDRESS) Override GUI listen address. Set this to an address (\fB0.0.0.0:8384\fP) or a URL (\fBhttp://0.0.0.0:8384\fP). Supported schemes are \fBhttp\fP for plain HTTP, \fBhttps\fP for HTTP over TLS, \fBunix\fP for plain Unix sockets @@ -179,79 +183,95 @@ as part of the URL structure, one to specify an absolute path). .UNINDENT .INDENT 0.0 .TP -.B \-\-gui\-apikey= +.B \-\-gui\-apikey= ($STGUIAPIKEY) Override the API key needed to access the GUI / REST API. .UNINDENT .INDENT 0.0 .TP -.B \-\-log\-level= -Set the log level for all packages. Valid levels are DEBUG, INFO, WARN, -and ERROR. -.UNINDENT -.INDENT 0.0 -.TP -.B \-\-log\-file= +.B \-\-log\-file= ($STLOGFILE) Set destination filename for logging (use \fB\(dq\-\(dq\fP for stdout, which is the default option). .UNINDENT .INDENT 0.0 .TP -.B \-\-log\-max\-old\-files= +.B \-\-log\-level= ($STLOGLEVEL) +Set the log level for all packages. Valid levels are DEBUG, INFO, WARN, +and ERROR. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-log\-max\-old\-files= ($STLOGMAXOLDFILES) Number of old files to keep (zero to keep only current). Applies only when log rotation is enabled through \fB\-\-log\-max\-size\fP\&. .UNINDENT .INDENT 0.0 .TP -.B \-\-log\-max\-size= -Maximum size of any log file (zero to disable log rotation). +.B \-\-log\-max\-size= ($STLOGMAXSIZE) +Maximum size in bytes of any log file (zero to disable log rotation). .UNINDENT .INDENT 0.0 .TP -.B \-\-no\-browser +.B \-\-log\-format\-timestamp= ($STLOGFORMATTIMESTAMP) +Format for timestamp, set to empty to disable timestamps. The format is that +of the Go time formatter (see \X'tty: link https://pkg.go.dev/time#Layout'\fI\%https://pkg.go.dev/time#Layout\fP\X'tty: link'). +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-[no\-]log\-format\-level\-string ($STLOGFORMATLEVELSTRING) +Whether to include level string (e.g. “INF”) in log line. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-[no\-]log\-format\-level\-syslog ($STLOGFORMATLEVELSYSLOG) +Whether to include level as syslog prefix (e.g. “<6>”) in log line. +.UNINDENT +.INDENT 0.0 +.TP +.B \-\-no\-browser ($STNOBROWSER) Do not start a browser. .UNINDENT .INDENT 0.0 .TP -.B \-\-no\-console +.B \-\-no\-console ($STNOCONSOLE) Hide the console window. (On Windows only) .UNINDENT .INDENT 0.0 .TP -.B \-\-no\-port\-probing +.B \-\-no\-port\-probing ($STNOPORTPROBING) Don’t try to find unused random ports for the GUI and listen address when generating an initial configuration / starting for the first time. .UNINDENT .INDENT 0.0 .TP -.B \-\-no\-restart +.B \-\-no\-restart ($STNORESTART) Do not restart Syncthing when it exits. The monitor process will still run to handle crashes and writing to logfiles (if configured to). .UNINDENT .INDENT 0.0 .TP -.B \-\-no\-upgrade -Disable automatic upgrades. Equivalent to the \fBSTNOUPGRADE\fP environment -variable, see below. +.B \-\-no\-upgrade ($STNOUPGRADE) +Disable automatic upgrades. .UNINDENT .INDENT 0.0 .TP -.B \-\-paused +.B \-\-paused ($STPAUSED) Start with all devices and folders paused. .UNINDENT .INDENT 0.0 .TP -.B \-\-unpaused +.B \-\-unpaused ($STUNPAUSED) Start with all devices and folders unpaused. .UNINDENT .INDENT 0.0 .TP -.B \-\-upgrade -Perform upgrade. +.B \-\-version +Show the current version information, then exit. .UNINDENT .INDENT 0.0 .TP -.B \-\-verbose -Print verbose log output. +.B \-\-debug\-* +Several debug options exist. See \fBsyncthing serve \-\-help\fP for the flags +that apply to your version. .UNINDENT .SH DECRYPT OPTIONS .INDENT 0.0 @@ -266,7 +286,7 @@ Don’t write decrypted files to disk (but verify plaintext hashes). .UNINDENT .INDENT 0.0 .TP -.B \-\-password= +.B \-\-password= ($FOLDER_PASSWORD) Folder password for decryption / verification. Can be passed through the \fBFOLDER_PASSWORD\fP environment variable instead to avoid recording in a shell’s history buffer or sniffing from the running processes list. @@ -337,9 +357,9 @@ signal handler. Exit codes over 128+N on Unix usually represent the signal which caused the process to exit. For example, \fB128 + 9 (SIGKILL) = 137\fP\&. .SH SUBCOMMANDS .sp -The command line syntax actually supports different modes of operation through -several subcommands, specified as the first argument. If omitted, the default -\fBserve\fP is assumed. +The command line syntax supports different modes of operation through +several subcommands, specified as the first argument. If omitted, the +default \fBserve\fP is assumed. .sp The initial setup of a device ID and default configuration can be called explicitly with the \fBgenerate\fP subcommand. It can also update the configured @@ -423,38 +443,79 @@ facilities to trace: \fBapi,beacon\fP\&. Optionally, a log level can be given per facility to specify something other than DEBUG: \fBapi:WARN,beacon:ERR\fP, potentially overriding a global \fB\-\-log\-level\fP adjustment. -.INDENT 7.0 -.INDENT 3.5 +.sp The valid facility strings are listed below; additionally, \fBsyncthing serve \-\-help\fP always outputs the most up\-to\-date list. -.INDENT 0.0 -.INDENT 3.5 -api \- REST API -beacon \- Multicast and broadcast discovery -config \- Configuration loading and saving -connections \- Connection handling -db/sqlite \- SQLite database -dialer \- Dialing connections -discover \- Remote device discovery -events \- Event generation and logging -fs \- Filesystem access -main \- Main package -model \- The root hub -nat \- NAT discovery and port mapping -pmp \- NAT\-PMP discovery and port mapping -protocol \- The BEP protocol -relay/client \- Relay client -scanner \- File change detection and hashing -stun \- STUN functionality -syncthing \- Main run facility -upgrade \- Binary upgrades -upnp \- UPnP discovery and port mapping -ur \- Usage reporting -versioner \- File versioning -watchaggregator \- Filesystem event watcher -.UNINDENT -.UNINDENT -.UNINDENT +.INDENT 7.0 +.TP +.B api +REST API +.TP +.B beacon +Multicast and broadcast discovery +.TP +.B config +Configuration loading and saving +.TP +.B connections +Connection handling +.TP +.B db/sqlite +SQLite database +.TP +.B dialer +Dialing connections +.TP +.B discover +Remote device discovery +.TP +.B events +Event generation and logging +.TP +.B fs +Filesystem access +.TP +.B main +Main package +.TP +.B model +The root hub +.TP +.B nat +NAT discovery and port mapping +.TP +.B pmp +NAT\-PMP discovery and port mapping +.TP +.B protocol +The BEP protocol +.TP +.B relay/client +Relay client +.TP +.B scanner +File change detection and hashing +.TP +.B stun +STUN functionality +.TP +.B syncthing +Main run facility +.TP +.B upgrade +Binary upgrades +.TP +.B upnp +UPnP discovery and port mapping +.TP +.B ur +Usage reporting +.TP +.B versioner +File versioning +.TP +.B watchaggregator +Filesystem event watcher .UNINDENT .TP .B STLOCKTHRESHOLD