annotate contrib/splicex/README @ 706:de6fd9fc14e5 draft

SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
author d3v11 <d3v11@d3v11.ano>
date Sat, 29 Oct 2011 11:37:41 -0400
parents dc8f88270f6a
children 67aa934958cf
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
1 __________ _ _ __ __ ______
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
2 / / / / ___| _ __ | (_) ___ ___\ \/ / / / / /
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
3 / / / /\___ \| '_ \| | |/ __/ _ \\ / / / / /
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
4 / / / / ___) | |_) | | | (_| __// \ / / / /
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
5 /_/_/_/ |____/| .__/|_|_|\___\___/_/\_\/_/_/_/
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
6 |_|
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
7
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
8 .:Brute Force Utilities For GNU/Linux:.
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
9
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
10 SpliceX is free software: you can redistribute it and/or modify it under
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
11 the terms of the GNU General Public License as published by the Free
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
12 Software Foundation, either version 3 of the License, or (at your option)
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
13 any later version.
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
14
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
15 SpliceX is distributed in the hope that it will be useful, but WITHOUT
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
16 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
17 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
18 for more details. http://www.gnu.org/licenses/
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
19
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
20 AUTHOR:
697
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
21
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
22 d3v11 <d3v11@d3v11.ano>
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
23
697
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
24
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
25
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
26 (UN)INSTALL:
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
27
705
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
28 You may optionally install splicex with cython. Doing so takes
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
29 longer to install because of compile times but splicex will
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
30 also be 20% to 35% faster, depending on your system. I recommend
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
31 this option if you intend on putting splicex to long-term use.
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
32 If your goal is simply to test, try, and/or debug splicex then
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
33 using the pythonic install will be more practical.
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
34
706
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
35 NOTES:
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
36
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
37 If you installed Python from source you can ignore
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
38 the python-dev dependency below. However, your source
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
39 install of Python must have the development files. IE:
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
40
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
41 tar xvf Python-*.tgz
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
42 cd Python-*
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
43 ./configure --with-pydebug
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
44 make install
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
45
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
46 This generates Python.h and structmember.h, which are
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
47 need for gcc to compile splicex.
de6fd9fc14e5 SpliceX patched compiler for /path/to/Python.h and /path/to/structmember.h
d3v11 <d3v11@d3v11.ano>
parents: 705
diff changeset
48
705
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
49 DEPENDS ON:
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
50
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
51 python (>=2.6), python-dev(>=2.6), cython (>=0.12.1),
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
52 gcc (>=4.4.3), bash (>=4.1.5), man (>=2.5.7)
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
53
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
54 SOURCE:
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
55
705
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
56 ./configure <python[version]>
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
57 make compile
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
58 make install
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
59
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
60 DEBIAN/UBUNTU:
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
61
705
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
62 ./configure <python[version]>
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
63 make compile
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
64 make install-deb
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
65
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
66 UNINSTALL:
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
67
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
68 SOURCE:
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
69 make uninstall
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
70
705
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
71 DEBIAN/UBUNTU:
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
72 apt-get remove splicex
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
73
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
74 PYTHONIC (UN)INSTALL:
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
75
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
76 You make optionally install splicex as pure python.
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
77 Install times are quick but splicex will be 20% to 35%
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
78 slower than compiling an executable binary with the
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
79 cython + gcc option above. I recommend using this option
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
80 if you simply want to test, try, and/or debug splicex.
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
81
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
82 DEPENDS ON:
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
83
705
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
84 python (>=2.6), bash (>=4.1.5), man (>=2.5.7)
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
85
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
86 SOURCE:
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
87
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
88 ./configure <python[version]> --no-compile
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
89 make pyinstall
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
90
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
91 DEBIAN/UBUNTU:
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
92
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
93 ./configure <python[version]> --no-compile
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
94 make pyinstall-deb
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
95
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
96 UNINSTALL:
697
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
97
705
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
98 SOURCE:
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
99 make uninstall
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
100
705
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
101 DEBIAN/UBUNTU:
dc8f88270f6a SpliceX update: pyinstall added
d3v11 <d3v11@d3v11.ano>
parents: 697
diff changeset
102 apt-get remove splicex
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
103
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
104 TOOLS:
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
105
697
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
106 SpliceX includes brute forcing tools. Each tool will
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
107 include a README file in its respected folder(s):
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
108
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
109 ls tools/*
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
110
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
111 UPDATE:
697
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
112
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
113 d3v11's AnoNet(2) update for splicex:
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
114
697
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
115 make update
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
116
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
117 HELP AND USAGE:
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
118
697
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
119 To obtain additional information on how to use splicex
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
120 enter either of the following commands after installation:
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
121
697
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
122 splicex --help
a554ba2c1e81 SpliceX now compiles to true binary
d3v11 <d3v11@d3v11.ano>
parents: 692
diff changeset
123 splicex --rtfm
692
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
124
070666f04505 SpliceX fix
d3v11 <d3v11@d3v11.ano>
parents:
diff changeset
125