Freeway BBS 1.2 README 
 Index:

 - What is this?
 - How it works?
 - System requirements
 - Howto install?
 - Howto use?
   - commands list (help)
   - ping
   - serv
   - updt
   - whois
   - warn
 - Bugs

 What is this? 

  This warez is a  kewl tool to organize  chatting and files  transfer  in ISP'z
subnets, accessible via guest/demo connections.  Prog maps  peer-2-peer  network
with dynamic server (that  means,  what every client are becomes as a  server in
chain order).  This ``product'' is intended to free  chatting and  source  codez
exchanges (or other tiny files).

 How it works? 

  All based on holes in LAN'z security, in which we can  connect via  demo/guest
connection, and on our peer-2-peer protocol called Phoenix-net.  For transfering
data between hosts you can use 2 methods: icmp_echo (reverse icmp-channel), dns(
also reverse tunneling) and icmp_port_unreachable (it's just idea,  we not  used
this cuz MTU == 8 bytes is too small).

 System requirements 

    - OS Linux or FreeBSD (*BSD?) with ppp proto support
    - modem
    - pppd
    - gcc/cc
    - make (optionally)
    - vi (optionally)
    - direct hands =)

    Theoretically, this should work on any linux or bsd-like system =)

 Howto install? 

  In most cases it's standart:
    1. tar -zxvf freeway_1.2.tar.gz
    2. cd ./freewaybbs_1.2
    3. ./configure

  Now, answer on following questions:


Step 1. Choose gateway's IP

 MTU:
   195.34.32.10 (secondary DNS)
   195.34.32.11 (primary DNS)
   195.34.32.26  
   295.34.32.61
  
 Comstar:
   195.210.128.3 (primary DNS)
   212.248.0.1   (secondary DNS)

 Microsoft icw5:
   57.66.127.196 (primary DNS)
   57.68.127.196 (secondary DNS)

Enter IP of gate:


  Here you should enter IP of host,  which you  wanna use as GATE for tunneling.
In list also marked up dns ipz, in that case if you wanna use dns-tunneling.  If
there is no marks, use simple icmp_echo method.


Step 2. Edit users list


  Now script runs vi (if it exists) and we'll see smth like this:

#define USERS_CNT  5 // don't forget update this shit!

// we keep all user infaz in memory - its faster!

struct users {

 unsigned char kaddr[1];  // user address in subnet
 char* nick;              // pointer to nickname

} usr_list[] = {

{ 0x00 , "test"    },  //   0    test
{ 0x00 , "inf1nity"},  //   1    inf1nity
{ 0x00 , "z3rg0"   },  //   2    z3rg0
{ 0x00 , "l00pb4ck"},  //   3    l00pb4ck
{ 0x00 , "3n3my"   },  //   4    3n3my
{ 0x00 , "dr.F34R" },  //   5    dr.F34R
{ 0x00 , "nigga"   },  //   6    nigga

};


  Here you can add/delete  users list.  If u had added some  user,  it's will be
better to add at the right of record comment with  uid number and nick. I.e.  if
you had added 6-yh user with nick "jackass", in the end of record you should add
comment like this:
 //   6    jackass

  Cuz without it, configure script wouldn't show to u added uid and you'll  have
to manually fix it in config.h.

 Step 3. Select user ID 

  Here you have to choose your nickname (by ID). Configuration done. Now, if you
wanna use icmp-tunneling type:  'make icmp' 

If you need a dns-tunneling method, type:  'make dns' 


 Howto use? 

  Heh, step-by-step manual:

  1. connect to dialup provider, which gate you had choose on configuration.

  2. get ip addr of this ppp interface.

  3. run freeway: './freeway MY_PPP_INTERFACE_IP'


  At first, prog scans subnet  (C class) and  searches a server. If  there is no
response from it, you'll see this message:

NOTICE: now you are server

That means, what there is no working server in  subnet, so now you would  accept
clients packets.  If there is a working server in LAN, and it has send reply  on
your request, you'll see message like this:

NOTICE: got reply from server!

Now you can chatting, etc. With slash you can enter commands to client.Lets look
at them:


/help
 --=== FreeWAY BBS 1.2 ===--
   ping        check connection status
   serv        print servers list
   updt        update address on server
   whois       get list of online users
   warn        send important message
   help        this cruft ((c) netcat )
   quit        go to hell



 'ping'    With this cmd you can check, is a server live.
/ping
PING->
<-PONG!


 'serv'    Display servers list:
/serv
Primary server: 121
Secondary server: 48

  The Primary Server is a server, to which you already connected.  The Secondary
server is a backup, which will be activated on fall of primary serv.


 'updt'    Update information (addr) about this uid on server.
Use it on hop to backup server, cuz sometimes on it can occures some errors.


 'whois'   Display list of online users:
/whois
Geting list of online users...
 Users online:
  infinity      241
  a1ex          15
  k1l0s         167


Integer in front of nickname - last octet of user's ip-address.


 'warn TEXT_MESSAGE'   This text'll be dispalyed on other client's  hosts
with some special color (red by default):

/warn ho ho ho

On terms of other users will appears this message:
<your_nick> ho ho ho


  And now, some words about hops to backup server on  primary's fault:  if  chat
had keep's quiet for a long time check server with ping. If there  is no  reply,
freeway'll connect to  backup server.  If had no  appeared  notice  like 'hop to
backup server', well try '/ping' again. If connection to backup serv done, often
you may type '/updt'. Else, if you can't connect to backup server, you'll become
a new primary server. Sometimes it's usefull to restart freeway (i.e.  if  there
are many hangups), cuz maybe after  network  bug in lan all  clients  can't  get
packets from each other, so they all becomes servers.  In that case,  freeway'll
find first of them and will connect to it.

 Bugs 

  In  case of that can do  admin of lan, there you wanna use freeway_bbs, it may
occures lotz of different erros and bugz. Also, if everyone dumb ass'll use this
prog in subnet of one ISP it will be an anarchy.

  Main  bugz,  which  occures  on  primary  server  disconnect ,  can  be  fixed
automatically or by stupid restart of freeway_bbs.


                     (c) 2004 russian underground community