@@ -69,10 +69,10 @@ def strerror(errno):
6969version = __version__
7070# define long description
7171long_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:
7676PyRIC (is a Linux only) library providing wireless developers and pentesters the
7777ability to identify, enumerate and manipulate their system's wireless cards
7878programmatically in Python. Pentesting applications and scripts written in Python
@@ -99,33 +99,7 @@ def strerror(errno):
9999features of ifconfig such as getting or setting the mac address and has recently
100100implemented 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
129103ATT, PyRIC accomplishes my core needs but it is still a work in progress. It
130104currently pyw provides the following:
131105* enumerate interfaces and wireless interfaces
@@ -158,8 +132,7 @@ def strerror(errno):
158132for those who wish to add additional commands. However, it pulls directly from
159133the comments nl80211 header file and may be vague.
160134
161- ### c. What is PyRIC?
162-
135+ WHAT IS PyRIC?
163136To avoid confusion, PyRIC is the system as a whole, including all header files
164137and "libraries" that are required to communicate with the kernel. pyw is a
165138interface to these libraries providing specific funtions.
0 commit comments