Add little meta note
[samba.git] / source / python / README
1 This directory contains Python bindings to allow you to access various
2 aspects of Samba.  At the moment their status is "experimental" and
3 they are not built by default.
4
5
6 ----
7 Quick Install Guide
8 --
9 Lines prepended with a $ indicate shell commands.
10
11 1. Requirements
12
13 In order to be able to compile samba-python you need to have
14 python and the python-dev packages installed.
15
16 2. Checking out the CVS HEAD branch of Samba and Samba-Python
17
18 In your shell, type:
19
20 $ cvs -d :pserver:cvs@pserver.samba.org:/cvsroot login
21
22 When asked for a password, type 'cvs'.
23
24 Now, type:
25
26 $ cvs -d :pserver:cvs@pserver.samba.org:/cvsroot co samba
27
28 This might probably take a while. When everything is downloaded,
29 check out the samba-python tree:
30
31 $ cvs -d :pserver:cvs@pserver.samba.org:/cvsroot co samba-python
32
33 Now that you have both cvs modules, move the directory 'samba-python' to 
34 inside the samba source tree, using: 
35
36 $ mv samba-python samba/source/python
37
38 Now, go to the samba/source directory and apply the samba-head.patch patch:
39
40 $ cd samba/source && patch -p0 < location/to/samba-python/samba-head.patch
41
42 You can now configure samba as usual and create the python extension:
43
44 $ autoconf
45 $ ./configure 
46 $ make python_ext
47
48 Now, you can install the modules:
49
50 $ cp build/lib.*/*.so /usr/lib/python2.1/lib-dynload/
51
52 (the directory /usr/lib/python2.1 may vary, depending on your installation)
53
54 Samba-python should work now!