ronin-listener 0.1.0.rc1

data/man/ronin-listener-new-http.1

@@ -0,0 +1,38 @@
+.\" Generated by kramdown-man 1.0.0
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-listener-new-http 1 "2023-02-01" Ronin Listener "User Manuals"
+.SH SYNOPSIS
+.PP
+\fBronin-listener new http\fR \[lB]\fIoptions\fP\[rB] \[lB]\fIPATH\fP\[rB]
+.SH DESCRIPTION
+.PP
+Creates a new standalone HTTP listener Ruby script\.
+.SH ARGUMENTS
+.TP
+\fIPATH\fP
+The path to the new Ruby script file to create\.
+.SH OPTIONS
+.TP
+\fB-H\fR, \fB--host\fR \fIIP\fP
+The interface to listen on\. Defaults to \fB0.0.0.0\fR if not given\.
+.TP
+\fB-p\fR, \fB--port\fR \fIPORT\fP
+The port to listen on\. Defaults to \fB8080\fR if not given\.
+.TP
+\fB--vhost\fR \fIHOST\fP
+The \fBHost:\fR header to filter requests by\.
+.TP
+\fB-R\fR, \fB--root\fR \fIDIR\fP
+The root directory to filter requests by\.
+.TP
+\fB-h\fR, \fB--help\fR
+Print help information
+.SH AUTHOR
+.PP
+Postmodern 
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.SH SEE ALSO
+.PP
+.BR ronin\-listener\-new (1)
+.BR ronin\-listener\-new\-dns (1)

data/man/ronin-listener-new-http.1.md

@@ -0,0 +1,39 @@
+# ronin-listener-new-http 1 "2023-02-01" Ronin Listener "User Manuals"
+
+## SYNOPSIS
+
+`ronin-listener new http` [*options*] [*PATH*]
+
+## DESCRIPTION
+
+Creates a new standalone HTTP listener Ruby script.
+
+## ARGUMENTS
+
+*PATH*
+: The path to the new Ruby script file to create.
+
+## OPTIONS
+
+`-H`, `--host` *IP*
+: The interface to listen on. Defaults to `0.0.0.0` if not given.
+
+`-p`, `--port` *PORT*
+: The port to listen on. Defaults to `8080` if not given.
+
+`--vhost` *HOST*
+: The `Host:` header to filter requests by.
+
+`-R`, `--root` *DIR*
+: The root directory to filter requests by.
+
+`-h`, `--help`
+: Print help information
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+[ronin-listener-new](ronin-listener-new.1.md) [ronin-listener-new-dns](ronin-listener-new-dns.1.md)

data/man/ronin-listener-new.1

@@ -0,0 +1,56 @@
+.\" Generated by kramdown-man 1.0.1
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-listener-new 1 "2023-02-01" Ronin Listener "User Manuals"
+.SH NAME
+.PP
+ronin\-listener\-new \- Creates a new DNS or HTTP listener Ruby script
+.SH SYNOPSIS
+.PP
+\fBronin\-listener new\fR \[lB]\fIoptions\fP\[rB] \[lB]\fICOMMAND\fP\[rB]
+.SH DESCRIPTION
+.PP
+Creates a new DNS or HTTP listener Ruby script\.
+.SH ARGUMENTS
+.TP
+\fICOMMAND\fP
+The optional command to get detailed new information on\.
+.SH OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help information
+.SH COMMANDS
+.TP
+\fIdns\fP
+Generates a new standalone DNS listener Ruby script\.
+.TP
+\fIhttp\fP
+Generates a new standalone HTTP listener Ruby script\.
+.TP
+\fIhelp\fP
+Lists available \fBronin\-listener new\fR commands\.
+.SH EXAMPLES
+.PP
+Generate a new DNS listener Ruby script:
+.PP
+.RS 4
+.EX
+\[Do] ronin\-listener new dns file\.rb
+.EE
+.RE
+.PP
+Generate a new HTTP listener Ruby script:
+.PP
+.RS 4
+.EX
+\[Do] ronin\-listener new http file\.rb
+.EE
+.RE
+.SH AUTHOR
+.PP
+Postmodern 
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.SH SEE ALSO
+.PP
+.BR ronin\-listener\-new\-dns (1)
+.BR ronin\-listener\-new\-http (1)

data/man/ronin-listener-new.1.md

@@ -0,0 +1,52 @@
+# ronin-listener-new 1 "2023-02-01" Ronin Listener "User Manuals"
+
+## NAME
+
+ronin-listener-new - Creates a new DNS or HTTP listener Ruby script
+
+## SYNOPSIS
+
+`ronin-listener new` [*options*] [*COMMAND*]
+
+## DESCRIPTION
+
+Creates a new DNS or HTTP listener Ruby script.
+
+## ARGUMENTS
+
+*COMMAND*
+: The optional command to get detailed new information on.
+
+## OPTIONS
+
+`-h`, `--help`
+: Print help information
+
+## COMMANDS
+
+*dns*
+: Generates a new standalone DNS listener Ruby script.
+
+*http*
+: Generates a new standalone HTTP listener Ruby script.
+
+*help*
+: Lists available `ronin-listener new` commands.
+
+## EXAMPLES
+
+Generate a new DNS listener Ruby script:
+
+    $ ronin-listener new dns file.rb
+
+Generate a new HTTP listener Ruby script:
+
+    $ ronin-listener new http file.rb
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+[ronin-listener-new-dns](ronin-listener-new-dns.1.md) [ronin-listener-new-http](ronin-listener-new-http.1.md)

