gandc/zapret2
Template
1
0
Fork 0
mirror of https://github.com/bol-van/zapret2.git synced 2026-03-14 06:13:09 +00:00
Code Issues Packages Projects Releases Wiki Activity

update docs

Browse Source
This commit is contained in:
bol-van
2025-12-16 12:57:54 +03:00
parent 8eb588d6a4
commit ee7b72dc66
1 changed files with 8 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
docs/manual.md
View File

@@ -1806,7 +1806,7 @@ function luaexec(ctx, desync)
Код может адресовать таблицу desync - она временно присваивается глобальной переменной desync,
а по завершению кода глобальная переменная убирается.
Пример : `--lua-desync=luaexec:code="desync.rnd=brandom(math.random(5,10))"
Пример : `--lua-desync=luaexec:code="desync.rnd=brandom(math.random(5,10))"`
```
function pass(ctx, desync)
@@ -1836,7 +1836,7 @@ function posdebug(ctx, desync)
function desync_orchestrator_example(ctx, desync)
```
Тестовый окрестратор. Ничего специального не делает, только выполняет execution plan в исходном виде.
Тестовый оркестратор. Ничего специального не делает, только выполняет execution plan в исходном виде.
## Служебные функции
@@ -1901,7 +1901,7 @@ function pattern(pat, offset, len)
* has_nonprintable возвращает true, если в строке s есть символы, кроме 0x20-0x7F, '\n', '\r', '\t'
* make_readable заменяет все символы, кроме 0x20-0x7F, точками
* str_or_hex возвращает саму строку, если has_nonpritable(s) = false, иначе string2hex(s)
* hexdump преобразует начальные байт raw строки s (до max байт) в hex строку + символь
* hexdump преобразует начальные байт raw строки s (до max байт) в hex строку + результат make_readable. Классический hex dump.
* hexdump_dlog выполняет hexdump и выводит результат в debug log
* pattern - это часть условно бесконечно повторяющейся raw строки pat, начинающаяся с позиции offset (нумерация с 1) и длиной len
@@ -1912,7 +1912,7 @@ function blob_or_def(desync, name, def)
* blob - стандартная функция получения блоба. Если name начинается с `0x`, то дальнейшее интерпретируется как HEX строка.
Иначе читается переменная name сначала в desync. Если там нет, берется глобальная переменная.
Если и ее нет, берется значение def.
Если и ее нет, берется значение def. Если name = nil или пустая строка, вызывается error.
* blob_or_def - возвращает def, если name = nil, иначе аналогично blob
## Обслуживание tcp sequence numbers
@@ -1946,14 +1946,14 @@ function pos_str(desync, pos)
Параметр mode содержит строку с одной буквой режима счетчика - 'a','x','n','d','b','s','p'.
По умолчанию функции работают с текущим направлением. Если есть параметр reverse и он задан как true, берется противоположное направление.
* pos_counter_overflow - true, если mode = 's' или 'p' и произошел выход tcp sequence за пределы 2 GB. Счетчики больше не могут использоваться.
* pos_counter_overflow - true, если mode = 's' или 'p' и произошел выход relative tcp sequence за пределы 2 GB. Счетчики больше не могут использоваться.
* pos_get_pos - получить значение счетчика mode из таблицы счетчиков `track_pos`. `track_pos` может быть `desync.track.pos.{direct,reverse,client,server}`
* pos_get - получить значение счетчика mode по текущему или противоположному направлению
* pos_check_from - проверить удовлетворяет ли текущая позиция нижней границе range
* pos_check_to - проверить удовлетворяет ли текущая позиция верхней границе range
* pos_range - проверить удовлетворяет ли текущая позиция range (нижней и верхней границе)
* pos_str - преобразование таблицы позиции pos в стандартную строковую форму `<mode><pos>`, например `s100`.
* pos_range_str - преобразование таблицы диапазона range в стандартную строковую форму `<mode_from><pos_from>(-<)<mode_to><pos_to>`, например `d1-p5000`.
* pos_range_str - преобразование таблицы диапазона range в стандартную строковую форму `<mode_from><pos_from>(-|<)<mode_to><pos_to>`, например `d1-p5000`.
### Диссекция
@@ -1980,7 +1980,7 @@ function http_dissect_req(http)
Разборка HTTP запроса http. http представляет собой многострочный текст.
Разборка представляет собой таблицу с вложенными подтаблицами.
В заголовках выдаются позиции начала и конца названия заголовка и самого значения.
Все позиции - внутри строки http.
Названия заголовках приводятся к нижнему регистру. Все позиции - внутри строки http.
<details>
<summary><b>Пример разборки http запроса `http://testhost.com/testuri`</b></summary>
@@ -2025,7 +2025,7 @@ function http_dissect_reply(http)
Разборка HTTP ответа http. http представляет собой многострочный текст.
Разборка представляет собой таблицу с вложенными подтаблицами.
В заголовках выдаются позиции начала и конца названия заголовка и самого значения.
Все позиции - внутри строки http.
Названия заголовках приводятся к нижнему регистру. Все позиции - внутри строки http.
<details>
<summary><b>Пример разборки http ответа</b></summary>