Skip to content

Commit 599f432

Browse files
author
Shlomi Noach
committed
documenting the question argument
1 parent 779e9fd commit 599f432

1 file changed

Lines changed: 12 additions & 3 deletions

File tree

doc/interactive-commands.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,9 @@ Both interfaces may serve at the same time. Both respond to simple text command,
2626
- The `critical-load` format must be: `some_status=<numeric-threshold>[,some_status=<numeric-threshold>...]`'
2727
- For example: `Threads_running=1000,threads_connected=5000`, and you would then write/echo `critical-load=Threads_running=1000,threads_connected=5000` to the socket.
2828
- `nice-ratio=<ratio>`: change _nice_ ratio: 0 for aggressive (not nice, not sleeping), positive integer `n`:
29-
- For any `1ms` spent copying rows, spend `n*1ms` units of time sleeping.
30-
- Examples: assume a single rows chunk copy takes `100ms` to complete.
31-
- `nice-ratio=0.5` will cause `gh-ost` to sleep for `50ms` immediately following.
29+
- For any `1ms` spent copying rows, spend `n*1ms` units of time sleeping.
30+
- Examples: assume a single rows chunk copy takes `100ms` to complete.
31+
- `nice-ratio=0.5` will cause `gh-ost` to sleep for `50ms` immediately following.
3232
- `nice-ratio=1` will cause `gh-ost` to sleep for `100ms`, effectively doubling runtime
3333
- value of `2` will effectively triple the runtime; etc.
3434
- `throttle-query`: change throttle query
@@ -38,6 +38,10 @@ Both interfaces may serve at the same time. Both respond to simple text command,
3838
- `unpostpone`: at a time where `gh-ost` is postponing the [cut-over](cut-over.md) phase, instruct `gh-ost` to stop postponing and proceed immediately to cut-over.
3939
- `panic`: immediately panic and abort operation
4040

41+
### Querying for data
42+
43+
For commands that accept an argumetn as value, pass `?` (question mark) to _get_ current value rather than _set_ a new one.
44+
4145
### Examples
4246

4347
While migration is running:
@@ -63,6 +67,11 @@ $ echo "chunk-size=250" | nc -U /tmp/gh-ost.test.sample_data_0.sock
6367
# Serving on TCP port: 10001
6468
```
6569

70+
```shell
71+
$ echo "chunk-size=?" | nc -U /tmp/gh-ost.test.sample_data_0.sock
72+
250
73+
```
74+
6675
```shell
6776
$ echo throttle | nc -U /tmp/gh-ost.test.sample_data_0.sock
6877

0 commit comments

Comments
 (0)