prepare for 2.0 release

2004-01-14 13:10:50 +00:00 · 2004-01-14 13:10:50 +00:00 · 28f39dbc0e
commit 28f39dbc0e
parent 8e2ef5d755
8 changed files with 226 additions and 69 deletions
--- a/1
+++ b/1
@ -3,6 +3,7 @@ Open Proxy Scanning Bot Module for NeoStats Changelog.
 * Version 2.0 * 29/12/2003 * Fish (F) and Mark (M)
 - Fixed incorrect parameters to printf style functions (M)
 - Use more appropriate defines for buffer sizes since MAXHOST differs between IRCds (M)
+ - Added Help information for PORTS command, which I forgot (F)

 * Version 2.0 * 29/12/2003 * Fish (F) and Mark (M)
 - Some segv updates from M (mark@ctcp.net) (M/F)
--- a/OPSB.xml
+++ b/OPSB.xml
@ -83,18 +83,6 @@
    TRANSPARENT PROXY.</para>
  </warning>

-  <warning>
-    <para>As of writting, this software is BETA quality. Not all functionality
-    has been implemented, and additionally, there might be some &#34;BAD&#34;
-    bugs in OPSB that cause it to AKILL your entire network. Our testing and
-    Development of OPSB was run on a large network, and so far, has proved
-    stable, and effective in protecting our network, BUT every users
-    enviroment is different. While we have taken all precautions and conducted
-    a extensive QA cycle before the release of OPSB, its a &#34;Use at your
-    Own Risk&#34; Module. Of Course, if you do have bad experiences with OPSB,
-    please let us know at <link linkend="???">http://www.neostats.net/boards/</link></para>
-  </warning>
-
  <para>OPSB is written and maintained by Justin Hammond. It requires the
  NeoStats software. More information about OPSB, or NeoStats, can be found at
  <link linkend="???">http://www.neostats.net/</link></para>
@ -458,6 +446,10 @@ ld -shared -o opsb.so                   opsb.o proxy.o opsb_help.o libopm/libopm
      <listitem>
        <para>SCANMSG</para>
      </listitem>
+
+      <listitem>
+        <para>PORTS</para>
+      </listitem>
    </itemizedlist>

    <para>To change any of these settings, you use the Set Interface in OPSB.
@ -603,6 +595,88 @@ ld -shared -o opsb.so                   opsb.o proxy.o opsb_help.o libopm/libopm

      <screen>/msg OPSB set SCANMSG &#60;msg&#62; </screen>
    </sect2>
+
+    <sect2>
+      <title>PORTS Setting</title>
+
+      <para>The ports setting allows you to customize what ports and protocols
+      are scanned when users connect to your IRC network. This can be used to
+      detect proxies that are running on additional ports that OPSB does not
+      scan by default. </para>
+
+      <sect3>
+        <title>Listing Ports/Protocols</title>
+
+        <para>To list the current protocols and the assocated ports, issue the
+        following command:</para>
+
+        <screen>/msg OPSB ports list</screen>
+
+        <para>And the following is displayed:</para>
+
+        <screen>&#62;opsb&#60; ports list
+-opsb- Port List:
+-opsb- 1) HTTP Port: 80
+-opsb- 2) HTTP Port: 8080
+-opsb- 3) HTTP Port: 8000
+-opsb- 4) HTTP Port: 3128
+-opsb- 5) SOCKS4 Port: 1080
+-opsb- 6) SOCKS5 Port: 1080
+-opsb- 7) WINGATE Port: 23
+-opsb- 8) ROUTER Port: 23
+-opsb- 9) HTTPPOST Port: 80
+-opsb- 10) HTTPPOST Port: 8080
+-opsb- 11) HTTPPOST Port: 8000
+-opsb- 12) HTTPPOST Port: 3128
+-opsb- End of List.</screen>
+      </sect3>
+
+      <sect3>
+        <title>Adding Ports</title>
+
+        <para>To add a additional port to scan with a particular protocol, use
+        the following command:</para>
+
+        <screen>/msg opsb ports add &#60;type&#62; &#60;port&#62;</screen>
+
+        <para>Where:</para>
+
+        <para>&#60;type&#62; is the type of Protocol to use. Either:</para>
+
+        <para>HTTP</para>
+
+        <para>HTTPPOST</para>
+
+        <para>SOCKS4</para>
+
+        <para>SOCKS5</para>
+
+        <para>WINGATE</para>
+
+        <para>ROUTER</para>
+
+        <para>&#60;port&#62; is any valid port number between 1 and 65535</para>
+
+        <para>The change is imediate, and new users will have these ports
+        scanned when they connect. </para>
+      </sect3>
+
+      <sect3>
+        <title>Deleting Ports</title>
+
+        <para>If you wish to delete a port to be scanned, issue the following
+        command:</para>
+
+        <screen>/msg opsb ports del &#60;id&#62;</screen>
+
+        <para>Where &#60;id&#62; is the ID number of the port/Protocol you
+        wish to delete. ID can be obtained from a port listing command
+        described above. </para>
+
+        <para>OPSB requires a restart when deleting a port, so you should
+        either restart NeoStats, or Reload the OPSB module. </para>
+      </sect3>
+    </sect2>
  </sect1>

  <sect1>
