Obtaining and installing cnet

You should note the following requirements and restrictions for various systems:

• If using SunOS you should be using Release 4.1.2 or beyond. If still using Release 4.1.1 you must obtain and install Sun-Patch-ID#100257-03 (4-Oct-91).
• If using an SGI-IRIX machine, you must be using Release 5 or beyond (Release 4 is not supported).
• If using a Linux (a.out) machine, the freely-available dld package is required, though a few modifications to it have been necessary. A full, modified copy of dld is included and used in the cnet distribution.
• cnet has been tested with TclTk versions (Tcl7.3 + Tk3.6) and (Tcl7.4 + Tk4.*).

Installation

1. To begin installation, copy the distribution file cnet.shar to a new directory and feed it to the Unix shell.

2. Read and modify the C #defines in config.h, in particular defining the required operating and windowing system constants such as SUNOS41 and USE_XVIEW.
   Other constants that you will probably need to modify include the full pathnames of your C compiler and linker, and the value of CNETPATH.

3. Read and change site-specific constants in the Makefile for the operating system you'll be using (Makefile.sunos, Makefile.linuxaout ...)
   Typically, you'll need to modify (or uncomment) CC, CFLAGS, INCLUDES, LIBDIRS, LIBS, XLIBS, BINDIR and MANDIR.

4. Type 'make' to compile cnet for your system without error.
   • If you are compiling for a Linux (a.out) system with gcc you should get 3 warnings about the conflict between the use of register and longjmp in the dld package. It appears safe to ignore these warnings.

5. Type 'make install' to copy the cnet binary and manual to the required (global) directory.

6. For all systems, copy and make world-readable (chmod 644) the file cnet.h to one of the directories given in CNETPATH.

7. If using TclTk, copy and make world-readable (chmod 644) the file tcltk/cnet.tcl to one of the directories given in CNETPATH.

8. If using DEC's OSF/1, temporarily change to the decosf1 directory, read and follow the comments in cnetextra.c
   Then copy and make world-readable (chmod 644) the file decosf1/cnetextra.o to one of the directories given in CNETPATH (sorry about this ugly step, any suggestions?).

Testing

There are some introductory examples (such as may be used as student introductions to cnet) in the EXAMPLES directory. These may be the sort of things an academic staff member would set as assessible projects, or to assist students to "get up to speed" quickly. You should now be able to execute these examples with the commands:

    cnet TICKTOCK
    cnet STOPANDWAIT
    cnet FLOODING1

These examples would typically be invoked from the command-line, there is a small Makefile to demonstrate typical invocations. Each example has its own topology file defining the network to be simulated, for example T2, CLICK, FLOODING1 and FAST. You may execute any of the examples with:

    make 2
    make C

When cnet appears to work, the 8 example files in {TICKTOCK + ticktock.c}, {CLICK + click.c}, {KEYBOARD + keyboard.c}, and {STOPANDWAIT + stopandwait.c} should all be placed in a system-wide examples directory for everyone to copy and run.