ndb_perrorshows information about an NDB error, given its error code. This includes the error message, the type of error, and whether the error is permanent or temporary. This is intended as a drop-in replacement forperror--ndb
, which is no longer supported.
Usage
ndb_perror [options]error_code
ndb_perrordoes not need to access a running NDB Cluster, or any nodes (including SQL nodes). To view information about a given NDB error, invoke the program, using the error code as an argument, like this:
shell> ndb_perror 323 NDB error code 323: Invalid nodegroup id, nodegroup already existing: Permanent error: Application error
To display only the error message, invokendb_perrorwith the--silent
option (short form-s
), as shown here:
shell> ndb_perror -s 323 Invalid nodegroup id, nodegroup already existing: Permanent error: Application error
Likeperror,ndb_perroraccepts multiple error codes:
shell> ndb_perror 321 1001 NDB error code 321: Invalid nodegroup id: Permanent error: Application error NDB error code 1001: Illegal connect string
Additional program options forndb_perrorare described later in this section.
ndb_perrorreplacesperror--ndb
, which is no longer supported by NDB Cluster. To make substitution easier in scripts and other applications that might depend onperrorfor obtaining NDB error information,ndb_perrorsupports its own“dummy”--ndb
option, which does nothing.
The following table includes all options that are specific to the NDB Cluster programndb_perror. Additional descriptions follow the table.
Table 23.38 Command-line options used with the program ndb_perror
Format | Description | Added, Deprecated, or Removed |
---|---|---|
Read given file after global files are read | (Supported in all NDB releases based on MySQL 8.0) |
|
Read default options from given file only | (Supported in all NDB releases based on MySQL 8.0) |
|
Also read groups with concat(group, suffix) | (Supported in all NDB releases based on MySQL 8.0) |
|
Display help text | (Supported in all NDB releases based on MySQL 8.0) |
|
Read given path from login file | (Supported in all NDB releases based on MySQL 8.0) |
|
For compatibility with applications depending on old versions of perror; does nothing | (Supported in all NDB releases based on MySQL 8.0) |
|
Do not read default options from any option file other than login file | (Supported in all NDB releases based on MySQL 8.0) |
|
Print program argument list and exit | (Supported in all NDB releases based on MySQL 8.0) |
|
Show error message only | (Supported in all NDB releases based on MySQL 8.0) |
|
Print program version information and exit | (Supported in all NDB releases based on MySQL 8.0) |
|
Verbose output; disable with --silent | (Supported in all NDB releases based on MySQL 8.0) |
Additional Options
-
Command-Line Format --defaults-extra-file=path
Type String Default Value [none]
Read given file after global files are read.
-
Command-Line Format --defaults-file=path
Type String Default Value [none]
Read default options from given file only.
-
Command-Line Format --defaults-group-suffix=string
Type String Default Value [none]
Also read groups with concat(group, suffix).
-
Command-Line Format --help
Type Boolean Default Value TRUE
Display program help text and exit.
-
Command-Line Format --login-path=path
Type String Default Value [none]
Read given path from login file.
-
Command-Line Format --ndb
Type Boolean Default Value TRUE
For compatibility with applications depending on old versions ofperrorthat use that program's
--ndb
option. The option when used withndb_perrordoes nothing, and is ignored by it. -
Command-Line Format --no-defaults
Do not read default options from any option file other than login file.
-
Command-Line Format --print-defaults
Print program argument list and exit.
-
Command-Line Format --silent
Type Boolean Default Value TRUE
Show error message only.
-
Command-Line Format --version
Type Boolean Default Value TRUE
Print program version information and exit.
-
Command-Line Format --verbose
Type Boolean Default Value TRUE
Verbose output; disable with
--silent
.