pwn 0.5.2 → 0.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c00a83379a700092db7c7216a4512822ac070975c5af3311de7727c1348894e
-  data.tar.gz: 298645aed83ccec72c6bf7d9ed3aa956a04a66277aaf964a380a313f5c815e8f
+  metadata.gz: 23bb25690e9f35296d04db4e6fbeaa297e15d86cad02b8329b740f00fa8e0032
+  data.tar.gz: df62daebc188a98c48fca439f86d58418a29fdc8bf0b7cd38fcf3debb858d82e
 SHA512:
-  metadata.gz: 9836240965a052fa5d018b60af85dfd7484428f5c5d0e809fad9950d206b5ac2ee39552b624785e819c0d057e9563fd47beb0d18f87258226ba6d97275a3819b
-  data.tar.gz: 971a59c78d6a25ab4b2406e416de1b90ee0e8cb9c91a0e098c0ae936336c06acc061868ff396a2e1328fba260a12a1693ae7c66251213e508cfdbb7fb12fe6c4
+  metadata.gz: d3f464f188dd4c0e04982b0e4d61f7b45e4afa4b028b01de37ca834fe53b49edaff0369a40d975c855c8432b09021e13d1200dbbbd30a039006b96542d534f26
+  data.tar.gz: 5984d6629d44b1c12cd09f5c811a9c238fb302b72b6b6964dc440f9ddf77accc2756ce746d7488b8fc1c7dce835bc18b432c9dba3e50300f1627236c12065628

data/README.md

@@ -37,7 +37,7 @@ $ cd /opt/pwn
 $ ./install.sh
 $ ./install.sh ruby-gem
 $ pwn
-pwn[v0.5.2]:001 >>> PWN.help
+pwn[v0.5.3]:001 >>> PWN.help
 ```
 
 [![Installing the pwn Security Automation Framework](https://raw.githubusercontent.com/0dayInc/pwn/master/documentation/pwn_install.png)](https://youtu.be/G7iLUY4FzsI)
@@ -52,7 +52,7 @@ $ rvm use ruby-3.3.0@pwn
 $ gem uninstall --all --executables pwn
 $ gem install --verbose pwn
 $ pwn
-pwn[v0.5.2]:001 >>> PWN.help
+pwn[v0.5.3]:001 >>> PWN.help
 ```
 
 If you're using a multi-user install of RVM do:
@@ -62,7 +62,7 @@ $ rvm use ruby-3.3.0@pwn
 $ rvmsudo gem uninstall --all --executables pwn
 $ rvmsudo gem install --verbose pwn
 $ pwn
-pwn[v0.5.2]:001 >>> PWN.help
+pwn[v0.5.3]:001 >>> PWN.help
 ```
 
 PWN periodically upgrades to the latest version of Ruby which is reflected in `/opt/pwn/.ruby-version`.  The easiest way to upgrade to the latest version of Ruby from a previous PWN installation is to run the following script:

data/lib/pwn/plugins/xxd.rb

@@ -100,31 +100,31 @@ module PWN
       #    INFO: hit breakpoint at: 0x562e8547d139
       #    [0x562e8547d139]> db
       #    ```
-      # 2. Populate start_addr w/ address (i.e. '0x562e8547d139') of a known function (e.g. main)
-      # 3. Step down to the instruction you want to set a breakpoint. Record its address...
+      # 2. Populate start_addr w/ address (i.e. '0x562e8547d139') of a known function (i.e. main)
+      # 3. Step down to the instruction where you want to set a breakpoint. Record its address...
       #    this is the target_addr.
       #    ```
       #    [0x562e8547d139]> v
-      #    <step through to target instruction via F7/F8>
+      #    <step through to the target instruction via F7/F8>
       #    ```
-      # 4. Get the hex offset value by calling this method
+      # 4. Get the hex offset value by calling PWN::Plugins::XXD.calc_addr_offset method
       # 5. Future breakpoints can be calculated by adding the hex offset to the
       #    updated start_addr (which changes every time the binary is executed).
