mariadb-cli 0.1.1

One-shot agent-native command line client for MariaDB servers
Documentation
# Prose of the failures of stored settings, profiles, secrets and messages.
#
# The naming rule and the { $detail } rule are the ones stated in
# errors-usage.en.ftl.

err-config-stdin-unreadable = the standard input could not be read

err-config-report-not-serialisable = the diagnosis could not be written out

err-config-no-value = the setting { $detail } has no value in force
hint-config-no-value = { $decided ->
        [server] the server decides this one, so it has no stored value; use `config set { $setting }` to give it one
        [host] the host decides this one, so it has no stored value; use `config set { $setting }` to give it one
       *[unstored] no value was ever stored for it; use `config set { $setting }` to give it one
    }

err-config-unknown-key = { $detail } is not a setting of this product
hint-config-unknown-key = { $near ->
        [yes] did you mean `{ $candidate }`?
       *[no] run `config list` to see every setting
    }

err-config-value-outside-domain = the value { $detail } is not accepted by the setting `{ $setting }`
hint-config-value-outside-domain = { $domain ->
        [boolean] the accepted values are: { $accepted }
        [enumeration] the accepted values are: { $accepted }
        [positive-integer] give a whole number above zero
        [non-negative-integer] give a whole number from zero upwards
        [integer-in-range] give a whole number in the range { $accepted }
       *[text] give text that is not empty
    }

err-config-unreadable = the settings file could not be read ({ $detail })
hint-config-unreadable = check that the file is readable by this user

err-config-malformed = the settings file cannot be read as stored settings ({ $detail })
hint-config-malformed = run `config doctor` to see what is wrong, or remove the file to start over

err-config-directory-not-writable = the settings directory could not be created ({ $detail })
hint-config-directory-not-writable = check that this user may write there

err-config-not-serialisable = the settings could not be written out

err-config-not-writable = the settings could not be written ({ $detail })
hint-config-not-writable = check that this user may write there

err-config-permission-not-applied = the settings file could not be narrowed to its owner
hint-config-permission-not-applied = the product refuses to store a setting it cannot protect

err-config-no-home-directory = this host does not say where a user's files belong
hint-config-no-home-directory = pass --config-dir to name the location yourself

err-config-malformed-destination = the destination text is not a form the driver accepts
hint-config-malformed-destination = write the destination as scheme://user@host:port/database

err-config-named-unreadable = the stored statements could not be read

err-config-named-malformed = the stored statements are not in the form this product writes

err-config-named-unwritable = the stored statements could not be written

err-config-argument-missing = this command needs something to work on ({ $detail })
hint-config-argument-missing = write the call in the published form ({ $detail })

err-config-key-without-a-usable-value = the setting carries no value this build can use ({ $detail })
hint-config-key-without-a-usable-value = this is a defect in the setting registry, not in the invocation

err-config-registry-defect = the built-in setting registry does not carry what this build reads from it ({ $detail })
hint-config-registry-defect = this is a defect in the built-in setting registry, not in the call

err-config-declared-name-is-not-one = that is not a name a session adjustment can declare ({ $detail })
hint-config-declared-name-is-not-one = use a plain name such as utf8mb4, UTC, +00:00 or Europe/Lisbon

err-config-unknown-binary-shape = that is not a shape a byte value can take ({ $detail })
hint-config-unknown-binary-shape = set output.binary to summary or to full

err-config-unknown-ephemeral-notice = that is not a moment the notice can be raised at ({ $detail })
hint-config-unknown-ephemeral-notice = set sql.ephemeral_notice to on_create or to always

err-config-unknown-export-lock = that is not something a copy can hold still ({ $detail })
hint-config-unknown-export-lock = set data.export_lock to none or to tables

err-config-unknown-policy-scope = that is not a reach a policy can have ({ $detail })
hint-config-unknown-policy-scope = set sql.policy_scope to change or to all

err-config-unknown-readonly-probe = that is not a frequency the destination can be asked at ({ $detail })
hint-config-unknown-readonly-probe = set server.readonly_probe to once or to always

err-config-unknown-root-store = that is not a source of trusted authorities ({ $detail })
hint-config-unknown-root-store = set tls.root_store to system, to bundled or to file

err-config-unknown-secret-storage = `{ $detail }` is not a way of keeping a secret
hint-config-unknown-secret-storage = set secret.storage_mode to file or to none

err-config-unknown-tls-verify = that is not a level this build checks a certificate at ({ $detail })
hint-config-unknown-tls-verify = set tls.verify to full, to ca or to none

err-config-unverified-tls-unacknowledged = `{ $detail }` is set to trust an unknown authority, which is the check that tells the server apart from an impostor
hint-config-unverified-tls-unacknowledged = pass --accept-unverified-tls to take that risk for this invocation, or set tls.verify to full or to ca

