Documentation Home
MySQL 5.7 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 38.1Mb
PDF (A4) - 38.1Mb
PDF (RPM) - 37.3Mb
HTML Download (TGZ) - 10.2Mb
HTML Download (Zip) - 10.3Mb
HTML Download (RPM) - 8.9Mb
Man Pages (TGZ) - 217.0Kb
Man Pages (Zip) - 329.8Kb
Info (Gzip) - 3.5Mb
Info (Zip) - 3.5Mb
Excerpts from this Manual

MySQL 5.7 Reference Manual  /  ...  /  ndb_perror — Obtain NDB error message information

21.4.17 ndb_perror — Obtain NDB error message information

ndb_perror shows 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. Added to the MySQL NDB Cluster distribution in NDB 7.6.4, it is intended as a drop-in replacement for perror --ndb.


ndb_perror [options] error_code

ndb_perror does 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, invoke ndb_perror with the --silent option (short form -s), as shown here:

shell> ndb_perror -s 323
Invalid nodegroup id, nodegroup already existing: Permanent error: Application error

Like perror, ndb_perror accepts 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 for ndb_perror are described later in this section.

ndb_perror replaces perror --ndb, which is deprecated as of NDB 7.6.4 and subject to removal in a future release of MySQL NDB Cluster. To make substitution easier in scripts and other applications that might depend on perror for obtaining NDB error information, ndb_perror supports its own dummy --ndb option, which does nothing.

The following table includes all options that are specific to the NDB Cluster program ndb_perror. Additional descriptions follow the table.

Table 21.100 This table describes command-line options for the ndb_perror program

Format Description Added or Removed



Display help text

ADDED: NDB 7.6.4


For compatibility with applications depending on old versions of perror; does nothing

ADDED: NDB 7.6.4



Show error message only

ADDED: NDB 7.6.4



Print program version information and exit

ADDED: NDB 7.6.4



Verbose output; disable with --silent

ADDED: NDB 7.6.4

Additional Options

  • --help, -?

    Command-Line Format--help
    Permitted ValuesTypeboolean

    Display program help text and exit.

  • --ndb

    Command-Line Format--ndb
    Permitted ValuesTypeboolean

    For compatibility with applications depending on old versions of perror that use that program's --ndb option. The option when used with ndb_perror does nothing, and is ignored by it.

  • --silent, -s

    Command-Line Format--silent
    Permitted ValuesTypeboolean

    Show error message only.

  • --version, -V

    Command-Line Format--version
    Permitted ValuesTypeboolean

    Print program version information and exit.

  • --verbose, -v

    Command-Line Format--verbose
    Permitted ValuesTypeboolean

    Verbose output; disable with --silent.

User Comments
Sign Up Login You must be logged in to post a comment.