This distribution has been tested on the following operating systems,
using gcc version 2.6.0 or above:

	Solaris 2.5

It has been ported to, but not thoroughly tested, on:

	Linux 2.0.27, Debian flavor
	Digital Unix 3.2C

It should build on those without any trouble. If you want it to run on
something else, check out the PORTING file for more info.

1) To configure for your system:

	# ./configure

   This will show the system it thinks it is and link in the appropriate
   source config file from the config dir.

2) By default, the configuration file will be /usr/local/etc/vcond.cf.
   You can specify a different path on the command line, or you can
   have a different one compiled in by setting -DDFLT_CONFIG_FILE="<path>"
   in the DEPDEF line in your config file.

3) Decide whether you want other options that must be set at compile-time.
   Enable these options by setting -D<option> in the config file.

	CON_SERVER_LIMIT_RETRY

	Only try to connect to server a limited number of times. Give
	up and do not try again if failed to connect CON_MAX_SERVER_RETRY
	times (default value is 10 but can be overridden in the config file).

	CON_LOG_LIMIT_RETRY

	Similar to above, only affecting the number of times it will
	try to open the console log file. It will try CON_MAX_LOG_RETRY
	times (default value also currently 10).

	CON_PRIVATE_SESSION

	Do not log all output during an active session. (Previous
	versions worked this way, and enabling this option in this
	version has not been tested.)

	CON_CONN_ACTIVE_TEST

	Use the telnet NOP command to actively test console connections
	periodically. It's not clear that this is necessary, and in some
	systems it could cause problems. Thus it is no longer compiled
	in by default. If keepalives don't work on your system, you may
	need this.
	
4) Generate dependencies and compile:

	# make depend; make

5) Test it. You can use the provided example config file, and specify
   -d to enable some debugging.

	# ./vcond/vcond -d -f vcond.cf

   You should then be able to telnet to the listening port:

	# telnet localhost 10001

   You won't be able to connect to the admin console unless you change
   the (encrypted) password in the config file. The one distributed
   is bogus. You should get the select prompt and be able to connect
   to ns1 (which actually is the telnet port on the local machine
   in disguise). There should also be a console log, con.ns1,
   with some info.

   Note that you normally will not be able to log in as root in this
   example, since that is not usually allowed on telnet connections.
   Once you actually have this installed on a terminal server, which
   in turn is connected to the console port, you should be able to log
   in as root.

6) Install the executable and man page. The suggested locations are
   /usr/local/bin and /usr/local/man/man8.

7) Create and install your vcond.cf. The default location is in
   /usr/local/etc (see step 2). Change the permissions to restrict
   read and write access to root, since it may contain clear-text port
   passwords as well as the encrypted admin password.

8) You probably will want to have it start up when your machine boots,
   but I'll leave that up to you.

Other make commands available are:

   make clean:   delete all object files, libraries, programs,
                 backup files, etc.

   make distclean:  make clean, then remove all configuration and
                    dependency info, and remove all test console logs.
