diff options
Diffstat (limited to 'doc/sr/weechat_relay_protocol.sr.adoc')
| -rw-r--r-- | doc/sr/weechat_relay_protocol.sr.adoc | 44 |
1 files changed, 28 insertions, 16 deletions
diff --git a/doc/sr/weechat_relay_protocol.sr.adoc b/doc/sr/weechat_relay_protocol.sr.adoc index 3f9856460..fbf67e515 100644 --- a/doc/sr/weechat_relay_protocol.sr.adoc +++ b/doc/sr/weechat_relay_protocol.sr.adoc @@ -97,7 +97,8 @@ _клијенти_ су повезани са _релејем_ као што ј [[command_handshake]] === handshake -_WeeChat ≥ 2.9._ +// TRANSLATION MISSING +_WeeChat ≥ 2.9, updated in version 3.5._ Извршава руковање између клијента и програма WeeChat: ово је у већини случајева неопходно како би се сазнале поставке сесије и припремила аутентификација командом _init_. @@ -118,9 +119,16 @@ _WeeChat ≥ 2.9._ *** _sha512_: лозинка засољена и хеширана SHA512 алгоритмом *** _pbkdf2+sha256_: лозинка засољена и хеширана PBKDF2 алгоритмом (користећи SHA256 хеш) *** _pbkdf2+sha512_: лозинка засољена и хеширана PBKDF2 алгоритмом (користећи SHA512 хеш) -** _compression_: тип компресије: -*** _zlib_: укључује _zlib_ компресију порука које шаље _релеј_ (подразумевано је укључено ако _релеј_ подржава _zlib_ компресију) -*** _off_: искључује компресију +// TRANSLATION MISSING +** _compression_: list of supported compression types supported by the client + (separated by colons and sorted from most important to the fallback value); + if compression is enabled, messages from _relay_ to client are compressed + to save bandwidth; allowed values are: +*** _off_: no compression (default if option is not given) +*** _zlib_: compress with https://zlib.net/[zlib] _(WeeChat ≥ 0.3.7)_ +*** _zstd_: compress with https://facebook.github.io/zstd/[Zstandard]: better + compression and much faster than _zlib_ for both compression and decompression + _(WeeChat ≥ 3.5)_ Напомене у вези опције _password_hash_algo_: @@ -147,8 +155,9 @@ _WeeChat ≥ 2.9._ ** _off_: Time-based One-Time Password (TOTP) је искључена и није потребна у _init_ команди * _nonce_: бафер бајтова који не могу да се предвиде, послат као хексадецимална вредност, којом се спречавају replay напади; ако је _password_hash_algo_ хеш алгоритам, клијент мора да израчуна хеш лозинке над овим нонсом, спојено са клијентовим нонсом и корисничком лозинком (_релеј_ нонс + _клијент_ нонс је со која се користи у алгоритму хеширања лозинке) * _compression_: тип компресије: -** _zlib_: поруке су компресоване са _zlib_ ** _off_: поруке се не компресују +** _zlib_: поруке су компресоване са https://zlib.net/[zlib] +** _zstd_: поруке су компресоване са https://facebook.github.io/zstd/[Zstandard] [TIP] У програму WeeChat верзије ≤ 2.8, команда _handshake_ није имплементирана, програм WeeChat једноставно игнорише ову команду, чак и ако се пошаље пре _init_ команде. + @@ -172,7 +181,7 @@ htb: { 'password_hash_iterations': '100000', 'totp': 'on', 'nonce': '85B1EE00695A5B254E14F4885538DF0D', - 'compression': 'zlib', + 'compression': 'off', } ---- @@ -192,7 +201,7 @@ htb: { 'password_hash_iterations': '100000', 'totp': 'on', 'nonce': '85B1EE00695A5B254E14F4885538DF0D', - 'compression': 'zlib', + 'compression': 'off', } ---- @@ -212,7 +221,7 @@ htb: { 'password_hash_iterations': '100000', 'totp': 'on', 'nonce': '85B1EE00695A5B254E14F4885538DF0D', - 'compression': 'zlib', + 'compression': 'off', } ---- @@ -222,10 +231,12 @@ htb: { init password_hash=pbkdf2+sha256:85b1ee00695a5b254e14f4885538df0da4b73207f5aae4:100000:ba7facc3edb89cd06ae810e29ced85980ff36de2bb596fcf513aaab626876440 ---- -* Клијент подржава само „sha256” и „sha512”, компресије се искључује: +// TRANSLATION MISSING +* Клијент подржава само „sha256” и „sha512”, компресије се искључује, +enable zstd (preferred) or zlib compression: ---- -(handshake) handshake password_hash_algo=sha256:sha512,compression=off +(handshake) handshake password_hash_algo=sha256:sha512,compression=zstd:zlib ---- Одговор: @@ -238,7 +249,7 @@ htb: { 'password_hash_iterations': '100000', 'totp': 'on', 'nonce': '85B1EE00695A5B254E14F4885538DF0D', - 'compression': 'off', + 'compression': 'zstd', } ---- @@ -264,9 +275,6 @@ _Ажурирано у верзијама 2.4, 2.8, 2.9._ ** _password_: лозинка која се користи за аутентификацију са _релејем_ (опција _relay.network.password_ у програму WeeChat) ** _password_hash_: хеш лозинке која се користи за аутентификацију са _релејем_ (опција _relay.network.password_ у програму WeeChat), погледајте испод за формат _(WeeChat ≥ 2.8)_ ** _totp_: Time-based One-Time Password (TOTP) која се користи као секундарни фактор аутентификације, уз лозинку (опција _relay.network.totp_secret_ у програму WeeChat) _(WeeChat ≥ 2.4)_ -** _compression_: тип компресије (*превазиђено* почевши од верзије 2.9, остало је из разлога компатибилности, али ви требало да се пошаље у <<command_handshake,handshake команди>>): -*** _zlib_: укључује _zlib_ компресију порука које шаље _релеј_ (подразумевано је укључено ако _релеј_ подржава _zlib_ компресију) -*** _off_: искључује компресију [NOTE] У програму WeeChat верзије ≥ 1.6, у вредности могу да се означе запете, на пример `+init password=foo\,bar+` када желите да пошаљете лозинку „foo,bar”. @@ -1292,7 +1300,8 @@ quit * _дужина_ (неозначени цео број, 4 бајта): број бајтова у целој поруци (заједно са овим пољем) * _компресија_ (бајт): заставица: ** _0x00_: подаци који следе нису компресовани -** _0x01_: подаци који следе су компресовани са _zlib_ +** _0x01_: подаци који следе су компресовани са https://zlib.net/[zlib] +** _0x02_: подаци који следе су компресовани са https://facebook.github.io/zstd/[Zstandard] * _id_ (стринг, 4 бајта + садржај): идентификатор који послао клијент (пре имена команде); може бити и празан (стринг дужине нула и без садржаја) ако у команди није био наведен идентификатор * _тип_ (3 карактера): тип: 3 слова (погледајте табелу испод) * _објект_: објекат (погледајте табелу испод) @@ -1300,7 +1309,10 @@ quit [[message_compression]] === Компресија -Ако је вредност заставице _компресија_ 0x01, онда су *сви* подаци компресовани _zlib_ алгоритмом, тако да пре обраде морају да се декомпресују. +// TRANSLATION MISSING +If flag _compression_ is equal to 0x01 or 0x02, then *all* data after is compressed +with https://zlib.net/[zlib] or https://facebook.github.io/zstd/[Zstandard], +and therefore must be uncompressed before being processed. [[message_identifier]] === Идентификатор |