data/man/ronin-listener.1

@@ -0,0 +1,38 @@
+.\" Generated by kramdown-man 1.0.1
+.\" https://github.com/postmodern/kramdown-man#readme
+.TH ronin-listener 1 "2023-02-01" Ronin Listener "User Manuals"
+.SH NAME
+.PP
+ronin\-listener \- A Ruby CLI utility for receiving exfiltrated data
+.SH SYNOPSIS
+.PP
+\fBronin\-listener\fR \[lB]\fIoptions\fP\[rB] \[lB]\fICOMMAND\fP\[rB]
+.SH DESCRIPTION
+.PP
+Allows quickly starting a DNS or HTTP server for receiving exfiltrated data\.
+.SH OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Prints help information\.
+.SH COMMANDS
+.TP
+\fBdns\fR
+Starts a DNS server for receiving exfiltrated data\.
+.TP
+\fBhttp\fR
+Starts a HTTP server for receiving exfiltrated data\.
+.TP
+\fBnew\fR
+Creates a new DNS or HTTP listener Ruby script\.
+.TP
+\fBhelp\fR
+Prints help information about this command or another command\.
+.SH AUTHOR
+.PP
+Postmodern 
+.MT postmodern\.mod3\[at]gmail\.com
+.ME
+.SH SEE ALSO
+.PP
+.BR ronin\-listener\-dns (1)
+.BR ronin\-listener\-http (1)

data/man/ronin-listener.1.md

@@ -0,0 +1,40 @@
+# ronin-listener 1 "2023-02-01" Ronin Listener "User Manuals"
+
+## NAME
+
+ronin-listener - A Ruby CLI utility for receiving exfiltrated data
+
+## SYNOPSIS
+
+`ronin-listener` [*options*] [*COMMAND*]
+
+## DESCRIPTION
+
+Allows quickly starting a DNS or HTTP server for receiving exfiltrated data.
+
+## OPTIONS
+
+`-h`, `--help`
+: Prints help information.
+
+## COMMANDS
+
+`dns`
+: Starts a DNS server for receiving exfiltrated data.
+
+`http`
+: Starts a HTTP server for receiving exfiltrated data.
+
+`new`
+: Creates a new DNS or HTTP listener Ruby script.
+
+`help`
+: Prints help information about this command or another command.
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+
+## SEE ALSO
+
+[ronin-listener-dns](ronin-listener-dns.1.md) [ronin-listener-http](ronin-listener-http.1.md)

data/ronin-listener.gemspec

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'yaml'
+
+Gem::Specification.new do |gem|
+  gemspec = YAML.load_file('gemspec.yml')
+
+  gem.name    = gemspec.fetch('name')
+  gem.version = gemspec.fetch('version') do
+                  lib_dir = File.join(File.dirname(__FILE__),'lib')
+                  $LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
+
+                  require 'ronin/listener/version'
+                  Ronin::Listener::VERSION
+                end
+
+  gem.summary     = gemspec['summary']
+  gem.description = gemspec['description']
+  gem.licenses    = Array(gemspec['license'])
+  gem.authors     = Array(gemspec['authors'])
+  gem.email       = gemspec['email']
+  gem.homepage    = gemspec['homepage']
+  gem.metadata    = gemspec['metadata'] if gemspec['metadata']
+
+  glob = ->(patterns) { gem.files & Dir[*patterns] }
+
+  gem.files  = `git ls-files`.split($/)
+  gem.files  = glob[gemspec['files']] if gemspec['files']
+  gem.files += Array(gemspec['generated_files'])
+  # exclude test files from the packages gem
+  gem.files -= glob[gemspec['test_files'] || 'spec/{**/}*']
+
+  gem.executables = gemspec.fetch('executables') do
+    glob['bin/*'].map { |path| File.basename(path) }
+  end
+
+  gem.extensions       = glob[gemspec['extensions'] || 'ext/**/extconf.rb']
+  gem.extra_rdoc_files = glob[gemspec['extra_doc_files'] || '*.{txt,md}']
+
+  gem.require_paths = Array(gemspec.fetch('require_paths') {
+    %w[ext lib].select { |dir| File.directory?(dir) }
+  })
+
+  gem.requirements              = gemspec['requirements']
+  gem.required_ruby_version     = gemspec['required_ruby_version']
+  gem.required_rubygems_version = gemspec['required_rubygems_version']
+  gem.post_install_message      = gemspec['post_install_message']
+
+  split = ->(string) { string.split(/,\s*/) }
+
+  if gemspec['dependencies']
+    gemspec['dependencies'].each do |name,versions|
+      gem.add_dependency(name,split[versions])
+    end
+  end
+
+  if gemspec['development_dependencies']
+    gemspec['development_dependencies'].each do |name,versions|
+      gem.add_development_dependency(name,split[versions])
+    end
+  end
+end