--- a/README.opsb
+++ b/README.opsb
@ -23,6 +23,11 @@ OPSB Manual
        3.7. OPENSTRING
        3.8. SPLITTIME
        3.9. SCANMSG Setting
+        3.10. PORTS Setting
+
+              3.10.1. Listing Ports/Protocols
+              3.10.2. Adding Ports
+              3.10.3. Deleting Ports

   4. Operational Commands

@ -91,18 +96,6 @@ Warning
   provider  that  does  not run a transparent proxy. THERE IS NO WAY FOR
   OPSB TO DETECT IT IS BEHIND A TRANSPARENT PROXY.

-Warning
-
-   As  of  writting, this software is BETA quality. Not all functionality
-   has been implemented, and additionally, there might be some "BAD" bugs
-   in  OPSB  that  cause it to AKILL your entire network. Our testing and
-   Development of OPSB was run on a large network, and so far, has proved
-   stable,  and  effective  in  protecting  our  network, BUT every users
-   enviroment  is  different.  While  we  have  taken all precautions and
-   conducted  a extensive QA cycle before the release of OPSB, its a "Use
-   at  your  Own  Risk" Module. Of Course, if you do have bad experiences
-   with OPSB, please let us know at http://www.neostats.net/boards/
-
   OPSB  is  written  and  maintained  by Justin Hammond. It requires the
   NeoStats  software.  More  information about OPSB, or NeoStats, can be
   found at http://www.neostats.net/
@ -404,6 +397,7 @@ Caution
     * OPENSTRING
     * SPLITTIME
     * SCANMSG
+     * PORTS

   To  change  any  of these settings, you use the Set Interface in OPSB.
   Eg:
@ -521,6 +515,75 @@ Caution
   To Change the setting, issue the following Command:
 /msg OPSB set SCANMSG <msg>

+3.10. PORTS Setting
+
+   The ports setting allows you to customize what ports and protocols are
+   scanned  when  users  connect to your IRC network. This can be used to
+   detect proxies that are running on additional ports that OPSB does not
+   scan by default.
+
+3.10.1. Listing Ports/Protocols
+
+   To  list  the  current  protocols  and  the assocated ports, issue the
+   following command:
+/msg OPSB ports list
+
+   And the following is displayed:
+>opsb< ports list
+-opsb- Port List:
+-opsb- 1) HTTP Port: 80
+-opsb- 2) HTTP Port: 8080
+-opsb- 3) HTTP Port: 8000
+-opsb- 4) HTTP Port: 3128
+-opsb- 5) SOCKS4 Port: 1080
+-opsb- 6) SOCKS5 Port: 1080
+-opsb- 7) WINGATE Port: 23
+-opsb- 8) ROUTER Port: 23
+-opsb- 9) HTTPPOST Port: 80
+-opsb- 10) HTTPPOST Port: 8080
+-opsb- 11) HTTPPOST Port: 8000
+-opsb- 12) HTTPPOST Port: 3128
+-opsb- End of List.
+
+3.10.2. Adding Ports
+
+   To  add  a additional port to scan with a particular protocol, use the
+   following command:
+/msg opsb ports add <type> <port>
+
+   Where:
+
+   <type> is the type of Protocol to use. Either:
+
+   HTTP
+
+   HTTPPOST
+
+   SOCKS4
+
+   SOCKS5
+
+   WINGATE
+
+   ROUTER
+
+   <port> is any valid port number between 1 and 65535
+
+   The  change  is  imediate, and new users will have these ports scanned
+   when they connect.
+
+3.10.3. Deleting Ports
+
+   If  you  wish  to  delete  a  port  to be scanned, issue the following
+   command:
+/msg opsb ports del <id>
+
+   Where  <id>  is the ID number of the port/Protocol you wish to delete.
+   ID can be obtained from a port listing command described above.
+
+   OPSB  requires  a  restart  when deleting a port, so you should either
+   restart NeoStats, or Reload the OPSB module.
+
 4. Operational Commands

   OPSB  has  a  number  of  commands  that  you can issue it in order to
