'\" te
.\"  Copyright (c) 2007, Sun Microsystems, Inc.  All Rights Reserved
.TH dlpi_strerror 3DLPI "22 Aug 2007" "SunOS 5.11" "Data Link Provider Interface Library Functions"
.SH NAME
dlpi_strerror \- get DLPI error message
.SH SYNOPSIS
.LP
.nf
\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-ldlpi\fR [ \fIlibrary\fR... ]
#include <libdlpi.h>

\fBconst char *\fR\fBdlpi_strerror\fR(\fBint\fR \fIerr\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBdlpi_strerror()\fR function maps the error code in \fIerr\fR into an error message string and returns a pointer to that string.
.sp
.LP
If \fIerr\fR is \fBDL_SYSERR\fR, a string that describes the current value of \fBerrno\fR is returned. Otherwise, if \fIerr\fR corresponds to an error code listed in \fB<libdlpi.h>\fR or \fB<sys/dlpi.h>\fR, a string which describes that error is returned.
.sp
.LP
The string is not dynamically allocated and must not be freed by the caller.
.SH RETURN VALUES
.sp
.LP
Upon success, the function returns a pointer to the error message string. If the error code is unknown, the string "Unknown DLPI error" is returned.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for description of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelSafe
.TE

.SH SEE ALSO
.sp
.LP
\fBlibdlpi\fR(3LIB), \fBattributes\fR(5)