mariadb-cli 0.1.1

One-shot agent-native command line client for MariaDB servers
Documentation
# Prose of the failures that come from the channel, the server or this
# process's own machinery.
#
# The naming rule and the { $detail } rule are the ones stated in
# errors-usage.en.ftl. `server.condition` is absent on purpose: its message is
# the server's own text, and repeating it in another language would put words
# in the server's mouth.

err-network-unreachable = the server could not be reached over the channel
hint-network-unreachable = check the host, the port and whether the server accepts connections

err-server-driver-protocol = the exchange with the server did not follow the protocol

err-server-unclassified = the server call failed

err-server-silent-handshake = the server returned no answer when asked to describe itself
hint-server-silent-handshake = confirm the destination points at a server of the MariaDB family

err-server-count-unreadable = the derived count did not return a single number

err-server-restarted-between-readings = the server restarted between the two readings, so no difference can be computed
hint-server-restarted-between-readings = read again once the server is stable; the interval used was { $interval } seconds

err-server-too-many-connections = the server accepts no further connections right now

err-server-connection-missing = ending work needs the connection whose work is to end
hint-server-connection-missing = name one with --id, as in `server kill --id 42`; `server processes` lists them

err-authentication-method-unsupported = that is not an authentication method this build can complete ({ $detail })
hint-authentication-method-unsupported = give this user a method this build implements: mysql_native_password, caching_sha2_password, client_ed25519, parsec or mysql_clear_password

err-authentication-method-not-declared = the server asked for `mysql_clear_password`, which sends the secret as it is and is only used when the destination declares it
hint-authentication-method-not-declared = declare it with `conn add ... --auth mysql_clear_password`, and only over an encrypted channel

err-authentication-refused = the server refused the credential
hint-authentication-refused = check the user and the secret stored for this destination

err-permission-denied = the credential may not perform this operation
hint-permission-denied = grant the missing right on the server, or use another credential

err-permission-observation-denied = { $detail ->
        [other-connections] the credential may not observe other connections on this server
        [other-transactions] the credential may not observe the transactions of other connections on this server
        [statement-statistics] the credential may not observe the statement statistics on this server
       *[other] the credential may not observe that on this server
    }
hint-permission-observation-denied = grant the { $privilege } right to this credential, or use one that already has it

err-conflict-deadlock = the change hit a deadlock
hint-conflict-deadlock = repeat the call; the server rolled the change back

err-conflict-lock-wait = the change waited too long for a lock

err-conflict-constraint = the change was refused by a constraint

err-timeout-server-execution = the server stopped the statement at its own time limit

err-timeout-phase-exceeded = the phase went past its own time limit ({ $detail })
hint-timeout-phase-exceeded = check the state of the work on the server ({ $detail })

err-interrupted-by-server = the statement was stopped before it finished

err-interrupted-by-caller = the invocation was stopped by the caller

err-interrupted-session-ended = the session ended before the statement finished
hint-interrupted-session-ended = check `server processes` for whether the connection was ended; the work may have stopped part-way

err-interrupted-waiting-for-admission = the invocation was stopped while waiting to start a part of the work

err-interrupted-waiting-to-retry = the invocation was stopped while waiting to try again

err-interrupted-during-interval = the work was stopped while waiting between two readings

err-interrupted-during-flow = the invocation was stopped while the rows were still arriving

err-interrupted-between-statements = the invocation was stopped between two statements of the file
hint-interrupted-during-interval = run again once the destination is free

err-runtime-unavailable = the work runtime could not be started

err-concurrency-none-admitted = a ceiling of zero admits no work at all
hint-concurrency-none-admitted = ask for at least one simultaneous part

err-concurrency-above-ceiling = { $detail } simultaneous parts is above the ceiling of { $ceiling }
hint-concurrency-above-ceiling = ask for at most { $ceiling } simultaneous parts

err-concurrency-gate-closed = the admission gate was closed before the work started

err-output-broken-pipe = the output channel was closed by the reader

err-output-write-failed = the answer could not be written

err-output-not-serialisable = the answer could not be serialised

err-output-not-a-document = the answer is not an object and cannot carry a closing record

err-output-destination-unwritable = the destination of the answer cannot be written ({ $detail })
hint-output-destination-unwritable = point --output at a path inside a writable directory