--- a/README.opsb.html
+++ b/README.opsb.html
--- a/2
+++ b/2
@ -1265,7 +1265,7 @@ ac_compiler_gnu=$ac_cv_c_compiler_gnu
          ac_config_headers="$ac_config_headers modconfig.h"

 PACKAGE=OPSB
-VERSION=2.0Beta1
+VERSION=2.0
 DIRINST=~/NeoStats/

 CFLAGS="$CFLAGS -O2 -Wall"
--- a/configure.in
+++ b/configure.in
@ -2,7 +2,7 @@ dnl Process this file with autoconf to produce a configure script.
 AC_INIT(opsb.c)
 AC_CONFIG_HEADER(modconfig.h)
 PACKAGE=OPSB
-VERSION=2.0Beta1
+VERSION=2.0
 DIRINST=~/NeoStats/
 AC_PREFIX_DEFAULT(~/NeoStats/)
 CFLAGS="$CFLAGS -O2 -Wall"
--- a/opsb.c
+++ b/opsb.c
@ -64,7 +64,7 @@ int online;
 ModuleInfo __module_info = {
 	"OPSB",
 	"An Open Proxy Scanning Bot",
-	"2.0Beta1",
+	"2.0",
 	__DATE__,
 	__TIME__
 };
--- a/opsb_help.c
+++ b/opsb_help.c
@ -42,6 +42,7 @@ const char *opsb_help_oper[] = {
 	"    STATUS     View opsb state information",
 	"    SET        Change opsb configuration options",
 	"    EXCLUDE    Exclude a host from scanning",
+	"    PORTS      Allows you to customize the ports scanned",
 	"    REMOVE     Remove an akill set by opsb",
 	NULL
 };
@ -81,8 +82,6 @@ const char *opsb_help_info[] = {
 	"This bot is intended to scan clients connecting to this",
 	"network for insecure proxies. Insecure proxies are often",
 	"used to attack networks or channel with \2clone\2 bots",
-	"This check scans the following ports:", 
-	"    3128, 8080, 80 23 and 1080",
 	"If you have Firewall, or IDS software, please ignore any",
 	"errors that this scan may generate",
 	"",
@ -178,28 +177,34 @@ const char *opsb_help_exclude[] = {
 };

 const char *opsb_help_ports[] = {
-	"Syntax: \2EXCLUDE <LIST>\2",
-	"        \2EXCLUDE <ADD> <hostname> <type> <reason>\2",
-	"        \2EXCLUDE <DEL> <index>\2",
+	"Syntax: \2PORTS <LIST>\2",
+	"        \2PORTS <ADD> <type> <port>\2",
+	"        \2PORTS <DEL> <index>\2",
 	"",
-	"This command lets you view or manipulate the exception",
-	"list. Exception lists are used to exclude users, or",
-	"servers from scanning. You should at least add a server",
-	"entry for your services IRC name, to stop OPSB from",
-	"scanning Nickserv, Chanserv etc",
+	"This command lets you view or manipulate the ports",
+	"and proxy types scanned when users connect to your",
+	"IRC network. By Default, OPSB scans some default Ports",
+	"but you may wish to update this list with some additional",
+	"protocols and ports custom to your network"
 	"",
-	"\2LIST\2 will list the current exceptions together with an",
-	"ID number for use in removing entries.",
+	"\2LIST\2 will list the current ports and protocols scanned",
+	"and a ID number for use in removing entries.",
 	"",
-	"\2ADD\2 will add an entry of <hostname> to the exception" 
-	"list. Flag should be 1 to indicate a server name",
-	"(eg, services.irc-chat.net) or 0 to indicate a hostname",
-	"(eg, *.adsl.home.com). Reason allows you to set a"
-	"reason for the exclusion for future reference",
-	"Wildcards such as * and ? may be used in the hostname.",
+	"\2ADD\2 will add an entry of <type> running on port <port>",
+	"to the port list.",
+	"<type> can be either:", 
+	"       HTTP",
+	"       HTTPPOST",
+	"       SOCKS4",
+	"       SOCKS5",
+	"       WINGATE",
+	"       ROUTER",
+	"and port can be any valid port number. The new port is scanned",
+	"straight away",
 	"",
 	"\2DEL\2 will delete entry <index> from the list of",
-	"exclusions. Use the LIST command to find the index.",
+	"ports. Requires a Restart of OPSB to become effective. Alternatively",
+	"Reloading the OPSB module will make this effective",
 	NULL
 };