Confcntlr: README

The packages for confcntlr contain the binary "confcntlr" or source code for building "confcntlr" and the text files required for running "confcntlr" (beta version 0.4.2).

The binary (bin) packages contain:

README (this file)
PROTOCOL (text file for information on how confcntlr can be used to relay conference bus messages to other hosts)
confcntlr (binary)
.confcntlrrc (text file)
confcntlr.1 (man page)
sdr2.plugin.S50.control.tcp.*.confcntlr (plugin that sdr uses to launch confcntlr)

"confcntlr-src-b0.4.2.tar.gz" contains the following files:

tcl2c.c
mytkAppInit.c
tkUnixInit.c
net-tcp.c
confbus.h
confbus.c
comm.h
comm.c
defaults.c
iohandler.c
getopt.c
notify.c
sharedkey.h
crypt-null.c
ctrlmenu.tcl
uimain.tcl
Makefile (to build confcntlr and confcntlr-crypt)
README (this file)
PROTOCOL (text file for information on how confcntlr can be used to relay conference bus messages to other hosts)
confcntlr.1 (man page)
.confcntlrrc (text file used to set defaults)
sdr2.plugin.S50.control.tcp.*.confcntlr (plugin that sdr uses to launch confcntlr)

Platform:

confcntlr and confcntlr-crypt were developed on a SUN workstation and ported to SGI; the current version (beta 0.4.2) has been tested on SunOS 5.5.1 and 5.5.2, Irix 6.2, and freeBSD 2.2.6.

To build confcntlr (nonencrypted version):

Make sure that tcl/tk (v7.6/4.2) is installed on your system.
Make sure that vic and/or vat are also installed on your system.
Edit the following lines in the Makefile so that you have the correct include and library paths for Tcl/Tk:
INCLUDE_TK =
INCLUDE_TCL =
INCLUDE_X11 =
LIB_TCLTK =
Make a directory for this package and run "make" from this directory using the Makefile for your platform. Specify the target as "confcntlr". For example:
> make -f Makefile.solaris confcntlr
The binary "confcntlr" will be created in this directory. (You might want to move the binary to some other directory such as /usr/local/bin.)

To build confcntlr-crypt(encrypted version):

Make sure that tcl/tk (v7.6/4.2) and the ssleay (seclib-0.4) libraries are properly installed.
Make sure that vic and/or vat are properly installed.
Edit the following lines in the Makefile so that the include and library paths are correct for the Tcl/Tk and encryption (ssleay) libraries:
INCLUDE_TK =
INCLUDE_TCL =
INCLUDE_X11 =
INCLUDE_CRYPT =
LIB_TCLTK =
LIB_CRYPTO =
Make a directory for this package and run "make" from this directory with the Makefile for your platform. Specify the target as "confcntlr-crypt". For example:
> make -f Makefile.solaris confcntlr-crypt
The binary "confcntlr-crypt" will be created in this directory. (You might want to move the binary to some other directory such as /usr/local/bin.)

The sdr2.plugin.S50... file is necessary if you want sdr to launch confcntlr. Install this file in $HOME/.sdr/plugins directory. Be sure to install the default (text) file, .confcntlrrc, in your home directory. In .confcntlrrc, on each line an attribute is followed by "#", then a space, then a value or list of values.

Edit this file so that you have values meaningful to your environment. Stick strictly to the format of each file.

In .confcntlrrc, you probably want to make the following changes:
Change the default contact host to a meaningful value in the line:
     "hostaddr# warner.bros.edu"
Change the list of contact hosts (you may add hosts) in the line:
      "hostlist# warner.bros.edu remote.machine.com"
Change the video devices to those that are available on your machine in the line:
      "deviceList# sunvideo sunvideo-1"
Change the video input jacks to those that are available on your machine in the line:
      "devportList# Composite-1 S-Video"
Change the list of audio input and output devices to those that are available on your machine in the lines:
      "audioInputDevices: mike linein"
      "audioOutputDevices: speaker headphone linout"
Change the list of ports in the line:
      "portlist# 12345 12347 12349"
Change the list of conference addresses in the line:
      "addrlist# unicast 224.35.36.37"
Change the default value for conference addresses in the lines:
      "localvic1.confaddr# unicast"
      "localvic2.confaddr# unicast"
      "localvat.confaddr# unicast"
Change the default conference name in the line:
     "confname# CONFERENCE"
Change the default port numbers in the lines:
     "port# 12345" "localvic1.port# 12345"
      "localvic2.port: 12347"
      "localvat.port: 12349"
Change the list of authorized users/hosts in the line:
     "authorizationList# *@this.machine.com
           mickey@disney.land.com"
     (NOTE: An asterisk can be used to mean "all." The entry
      "*@this.machine.com means any and all users on the
      named host.)

To execute:

You can run "confcntlr" or "confcntlr-crypt" in the foreground or in the background. To run in the background, type:
      > confcntlr &
              or
      > confcntlr-crypt &