Skip to content

Commit 252afbb

Browse files
WraithWirelessWraithWireless
authored andcommitted
v0.1.4 updated setup.py
1 parent d94f5fb commit 252afbb

File tree

1 file changed

+5
-32
lines changed

1 file changed

+5
-32
lines changed

pyric/__init__.py

Lines changed: 5 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -69,10 +69,10 @@ def strerror(errno):
6969
version = __version__
7070
# define long description
7171
long_desc = """
72-
# PyRIC 0.1.4: Python Radio Interface Controller
73-
## Linux wireless library for the Python Wireless Developer and Pentester
72+
PyRIC 0.1.4: Python Radio Interface Controller
73+
Linux wireless library for the Python Wireless Developer and Pentester
7474
75-
## 1 DESCRIPTION:
75+
DESCRIPTION:
7676
PyRIC (is a Linux only) library providing wireless developers and pentesters the
7777
ability to identify, enumerate and manipulate their system's wireless cards
7878
programmatically in Python. Pentesting applications and scripts written in Python
@@ -99,33 +99,7 @@ def strerror(errno):
9999
features of ifconfig such as getting or setting the mac address and has recently
100100
implemented rkill support to soft block or unblock wireless cards.
101101
102-
### a. Additions to iw
103-
Several "extensions" have been added to iw:
104-
* Persistent sockets: pyw provides the caller with functions & ability to pass
105-
their own netlink (or ioctl socket) to pyw functions;
106-
* One-time request for the nl80211 family id: pyw stores the family id in a
107-
global variable
108-
* Consolidating different "reference" values to wireless NICs in one class
109-
(Cards are tuples t=(dev,phy #,ifindex)
110-
111-
These are minimal changes but they can improve the performance of any progams
112-
that needs to access the wireless nic repeatedly as shown in the table below.
113-
114-
| chset | Total | Avg | Longest | Shortest |
115-
|------------|----------|--------|-----------|----------|
116-
| Popen(iw) | 588.3059 | 0.0588 | 0.0682 | 0.0021 |
117-
| one-time | 560.3559 | 0.0560 | 0.0645 | 0.0003 |
118-
| persistent | 257.8293 | 0.0257 | 0.0354 | 0.0004 |
119-
120-
The table shows benchmarks for hop time on a Alfa AWUS036NH 10000 times. Note that
121-
there is no implication that PyRIC is faster than iw. Rather, the table shows that
122-
PyRIC is faster than using Popen to execute iw. Using one-time sockets, there is
123-
a difference of 28 seconds over Popen and iw with a small decrease in the average
124-
hoptime. Not a big difference. However, the performance increased dramatically when
125-
persistent netlink sockets are used with the total time and average hop time nearly
126-
halved.
127-
128-
### b. Current State
102+
CURRENT STATE
129103
ATT, PyRIC accomplishes my core needs but it is still a work in progress. It
130104
currently pyw provides the following:
131105
* enumerate interfaces and wireless interfaces
@@ -158,8 +132,7 @@ def strerror(errno):
158132
for those who wish to add additional commands. However, it pulls directly from
159133
the comments nl80211 header file and may be vague.
160134
161-
### c. What is PyRIC?
162-
135+
WHAT IS PyRIC?
163136
To avoid confusion, PyRIC is the system as a whole, including all header files
164137
and "libraries" that are required to communicate with the kernel. pyw is a
165138
interface to these libraries providing specific funtions.

0 commit comments

Comments
 (0)