data/scripts/setup

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+
+#
+# Prints a log message.
+#
+function log()
+{
+	if [[ -t 1 ]]; then
+		echo -e "\x1b[1m\x1b[32m>>>\x1b[0m \x1b[1m$1\x1b[0m"
+	else
+		echo ">>> $1"
+	fi
+}
+
+#
+# Prints a warn message.
+#
+function warn()
+{
+	if [[ -t 1 ]]; then
+		echo -e "\x1b[1m\x1b[33m***\x1b[0m \x1b[1m$1\x1b[0m" >&2
+	else
+		echo "*** $1" >&2
+	fi
+}
+
+#
+# Prints an error message.
+#
+function error()
+{
+	if [[ -t 1 ]]; then
+		echo -e "\x1b[1m\x1b[31m!!!\x1b[0m \x1b[1m$1\x1b[0m" >&2
+	else
+		echo "!!! $1" >&2
+	fi
+}
+
+#
+# Prints an error message and exists with -1.
+#
+function fail()
+{
+	error "$@"
+	exit -1
+}
+
+# default to installing gems into vendor/bundle
+if [[ ! -f .bundle/config ]]; then
+	bundle config set --local path vendor/bundle >/dev/null || \
+	  fail "Failed to run 'bundle config'"
+fi
+
+log "Installing gems ..."
+bundle install || fail "Failed to run 'bundle install'!"
+
+log "Setting up the project ..."
+bundle exec rake setup || "Failed to run 'rake setup'!"

metadata

@@ -0,0 +1,153 @@
+--- !ruby/object:Gem::Specification
+name: ronin-listener
+version: !ruby/object:Gem::Version
+  version: 0.1.0.rc1
+platform: ruby
+authors:
+- Postmodern
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-06-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ronin-listener-dns
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0.rc1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0.rc1
+- !ruby/object:Gem::Dependency
+  name: ronin-listener-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0.rc1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0.rc1
+- !ruby/object:Gem::Dependency
+  name: ronin-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0.rc1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0.rc1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: |
+  ronin-listener is a small CLI utility for receiving exfiltrated data over DNS
+  or HTTP.
+email: postmodern.mod3@gmail.com
+executables:
+- ronin-listener
+extensions: []
+extra_rdoc_files:
+- COPYING.txt
+- ChangeLog.md
+- README.md
+files:
+- ".document"
+- ".github/workflows/ruby.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".yardopts"
+- COPYING.txt
+- ChangeLog.md
+- Gemfile
+- README.md
+- Rakefile
+- bin/ronin-listener
+- data/completions/ronin-listener
+- data/new/dns.rb.erb
+- data/new/http.rb.erb
+- gemspec.yml
+- lib/ronin/listener/cli.rb
+- lib/ronin/listener/cli/command.rb
+- lib/ronin/listener/cli/commands/completion.rb
+- lib/ronin/listener/cli/commands/dns.rb
+- lib/ronin/listener/cli/commands/http.rb
+- lib/ronin/listener/cli/commands/new.rb
+- lib/ronin/listener/cli/commands/new/dns.rb
+- lib/ronin/listener/cli/commands/new/http.rb
+- lib/ronin/listener/output_formats.rb
+- lib/ronin/listener/root.rb
+- lib/ronin/listener/version.rb
+- man/ronin-listener-completion.1
+- man/ronin-listener-completion.1.md
+- man/ronin-listener-dns.1
+- man/ronin-listener-dns.1.md
+- man/ronin-listener-http.1
+- man/ronin-listener-http.1.md
+- man/ronin-listener-new-dns.1
+- man/ronin-listener-new-dns.1.md
+- man/ronin-listener-new-http.1
+- man/ronin-listener-new-http.1.md
+- man/ronin-listener-new.1
+- man/ronin-listener-new.1.md
+- man/ronin-listener.1
+- man/ronin-listener.1.md
+- ronin-listener.gemspec
+- scripts/setup
+homepage: https://ronin-rb.dev/
+licenses:
+- LGPL-3.0
+metadata:
+  documentation_uri: https://ronin-rb.dev/docs/ronin-listener
+  source_code_uri: https://github.com/ronin-rb/ronin-listener
+  bug_tracker_uri: https://github.com/ronin-rb/ronin-listener/issues
+  changelog_uri: https://github.com/ronin-rb/ronin-listener/blob/main/ChangeLog.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.27
+signing_key:
+specification_version: 4
+summary: A Ruby CLI utility for receiving exfiltrated data.
+test_files: []