-      #    If the offset returned is `0x00000ec2` a breakpoint in r2 can be set via:
+      #    If the offset returned is `0x00000ec2`, a breakpoint for the target
+      #    instruction can be set in r2 via:
       #    ```
       #    [0x00001050]> ood
-      #    INFO: hit breakpoint at: 0x55ee0a0e5139
       #    [0x7f1a45bea360]> db main
       #    [0x7f1a45bea360]> db (main)+0x00000ec2
       #    [0x7f1a45bea360]> db
       #    0x558eebd75139 - 0x558eebd7513a 1 --x sw break enabled valid ...
       #    0x558eebd75ffb - 0x558eebd75ffc 1 --x sw break enabled valid ...
+      #    [0x7f1a45bea360]> dc
+      #    INFO: hit breakpoint at: 0x55ee0a0e5139
       #    [0x55ee0a0e5139]> dc
-      #    [0x7feddfd2d360]> dc
-      #    INFO: hit breakpoint at: 0x558eebd75139
       #    INFO: hit breakpoint at: 0x5558c3101ffb
       #    [0x5558c3101ffb]> v
-      #    <step through via F7, F8, F9, etc. to get to desired breakpoint>
+      #    <step through via F7, F8, F9, etc. to get to desired instruction>
       #    ```
 
       def self.calc_addr_offset(opts = {})
@@ -245,31 +245,31 @@ module PWN
           #    INFO: hit breakpoint at: 0x562e8547d139
           #    [0x562e8547d139]> db
           #    ```
-          # 2. Populate start_addr w/ address (i.e. '0x562e8547d139') of a known function (e.g. main)
-          # 3. Step down to the instruction you want to set a breakpoint. Record its address...
+          # 2. Populate start_addr w/ address (i.e. '0x562e8547d139') of a known function (i.e. main)
+          # 3. Step down to the instruction where you want to set a breakpoint. Record its address...
           #    this is the target_addr.
           #    ```
           #    [0x562e8547d139]> v
-          #    <step through to target instruction via F7/F8>
+          #    <step through to the target instruction via F7/F8>
           #    ```
-          # 4. Get the hex offset value by calling this method
+          # 4. Get the hex offset value by calling #{self}.calc_addr_offset method
           # 5. Future breakpoints can be calculated by adding the hex offset to the
           #    updated start_addr (which changes every time the binary is executed).
-          #    If the offset returned is `0x00000ec2` a breakpoint in r2 can be set via:
+          #    If the offset returned is `0x00000ec2`, a breakpoint for the target
+          #    instruction can be set in r2 via:
           #    ```
           #    [0x00001050]> ood
-          #    INFO: hit breakpoint at: 0x55ee0a0e5139
           #    [0x7f1a45bea360]> db main
           #    [0x7f1a45bea360]> db (main)+0x00000ec2
           #    [0x7f1a45bea360]> db
           #    0x558eebd75139 - 0x558eebd7513a 1 --x sw break enabled valid ...
           #    0x558eebd75ffb - 0x558eebd75ffc 1 --x sw break enabled valid ...
+          #    [0x7f1a45bea360]> dc
+          #    INFO: hit breakpoint at: 0x55ee0a0e5139
           #    [0x55ee0a0e5139]> dc
-          #    [0x7feddfd2d360]> dc
-          #    INFO: hit breakpoint at: 0x558eebd75139
           #    INFO: hit breakpoint at: 0x5558c3101ffb
           #    [0x5558c3101ffb]> v
-          #    <step through via F7, F8, F9, etc. to get to desired breakpoint>
+          #    <step through via F7, F8, F9, etc. to get to desired instruction>
           #    ```
 
           #{self}.reverse_dump(

data/lib/pwn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PWN
-  VERSION = '0.5.2'
+  VERSION = '0.5.3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pwn
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.5.3
 platform: ruby
 authors:
 - 0day Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport