[Python-checkins] CVS: python/dist/src/Doc/lib libsys.tex,1.46,1.47

Martin v. L?wis loewis@users.sourceforge.net
Wed, 18 Jul 2001 09:17:18 -0700


Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv17889/Doc/lib

Modified Files:
	libsys.tex 
Log Message:
Patch #412229: Add functions sys.getdlopenflags and sys.setdlopenflags.
Add dlopenflags to PyInterpreterState, and use it in dlopen calls.


Index: libsys.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libsys.tex,v
retrieving revision 1.46
retrieving revision 1.47
diff -C2 -r1.46 -r1.47
*** libsys.tex	2001/03/23 05:17:41	1.46
--- libsys.tex	2001/07/18 16:17:16	1.47
***************
*** 181,184 ****
--- 181,191 ----
  \end{funcdesc}
  
+ \begin{funcdesc}{getdlopenflags}{}
+  Return the current value of the flags that are used for \code{dlopen}
+  calls. The flag constants are defined in the \refmodule{dl} and
+  \module{DLFCN} modules.
+  \versionadded{2.2}
+ \end{funcdesc}
+ 
  \begin{funcdesc}{getrefcount}{object}
  Return the reference count of the \var{object}.  The count returned is
***************
*** 332,335 ****
--- 339,356 ----
  %  case this function will remain available.
    \versionadded{2.0}
+ \end{funcdesc}
+ 
+ \begin{funcdesc}{sertdlopenflags}{n}
+  Set the flags that will be used for \code{dlopen()} calls, i.e. when
+  the interpreter loads extension modules. Among other things, this
+  will enable a lazy resolving of symbols when imporing a module, if
+  called as \code{sys.setdlopenflags(0)}. To share symols across
+  extension modules, call as
+  \code{sys.setdlopenflags(dl.RTLD_NOW|dl.RTLD_GLOBAL)}.  The symbolic
+  names for the flag modules can be either found in the \refmodule{dl}
+  module, or in the \module{DLFCN} module. If \module{DLFCN} is not
+  available, it can be generated from \code{/usr/include/dlfcn.h} using
+  the \code{h2py} script.
+  \versionadded{2.2}
  \end{funcdesc}