
              "NetInfo" An IP Calculator for the Palm Handheld

                By David Billett, Clearcom Computing Pty Ltd
     _________________________________________________________________

                             Table of Contents

    1. Overview
    2. Download
    3. Syntax
         i. IP Address Component
        ii. Separator
        iii. Netmask Component
        iv. Shortcuts
    4. Feedback
     _________________________________________________________________

                                  Overview

      You enter an IP address and netmask and click on Calculate. The
                   program calculates the following data:
     * Network address.
     * Dotted quad version of the network mask.
     * Hexadecimal version of the network mask.
     * Broadcast address.
     * The first host address on the network.
     * The last host address on the network.
     * The number of hosts on the network (excludes network and broadcast
       addresses).

    The netmask may be entered in several different formats. CIDR style
   number of bits, dotted quad or hexadecimal. See the Syntax section for
                                  details.
                             [screenshot1.jpg]
   This program is covered by a BSD style license. You are free to copy,
              distribute and use the software free of charge.
     _________________________________________________________________

                                  Download
                                      
    You can download the software as a zip archive or as a gzipped, tar
                                  archive.

                          Zip format: netinfo.zip

                      Gzipped tar format: netinfo.tgz

         Md5sum of netinfo.prc is bd5117837f4c23a6d410961cea4f7370
     _________________________________________________________________

                                   Syntax

      The IP address and netmask entry field is bound by the following
                                   rules:

                            IP Address Component

     * Must consist of at least one digit.
     * May contain up to four dotted quad components.
     * Each dotted quad component must be <= 255.

                                 Separator

     * The separator character "/" is mandatory.

                             Netmask Component

     * Must be present.
     * May be a CIDR style "number of bits" such as 1.2.3.4/24.
     * If it is a CIDR style "number of bits", it must be >= 8 and <= 32.
     * May be a dotted quad format such as 1.2.3.4/255.255.255.0.
     * If it is a dotted quad format, each component must be < 256.
     * If it is a dotted quad format, there must be at least one 'dot'.
       ie 1.2.3.4/255.0 is OK, 1.2.3.4/255 is not.
     * May be hexadecimal format such as 1.2.3.4/0xffffff00.
     * If it is a hexadecimal format, it must begin with "0x".
     * Must be a valid netmask.

             A netmask is checked for the following conditions:
     * For Class A addresses, the netmask must be >= 8.
     * For Class B addresses, the netmask must be >= 16.
     * For Class C addresses, the netmask must be >= 24.
     * For dotted quad and hexadecimal formats, the netmask when
       converted to a binary number, must be a continuous series of ones.
       The following is valid:
       0xff8 or 255.128
       These convert to a binary number like:
       11111111100000000000000000000000
       The following is invalid:
       0xff1 or 255.1
       These convert to a binary number like:
       11111111000000010000000000000000

                                 Shortcuts

   You can enter a minimum of data for NetInfo to figure out what you're
                               trying to do.

                   For example, the following will work:

                                    1/8

                                  1/255.0

                                   1/0xff
     _________________________________________________________________

                                  Feedback

                  Any feedback or suggestions are welcome.


    netinfo@clearcom.com.au
     _________________________________________________________________


    webmaster

   Last modified: Sat Dec 28 22:50:30 EST 2002
