summaryrefslogtreecommitdiff
path: root/source4/scripting/swig
diff options
context:
space:
mode:
Diffstat (limited to 'source4/scripting/swig')
-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