'\" t
.\"     Title: \fBndb_perror\fR
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 09/06/2019
.\"    Manual: MySQL Database System
.\"    Source: MySQL 8.0
.\"  Language: English
.\"
.TH "\FBNDB_PERROR\FR" "1" "09/06/2019" "MySQL 8\&.0" "MySQL Database System"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ndb_perror \- obtain NDB error message information
.SH "SYNOPSIS"
.HP \w'\fBndb_perror\ \fR\fB\fIoptions\fR\fR\ 'u
\fBndb_perror \fR\fB\fIoptions\fR\fR
.SH "DESCRIPTION"
.PP
\fBndb_perror\fR
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
\fBperror\fR
\fB\-\-ndb\fR\&.
Usage
.sp
.if n \{\
.RS 4
.\}
.nf
ndb_perror [\fIoptions\fR] \fIerror_code\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBndb_perror\fR
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:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBndb_perror 323\fR
NDB error code 323: Invalid nodegroup id, nodegroup already existing: Permanent error: Application error
.fi
.if n \{\
.RE
.\}
.PP
To display only the error message, invoke
\fBndb_perror\fR
with the
\fB\-\-silent\fR
option (short form
\fB\-s\fR), as shown here:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBndb_perror \-s 323\fR
Invalid nodegroup id, nodegroup already existing: Permanent error: Application error
.fi
.if n \{\
.RE
.\}
.PP
Like
\fBperror\fR,
\fBndb_perror\fR
accepts multiple error codes:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBndb_perror 321 1001\fR
NDB error code 321: Invalid nodegroup id: Permanent error: Application error
NDB error code 1001: Illegal connect string
.fi
.if n \{\
.RE
.\}
.PP
Additional program options for
\fBndb_perror\fR
are described later in this section\&.
.PP
\fBndb_perror\fR
replaces
\fBperror\fR
\fB\-\-ndb\fR, 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
\fBperror\fR
for obtaining NDB error information,
\fBndb_perror\fR
supports its own
\(lqdummy\(rq
\fB\-\-ndb\fR
option, which does nothing\&.
.PP
The following table includes all options that are specific to the NDB Cluster program
\fBndb_perror\fR\&. Additional descriptions follow the table\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B Table\ \&22.339.\ \&Command\-line options for the ndb_perror program
.TS
allbox tab(:);
lB lB lB.
T{
Format
T}:T{
Description
T}:T{
Added, Deprecated, or Removed
T}
.T&
l l l
l l l
l l l
l l l
l l l.
T{
.PP
--help,
.PP
-?
T}:T{
Display help text
T}:T{
.PP
All NDB 8.0 releases
T}
T{
.PP
--ndb
T}:T{
For compatibility with applications depending on old versions of perror;
              does nothing
T}:T{
.PP
All NDB 8.0 releases
T}
T{
.PP
--silent,
.PP
-s
T}:T{
Show error message only
T}:T{
.PP
All NDB 8.0 releases
T}
T{
.PP
--version,
.PP
-V
T}:T{
Print program version information and exit
T}:T{
.PP
All NDB 8.0 releases
T}
T{
.PP
--verbose,
.PP
-v
T}:T{
Verbose output; disable with --silent
T}:T{
.PP
All NDB 8.0 releases
T}
.TE
.sp 1
Additional Options
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-help\fR,
\fB\-?\fR
.TS
allbox tab(:);
lB lB.
T{
Property
T}:T{
Value
T}
.T&
l l
l l
l l.
T{
\fBCommand-Line Format\fR
T}:T{
--help
T}
T{
\fBType\fR
T}:T{
Boolean
T}
T{
\fBDefault Value\fR
T}:T{
TRUE
T}
.TE
.sp 1
Display program help text and exit\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-ndb\fR
.TS
allbox tab(:);
lB lB.
T{
Property
T}:T{
Value
T}
.T&
l l
l l
l l.
T{
\fBCommand-Line Format\fR
T}:T{
--ndb
T}
T{
\fBType\fR
T}:T{
Boolean
T}
T{
\fBDefault Value\fR
T}:T{
TRUE
T}
.TE
.sp 1
For compatibility with applications depending on old versions of
\fBperror\fR
that use that program\*(Aqs
\fB\-\-ndb\fR
option\&. The option when used with
\fBndb_perror\fR
does nothing, and is ignored by it\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-silent\fR,
\fB\-s\fR
.TS
allbox tab(:);
lB lB.
T{
Property
T}:T{
Value
T}
.T&
l l
l l
l l.
T{
\fBCommand-Line Format\fR
T}:T{
--silent
T}
T{
\fBType\fR
T}:T{
Boolean
T}
T{
\fBDefault Value\fR
T}:T{
TRUE
T}
.TE
.sp 1
Show error message only\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-version\fR,
\fB\-V\fR
.TS
allbox tab(:);
lB lB.
T{
Property
T}:T{
Value
T}
.T&
l l
l l
l l.
T{
\fBCommand-Line Format\fR
T}:T{
--version
T}
T{
\fBType\fR
T}:T{
Boolean
T}
T{
\fBDefault Value\fR
T}:T{
TRUE
T}
.TE
.sp 1
Print program version information and exit\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-verbose\fR,
\fB\-v\fR
.TS
allbox tab(:);
lB lB.
T{
Property
T}:T{
Value
T}
.T&
l l
l l
l l.
T{
\fBCommand-Line Format\fR
T}:T{
--verbose
T}
T{
\fBType\fR
T}:T{
Boolean
T}
T{
\fBDefault Value\fR
T}:T{
TRUE
T}
.TE
.sp 1
Verbose output; disable with
\fB\-\-silent\fR\&.
.RE
.SH "COPYRIGHT"
.br
.PP
Copyright \(co 1997, 2019, Oracle and/or its affiliates. All rights reserved.
.PP
This documentation is free software; you can redistribute it and/or modify it only under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.
.PP
This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or see http://www.gnu.org/licenses/.
.sp
.SH "SEE ALSO"
For more information, please refer to the MySQL Reference Manual,
which may already be installed locally and which is also available
online at http://dev.mysql.com/doc/.
.SH AUTHOR
Oracle Corporation (http://dev.mysql.com/).