uselib - load shared library


   #include <unistd.h>

   int uselib(const char *library);

   Note:  No declaration of this system call is provided in glibc headers;
   see NOTES.


   The system call uselib() serves to load a shared library to be used  by
   the  calling  process.   It  is given a pathname.  The address where to
   load is found  in  the  library  itself.   The  library  can  have  any
   recognized binary format.


   On  success,  zero is returned.  On error, -1 is returned, and errno is
   set appropriately.


   In addition to all of the error codes returned by open(2) and  mmap(2),
   the following may also be returned:

   EACCES The  library  specified by library does not have read or execute
          permission, or the caller does not have  search  permission  for
          one   of   the  directories  in  the  path  prefix.   (See  also

   ENFILE The system-wide limit on the total number of open files has been

          The  file  specified  by library is not an executable of a known
          type; for example, it does not have the correct magic numbers.


   uselib() is Linux-specific, and should not be used in programs intended
   to be portable.


   This obsolete system call is not supported by glibc.  No declaration is
   provided in glibc headers, but,  through  a  quirk  of  history,  glibc
   versions   before  2.23  did  export  an  ABI  for  this  system  call.
   Therefore, in order to employ this system call, it  was  sufficient  to
   manually  declare  the interface in your code; alternatively, you could
   invoke the system call using syscall(2).

   In ancient  libc  versions,  uselib()  was  used  to  load  the  shared
   libraries with names found in an array of names in the binary.

   Since  libc  4.3.2,  startup  code  tries  to  prefix  these names with
   "/usr/lib", "/lib" and "" before giving up.  In libc  4.3.4  and  later
   these names are looked for in the directories found in LD_LIBRARY_PATH,
   and if not found there, prefixes "/usr/lib", "/lib" and "/" are tried.

   From libc 4.4.4 on only the library "/lib/"  is  loaded,  so  that
   this  dynamic  library  can  load the remaining libraries needed (again
   using this call).  This is also the state of affairs in libc5.

   glibc2 does not use this call.

   Since Linux 3.15, this system call is available only when the kernel is
   configured with the CONFIG_USELIB option.


   ar(1),    gcc(1),   ld(1),   ldd(1),   mmap(2),   open(2),   dlopen(3),


   This page is part of release 4.09 of the Linux  man-pages  project.   A
   description  of  the project, information about reporting bugs, and the
   latest    version    of    this    page,    can     be     found     at

More Linux Commands

SDL_VideoDriverName(3) - Obtain the name of the video driver
The buffer pointed to by namebuf is filled up to a maximum of maxlen characters (include the NULL terminator) with the name of the initialised video driver. The

find_key_by_type_and_name(3) Find a key by type and name....
find_key_by_type_and_name() searches for a key with the given type and exact description, firstly in the thread, process and session keyrings to which a process

IsCursorKey(3) - keysym classification macros (Man Page)....
The IsCursorKey macro returns True if the specified KeySym is a cursor key. The IsFunctionKey macro returns True if the KeySym is a function key. The IsKeypadKe

pfbtops(1) - translate a PostScript font in .pfb format to A
pfbtops translates a PostScript font in .pfb format to ASCII, splitting overlong lines in text packets into smaller chunks. If pfb_file is omitted the pfb file

bootchart.conf(5) Boot performance analysis graphing tool co
When starting, systemd-bootchart will read the configuration file bootchart.conf. This configuration file determines logging parameters and graph output. OPTION

ldap_dn2dcedn(3) - LDAP DN handling routines (Man Page).....
These routines allow LDAP entry names (Distinguished Names, or DNs) to be obtained, parsed, converted to a user-friendly form, and tested. A DN has the form des

XkbKeySymsPtr(3) - Returns the pointer to the two-dimensiona
XkbKeySymsPtr.3 - The key width and number of groups associated with a key are used to form a small two-dimensional array of KeySyms for a key. This array may b

Encode::Alias(3pm) - alias definitions to encodings.........
Allows newName to be used as an alias for ENCODING . ENCODING may be either the name of an encoding or an encoding object (as described in Encode). Currently th

XSetClipRectangles(3) - GC convenience routines (Man Page)
The XSetClipOrigin function sets the clip origin in the specified GC. The clip-mask origin is interpreted relative to the origin of whatever destination drawabl

Tcl_ExprObj(3) - evaluate an expression - Linux manual page
These four procedures all evaluate an expression, returning the result in one of four different forms. The expression is given by the objPtr argument, and it ca

splashy-theme.xml(5) - a user-mode, POSIX and LSB compliant,
/etc/splashy/themes/*/theme.xml describes the themes behaviour The theme on which the file will have effect is the one which is contained in the same directory

mbrlen(3) - determine number of bytes in next multibyte char
The mbrlen() function inspects at most n bytes of the multibyte string starting at s and extracts the next complete multibyte character. It updates the shift st

We can't live, work or learn in freedom unless the software we use is free.