view contrib/peer2anonet/README @ 545:63d19f68304c draft

peer2anonet: Sun Jul 10 18:50:31 CDT 2011 - d3v1150m471c * public key prompt altered to avoid complications.
author d3v1150m471c <d3v11@d3v1150m471c.ano>
date Sun, 10 Jul 2011 18:51:25 -0500
parents 32741b02849b
children 76d0f12e2125
line wrap: on
line source

                     ____                              _   
 _ __   ___  ___ _ _|___ \ __ _ _ __   ___  _ __   ___| |_ 
| '_ \ / _ \/ _ \ '__|__) / _` | '_ \ / _ \| '_ \ / _ \ __|
| |_) |  __/  __/ |  / __/ (_| | | | | (_) | | | |  __/ |_ 
| .__/ \___|\___|_| |_____\__,_|_| |_|\___/|_| |_|\___|\__|
|_|

SYNOPSIS:
     peer2anonet
        -OR-
     peer2anonet < autoconfig


DESCRIPTION:
     peer2anonet is an autoconfiguration utility to easily establish a
     peering session with BGP on anonet2.

LICENSE:
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
     the Free Software Foundation, either version 3 of the License, or
     (at your option) any later version.

     This program is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.

     You should have received a copy of the GNU General Public License
     along with this program.  If not, see <http://www.gnu.org/licenses/>.

DEPENDS ON:
      quicktun, bird, daemontools(non-deb), bash

INSTALL AND UNINSTALL:
    ******************************************************************
    * PEER2ANONET CAN AND WILL OVERWRITE /service AND /services, TO  *
    * INCLUDE FILES WITHIN THOSE DIRECTORIES. PLEASE CREATE BACKUPS  *
    * BEFORE INSTALLING AND USING PEER2ANONET AT ANY TIME!           *
    ******************************************************************

      To install, `cd' to the extracted peer2anonet folder.
      Issue the following commands as root:

      make install

      To uninstall peer2anonet, as root do:

      make uninstall

      To compile/install a .deb package, as root do:

      make install-deb

USAGE:
      You may execute peer2anonet and answer configuration questions
      via interface or pipe a file containing the new peering
      session's specifications to the executable. peer2anonet has
      some security checks but it is highly recommended you check
      a autoconfig file manually before using to prevent malicious
      attacks. An autoconfig file should be in the following format:
      Plain text file, one block of data per line, no spaces, and
      without including the following '<-- comments'.

================== Not Actual Line on File ============================
anon          <--your peer's alias
1.2.3.0       <--your new anonet network address
1.2.3.1       <--your new anonet router address
1.2.3.2       <--your new anonet ip
11.22.33.44   <--your peer's remote ip
3.5.7.9       <--your peer's anonet ip
1001          <--your new anonet client port
3571          <--your peer's client port
1230          <--you new asn
3570          <--your peer's asn
3c6e0b8a9c15224a8228b9a98ca1531d <--your peer's public key
================== Not Actual Line on File ============================ 


CHANGES:
      Sat Jul  9 06:48:58 CDT 2011 - d3v1150m471c
      * quicktun's "EXPORT DEBUG=1" removed on peering script.
      * some variables removed, info now passed directly to files.
      * peering.in removed. info passed directly to peering and
        then given executable status. Corresponding makefile
        was also removed.
      * Public key question corrected.
      * daemontools non-deb specified in README.
      * trimmed off unnecessary tests.
      * bash added to dependencies
      * file tests with mkdir changed to `mkdir -p`... .
      * peering file removed, passes directly to run file now.

      Sun Jul 10 05:47:22 CDT 2011 - d3v1150m471c
      * makefile changed to Makefile
      * parse quicktun.keypair</dev/random directly to seckey variable.
      * removed y/n questions with file tests and automatic
        configuration.
      * README file updated
      * ported for autoconfig file pipes
      * some security checks created

      Sun Jul 10 07:25:42 CDT 2011 - d3v1150m471c
      * security checks, whitespace removed after some data

      Sun Jul 10 08:13:17 CDT 2011 - d3v1150m471c
      * security checks changed to check acceptable data and exits
        showing offending info for violating data detections.
      * security checks more specific

      Sun Jul 10 17:04:36 CDT 2011 - d3v1150m471c
      * security check and key bugs patched.

      Sun Jul 10 18:50:31 CDT 2011 - d3v1150m471c
      * public key prompt altered to avoid complications.