summaryrefslogtreecommitdiff
path: root/source4/scripting/swig/README
diff options
context:
space:
mode:
authorTim Potter <tpot@samba.org>2004-09-19 23:34:20 +0000
committerGerald (Jerry) Carter <jerry@samba.org>2007-10-10 12:58:51 -0500
commitcb3cacdf402d91722b67b494f36abac0280fc5b9 (patch)
treeaab0a31d5321e753fe4610c8de0f71513870f96d /source4/scripting/swig/README
parent20f39507c52d137a0b53625b50bbbadf51013d19 (diff)
downloadsamba-cb3cacdf402d91722b67b494f36abac0280fc5b9.tar.gz
samba-cb3cacdf402d91722b67b494f36abac0280fc5b9.tar.bz2
samba-cb3cacdf402d91722b67b494f36abac0280fc5b9.zip
r2423: Add some instructions for building extensions.
(This used to be commit 7a7cf9f3521535da47895d1a516c8572f7f34e40)
Diffstat (limited to 'source4/scripting/swig/README')
-rw-r--r--source4/scripting/swig/README37
1 files changed, 37 insertions, 0 deletions
diff --git a/source4/scripting/swig/README b/source4/scripting/swig/README
new file mode 100644
index 0000000000..561c5ab279
--- /dev/null
+++ b/source4/scripting/swig/README
@@ -0,0 +1,37 @@
+README for Samba SWIG Python extensions
+---------------------------------------
+
+Instructions for building:
+
+1. Run configure with the --with-python option to enable python
+ extensions.
+
+2. Edit the script/build_idl.sh script to pass the --swig option to
+ pidl. Here's a patch:
+
+Index: script/build_idl.sh
+===================================================================
+--- script/build_idl.sh (revision 2413)
++++ script/build_idl.sh (working copy)
+@@ -4,7 +4,7 @@
+
+ [ -d librpc/gen_ndr ] || mkdir -p librpc/gen_ndr || exit 1
+
+-PIDL="$PERL ./build/pidl/pidl.pl --output librpc/gen_ndr/ndr_ --parse --header --parser --server"
++PIDL="$PERL ./build/pidl/pidl.pl --output librpc/gen_ndr/ndr_ --parse --header --parser --server --swig"
+ TABLES="$PERL ./build/pidl/tables.pl --output librpc/gen_ndr/tables"
+
+ if [ x$FULLBUILD = xFULL ]; then
+
+3. Run 'make idl_full swig' to build extensions.
+
+4. At some stage there will be a proper system for installing the
+ extensions, but right now it's easier to run them in place. Set
+ your PYTHONPATH to include the modules. From the Samba source
+ directory, run:
+
+ export PYTHONPATH=`pwd`/scripting/swig
+
+Now you can go nuts and use the extensions. Check the
+scripting/swig/torture directory for a testsuite. There will
+hopefully be a bunch of usage examples somewhere. \ No newline at end of file