*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> dlerror (3)              



NAME    [Toc]    [Back]

       dlerror - get diagnostic information

SYNOPSIS    [Toc]    [Back]

       #include <dlfcn.h>

       char *dlerror(void );

DESCRIPTION    [Toc]    [Back]

       The dlerror() function returns a null-terminated character
       string (with no trailing newline) that describes the  last
       error  that  occurred  in dynamic linking processing for a
       call to dlopen(), dlclose(), or dlsym().   If  no  dynamic
       linking  errors have occurred since the last invocation of
       dlerror(), dlerror() returns NULL.  Thus,  invoking  dlerror()
 a second time, immediately following a prior invocation,
 results in NULL being returned.

ERRORS    [Toc]    [Back]

       No errors are defined.

RETURN VALUE    [Toc]    [Back]

       If successful, dlerror() returns a null-terminated character
 string. Otherwise, NULL is returned.

APPLICATION USAGE    [Toc]    [Back]

       The  messages returned by dlerror() may reside in a static
       buffer that is overwritten  on  each  call  to  dlerror().
       Application code should not write to this buffer. Programs
       wishing to preserve an error message should make their own
       copies of that message. Depending on the application environment
 with respect  to  asynchronous  execution  events,
       such  as signals or other asynchronous computation sharing
       the address space,  portable  applications  should  use  a
       critical section to retrieve the error pointer and buffer.

SEE ALSO    [Toc]    [Back]

       dlclose(3), dlopen(3), dlsym(3)

[ Back ]
 Similar pages
Name OS Title
pciconf FreeBSD diagnostic utility for the PCI bus
diag0 HP-UX diagnostic interface to HP-PB I/O subsystem
lmdiag IRIX diagnostic checkout tool
diag1 HP-UX diagnostic interface to the PCI I/O subsystem
ipxdebug IRIX enable or disable diagnostic output from IPX
fmtmsg FreeBSD display a detailed diagnostic message
egcmd IRIX gigabit ethernet diagnostic tool
mptutil HP-UX Diagnostic utility for Ultra320 SCSI controllers and A7173A
clshm_diag IRIX obsolete diagnostic tool for CrayLink Shared Memory
dmesg HP-UX collect system diagnostic messages to form error log
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service