Drone

File Release Notes and Changelog

Release Name: 1.1.6

Notes:
INTRODUCTION

Stublet is a very simple stub application for testing Drone
<http://drone.sourceforge.net/>.  It simply reads an input file,
sleeps for an interval specified in the input file, and outputs two
dummy files.  It also reads a few dummy parameters from the command
line; these have no effect.

LICENSE

This file is part of the stublet distribution. stublet is free
software; you can redistribute and modify it under the terms of the
GNU General Public License (GPL), version 2 or later.  This software
comes with absolutely no warranty. See the file COPYING for details
and terms of copying.

PROJECT HOMEPAGE

Stublet is a part of the Drone project. The Drone project homepage,
current release, mailing lists, bug tracking system, and source code
repository are hosted at SourceForge
<http://sourceforge.net/project/?group_id=1558>.

INSTALLATION

Stublet should install easily on any Posix platform. See the file
INSTALL for complete installation instructions.

For most platforms, it should be sufficient to do the following as
root:

# zcat stublet-1.1.1.tar.gz | tar xf -
# cd stublet-1.1.1
# ./configure
# make
# make install

This will install stublet in /usr/local/bin, and the stublet man page
in /usr/local/man/man1.

RUNNING STUBLET

Usage:
  stublet -I<inputFile> -S<rngSeed> -N<runNum> -batchmode [-D<param>=<value>]

To get the version:
  stublet -v -batchmode
  
To get online help:
  stublet -h

The order of the command-line options doesn't matter.

The option -D sets a program parameter to the specified value.
Currently, the parameters sleepInt, param1, param2, param3, and param4
are recognized.  sleepInt specifies the length of time (in seconds)
that the program should sleep; the other parameters have no effect.

The input file must be located at the path <inputFilePath> and must
have the syntax:

# set <param> = <value>

Parameters specified on the command-line override those in the input
file.

You can use the abbreviations sI, p1, p2, p3, and p4 instead of the
full parameter names.  This is mainly for completeness; Drone doesn't
yet make full use of this.

After sleeping, Stublet then writes two files in the current working
directory: report.<runNum> and popdump.<runNum> These are dummy files
and don't contain anything interesting.

<rngSeed> is currently ignored, but it must still be specified on the
command line, as must the flag "-batchmode". The -batchmode option is
required in order to make stublet conform to Swarm-961002 calling
conventions.  In future versions of Swarm, -batchmode may no longer be
necessary.

A sample input file, stublet.in, is included. There is a sample Drone
control file in the Drone distribution.

REPORTING BUGS 

Please report any bugs using the Drone bug tracking system at
<http://sourceforge.net/bugs/?group_id=1558>.



Changes:
2000-11-04 Theodore C. Belding <streak@umich.edu>

* Released version 1.1.6
* Added bootstrap script to generate configure script

2000-11-02 Theodore C. Belding <streak@umich.edu>

* Released version 1.1.5
* Minor configuration cleanups.

2000-10-01 Theodore C. Belding <streak@umich.edu>

* Released version 1.1.4
* Added RPM spec file.
* Minor configuration cleanups.

2000-09-19 Theodore C. Belding <streak@umich.edu>

* Released version 1.1.3
* Added configure and Makefile.in files to CVS repository, for 
those who don't have automake or autoconf.
* Remove *~ *.bak in "make clean" target.

20000907 Version 1.1.2:

* Added homepage and bugtracking info to README.

20000906 Version 1.1.1:

* Added stublet.in to distribution.

20000811 Version 1.1.0:

* Converted to autoconf and automake.
* Added documentation files and man page.
* Updated copyright to 2000.
* Use config.h.
* Uploaded to Drone SourceForge project
* Imported into CVS.

19961113 Version 1.0:

* First public release.