err-config-port-out-of-range = the stored port { $detail } is past the highest a server can listen on
hint-config-port-out-of-range = choose a number from 1 to 65535

err-profile-no-destination = the profile `{ $profile }` names neither a host nor a socket
hint-profile-no-destination = set a host with --host, or a local socket with --socket

err-profile-store-unreadable = the profile store cannot be read
hint-profile-store-unreadable = check the permissions of the configuration directory

err-profile-store-malformed = the profile store is not in the expected form
hint-profile-store-malformed = repair the file by hand, or remove it to start from an empty store

err-profile-empty-name = a profile name may not be empty

err-profile-already-exists = a profile of that name already exists ({ $detail })
hint-profile-already-exists = change it with `conn edit`, or remove it first

err-profile-unknown = { $named ->
        [default] `conn.default` names { $detail } and no profile stored on this machine carries that name
       *[caller] no profile stored on this machine has that name ({ $detail })
    }
hint-profile-unknown = run `conn list` to see the stored profiles

err-profile-no-default = no profile was named and none is marked as the default
hint-profile-no-default = name one with --profile, or mark one with `conn default`

err-profile-store-path-invalid = the profile store path has no directory

err-profile-store-directory-unwritable = the configuration directory cannot be created

err-profile-store-unserialisable = the profile store cannot be written in the expected form

err-profile-store-unwritable = the profile store cannot be written

err-profile-store-permissions = the profile store could not be restricted to its owner

err-profile-store-not-replaced = the profile store could not be replaced

err-profile-name-missing = this command needs the name of a profile to work on
hint-profile-name-missing = write the call in the published form ({ $detail })

err-profile-none-stored = there is no destination stored on this host to run against
hint-profile-none-stored = add one with `conn add`

err-profile-pinned-database-missing = the profile `{ $profile }` fixes its database without naming one
hint-profile-pinned-database-missing = name it in the same call, as in `--database loja --pin-database`

err-profile-database-is-pinned = the profile `{ $profile }` is fixed on database `{ $pinned }` and takes no database parameter, so `{ $named }` cannot be honoured
hint-profile-database-is-pinned = drop --database, or point at a destination whose database is not fixed; `conn edit { $profile } --pin-database false` releases this one

err-secret-unreadable = the secret could not be read from the standard input
hint-secret-unreadable = pipe the secret in, as in `printf %s "$SECRET" | mariadb-cli conn add ...`

err-secret-empty = the standard input carried no secret
hint-secret-empty = pipe the secret in, or leave --password-stdin out

err-vault-secret-missing = the profile has no secret recorded ({ $detail })
hint-vault-secret-missing = record one with `conn edit <name> --password-stdin`

err-vault-keeps-nothing = this host keeps no secret, so the one offered was not written down
hint-vault-keeps-nothing = supply it on every invocation, or allow storage with `config set secret.storage_mode file`

err-tls-not-available = this build carries no network encryption
hint-tls-not-available = install a build with the encryption feature enabled, or drop the encryption request

err-tls-key-missing = a client certificate was named without its key
hint-tls-key-missing = name the matching key with --client-key

err-tls-certificate-missing = a client key was named without its certificate
hint-tls-certificate-missing = name the matching certificate with --client-cert

err-tls-no-authority-named = the trust source is the named authority and this destination names none
hint-tls-no-authority-named = name an authority with --ca, or set tls.root_store to system

err-tls-no-provider = no cryptography provider could be installed for the encrypted channel
hint-tls-no-provider = reinstall with the default features, which carry the encrypted channel

err-tls-no-suite-for-floor = this build carries no cipher suite for the protocol floor asked for ({ $detail })
hint-tls-no-suite-for-floor = lower tls.min_version, or install a build whose provider offers that version

err-dsn-malformed = the destination could not be read ({ $detail })
hint-dsn-malformed = write it as scheme://user:secret@host:port/database

err-log-destination-unwritable = the diagnostic directory cannot be written to ({ $detail })
hint-log-destination-unwritable = point `log.to_file` at a writable directory, or set it to false

err-log-already-installed = the auxiliary channel was already installed for this process

err-i18n-missing-catalogue = this build carries no messages for the language { $detail }
hint-i18n-missing-catalogue = the languages this build carries are: { $languages }

err-i18n-malformed-catalogue = the messages carried for that language are not readable ({ $detail })

err-i18n-duplicate-message = the messages carried for that language name the same message twice ({ $detail })

err-i18n-unsupported-language = { $detail } is not a language this build carries
hint-i18n-unsupported-language = the languages this build carries are: { $languages }

err-i18n-unsupported-stored-language = the stored language { $detail } is not carried by this build
hint-i18n-unsupported-stored-language = the languages this build carries are: { $languages }

err-config-tls-refused-certificate = the server was reached and its certificate was refused
hint-config-tls-refused-certificate = name the authority with `--ca`, or set `tls.verify` to what this destination can prove