Ginger
0b1e24a9ad
Some checks failed
Checks / Prek / Check changed files (push) Successful in 4s
Documentation / Build and Deploy Documentation (push) Successful in 54s
Checks / Prek / Pre-commit & Formatting (push) Successful in 1m19s
Release Docker Image / Build linux-amd64 (release) (push) Successful in 9m23s
Checks / Prek / Clippy and Cargo Tests (push) Successful in 11m18s
Release Docker Image / Build linux-arm64 (release) (push) Successful in 9m15s
Release Docker Image / Create Multi-arch Release Manifest (push) Successful in 16s
Release Docker Image / Create Max-Perf Manifest (push) Has been cancelled
Release Docker Image / Release Binaries (push) Has been cancelled
Release Docker Image / Mirror Images (push) Has been cancelled
Release Docker Image / Build linux-arm64 (max-perf) (push) Has been cancelled
Release Docker Image / Build linux-amd64 (max-perf) (push) Has been cancelled
155 lines
4.7 KiB
Markdown
155 lines
4.7 KiB
Markdown
<!-- This file is generated by `cargo xtask generate-docs`. Do not edit. -->
|
|
# `!admin debug`
|
|
|
|
Commands for debugging things
|
|
|
|
|
|
## `!admin debug echo`
|
|
|
|
Echo input of admin command
|
|
|
|
## `!admin debug get-auth-chain`
|
|
|
|
Loads the auth_chain of a PDU, reporting how long it took
|
|
|
|
## `!admin debug show-auth-chain`
|
|
|
|
Walks & displays the auth_chain of a PDU in a mermaid graph format.
|
|
|
|
This is useless to basically anyone but developers, and is also probably slow and memory hungry.
|
|
|
|
## `!admin debug parse-pdu`
|
|
|
|
Parse and print a PDU from a JSON
|
|
|
|
The PDU event is only checked for validity and is not added to the database.
|
|
|
|
This command needs a JSON blob provided in a Markdown code block below the command.
|
|
|
|
## `!admin debug get-pdu`
|
|
|
|
Retrieve and print a PDU by EventID from the Continuwuity database
|
|
|
|
## `!admin debug get-short-pdu`
|
|
|
|
Retrieve and print a PDU by PduId from the Continuwuity database
|
|
|
|
## `!admin debug get-remote-pdu`
|
|
|
|
Attempts to retrieve a PDU from a remote server. **Does not** insert it into the database or persist it anywhere
|
|
|
|
## `!admin debug get-remote-pdu-list`
|
|
|
|
Same as `get-remote-pdu` but accepts a codeblock newline delimited list of PDUs and a single server to fetch from
|
|
|
|
## `!admin debug get-room-state`
|
|
|
|
Gets all the room state events for the specified room.
|
|
|
|
This is functionally equivalent to `GET /_matrix/client/v3/rooms/{roomid}/state`, except the admin command does *not* check if the sender user is allowed to see state events. This is done because it's implied that server admins here have database access and can see/get room info themselves anyways if they were malicious admins.
|
|
|
|
Of course the check is still done on the actual client API.
|
|
|
|
## `!admin debug get-state-at`
|
|
|
|
Gets all the room state events at the specified event.
|
|
|
|
State at event might not be available for some PDUs, such as rejected ones.
|
|
|
|
## `!admin debug get-signing-keys`
|
|
|
|
Get and display signing keys from local cache or remote server
|
|
|
|
## `!admin debug get-verify-keys`
|
|
|
|
Get and display signing keys from local cache or remote server
|
|
|
|
## `!admin debug ping`
|
|
|
|
Sends a federation request to the remote server's `/_matrix/federation/v1/version` endpoint and measures the latency it took for the server to respond
|
|
|
|
## `!admin debug force-device-list-updates`
|
|
|
|
Forces device lists for all local and remote users to be updated (as having new keys available)
|
|
|
|
## `!admin debug change-log-level`
|
|
|
|
Change tracing log level/filter on the fly
|
|
|
|
This accepts the same format as the `log` config option.
|
|
|
|
## `!admin debug verify-json`
|
|
|
|
Verify JSON signatures
|
|
|
|
This command needs a JSON blob provided in a Markdown code block below the command.
|
|
|
|
## `!admin debug verify-pdu`
|
|
|
|
Verify PDU
|
|
|
|
This re-verifies a PDU existing in the database found by ID.
|
|
|
|
## `!admin debug first-pdu-in-room`
|
|
|
|
Prints the very first PDU in the specified room (typically m.room.create)
|
|
|
|
## `!admin debug latest-pdu-in-room`
|
|
|
|
Prints the latest ("last") PDU in the specified room (typically a message)
|
|
|
|
## `!admin debug force-set-room-state-from-server`
|
|
|
|
Forcefully replaces the room state of our local copy of the specified room, with the copy (auth chain and room state events) the specified remote server says.
|
|
|
|
A common desire for room deletion is to simply "reset" our copy of the room. While this admin command is not a replacement for that, if you know you have split/broken room state and you know another server in the room that has the best/working room state, this command can let you use their room state. Such example is your server saying users are in a room, but other servers are saying they're not in the room in question.
|
|
|
|
This command will get the latest PDU in the room we know about, and request the room state at that point in time via `/_matrix/federation/v1/state/{roomId}`.
|
|
|
|
## `!admin debug resolve-true-destination`
|
|
|
|
Runs a server name through Continuwuity's true destination resolution process
|
|
|
|
Useful for debugging well-known issues
|
|
|
|
## `!admin debug memory-stats`
|
|
|
|
Print extended memory usage
|
|
|
|
Optional argument is a character mask (a sequence of characters in any order) which enable additional extended statistics. Known characters are "abdeglmx". For convenience, a '*' will enable everything.
|
|
|
|
## `!admin debug runtime-metrics`
|
|
|
|
Print general tokio runtime metric totals
|
|
|
|
## `!admin debug runtime-interval`
|
|
|
|
Print detailed tokio runtime metrics accumulated since last command invocation
|
|
|
|
## `!admin debug time`
|
|
|
|
Print the current time
|
|
|
|
## `!admin debug database-stats`
|
|
|
|
Get database statistics
|
|
|
|
## `!admin debug trim-memory`
|
|
|
|
Trim memory usage
|
|
|
|
## `!admin debug database-files`
|
|
|
|
List database files
|
|
|
|
## `!admin debug send-test-email`
|
|
|
|
Send a test email to the invoking admin's email address
|
|
|
|
## `!admin debug rooms-by-extremity-count`
|
|
|
|
Lists room IDs by forward extremity count in descending order
|
|
|
|
## `!admin debug tester`
|
|
|
|
Developer test stubs
|