unix/SysLibrary.cpp
Go to the documentation of this file.
1 /*----------------------------------------------------------------------------*/
2 /* */
3 /* Copyright (c) 1995, 2004 IBM Corporation. All rights reserved. */
4 /* Copyright (c) 2005-2009 Rexx Language Association. All rights reserved. */
5 /* */
6 /* This program and the accompanying materials are made available under */
7 /* the terms of the Common Public License v1.0 which accompanies this */
8 /* distribution. A copy is also available at the following address: */
9 /* http://www.ibm.com/developerworks/oss/CPLv1.0.htm */
10 /* */
11 /* Redistribution and use in source and binary forms, with or */
12 /* without modification, are permitted provided that the following */
13 /* conditions are met: */
14 /* */
15 /* Redistributions of source code must retain the above copyright */
16 /* notice, this list of conditions and the following disclaimer. */
17 /* Redistributions in binary form must reproduce the above copyright */
18 /* notice, this list of conditions and the following disclaimer in */
19 /* the documentation and/or other materials provided with the distribution. */
20 /* */
21 /* Neither the name of Rexx Language Association nor the names */
22 /* of its contributors may be used to endorse or promote products */
23 /* derived from this software without specific prior written permission. */
24 /* */
25 /* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS */
26 /* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT */
27 /* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS */
28 /* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT */
29 /* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, */
30 /* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED */
31 /* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, */
32 /* OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY */
33 /* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING */
34 /* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS */
35 /* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */
36 /* */
37 /*----------------------------------------------------------------------------*/
38 /******************************************************************************/
39 /* REXX Shared runtime */
40 /* */
41 /* Unix implementation of the SysLibrary */
42 /* */
43 /******************************************************************************/
44 
45 #ifdef HAVE_CONFIG_H
46 # include "config.h"
47 #endif
48 
49 #include "SysLibrary.hpp"
50 #include <stdlib.h>
51 #include <string.h>
52 #include <stdio.h>
53 #include <dlfcn.h>
54 
55 
56 #define MAX_LIBRARY_NAME_LENGTH 250
57 #define LIBARY_NAME_BUFFER_LENGTH (MAX_LIBRARY_NAME_LENGTH + sizeof("/usr/lib/lib") + sizeof(ORX_SHARED_LIBRARY_EXT))
58 
60 {
61  libraryHandle = NULL;
62 }
63 
64 
66  const char *name) /* required procedure name */
67 /******************************************************************************/
68 /* Function: Resolve a named procedure in a library */
69 /******************************************************************************/
70 {
71  return dlsym(libraryHandle, name);
72 }
73 
74 
76  const char *name) /* required library name */
77 /******************************************************************************/
78 /* Function: Load a named library, returning success/failure flag */
79 /******************************************************************************/
80 {
81  char nameBuffer[LIBARY_NAME_BUFFER_LENGTH];
82 
83  if (strlen(name) > MAX_LIBRARY_NAME_LENGTH)
84  {
85  return false;
86  }
87 
88  snprintf(nameBuffer, sizeof nameBuffer, "lib%s%s", name, ORX_SHARED_LIBRARY_EXT);
89  // try loading directly
90  libraryHandle = dlopen(nameBuffer, RTLD_LAZY);
91  // if not found, then try from /usr/lib
92  if (libraryHandle == NULL)
93  {
94  snprintf(nameBuffer, sizeof nameBuffer, "/usr/lib/lib%s%s", name, ORX_SHARED_LIBRARY_EXT);
95  libraryHandle = dlopen(nameBuffer, RTLD_LAZY);
96  // still can't find it?
97  if (libraryHandle == NULL)
98  {
99  return false;
100  }
101  }
102  return true; // loaded successfully
103 }
104 
105 
106 /**
107  * Free a loaded library if the library is still loaded.
108  *
109  * @return True if we unloaded ok, false otherwise.
110  */
112 {
113  if (libraryHandle != NULL)
114  {
115  dlclose(libraryHandle);
116  return true;
117  }
118  return false;
119 }
void * getProcedure(const char *name)
void * libraryHandle
bool load(const char *name)
#define MAX_LIBRARY_NAME_LENGTH
#define LIBARY_NAME_BUFFER_LENGTH