NAME¶
interchange - an e-commerce and general HTTP database display system
SYNOPSIS¶
interchange [--options] [file]
VERSION¶
5.7.7
DESCRIPTION¶
Interchange is a database access and retrieval system focused on e-commerce. It
allows customers to select items to buy from catalog pages. The program tracks
user information in sessions and interacts with an HTTP server through
sockets.
Interchange has many, many, functions and features; they are too numerous to
describe in this venue. Complete information can be found at its web site:
http://www.icdevgroup.org/
Interchange requires Perl 5.8.5 or higher; more information on Perl can be seen
at:
http://www.perl.com/
OPTIONS¶
Interchange uses the Getopt::Long module, and most options will be recognized if
they uniquely identifiable. The canonical forms are:
- -a, --add
- Add a catalog to the system. Information taken from the
input file (or standard input). Implies reconfig=catalog. Example:
echo "Catalog simple /catalogs/simple /simple.cgi" | bin/interchange -a
The information is in the form of a standard Interchange catalog line, and
must be in the single-line format.
- --runjobs=catalog[=job]
- Run a jobs group which is a series of files in a directory
with the name corresponding to the "job". For instance, if you
set up a directory called "weekly" in your pages directory for
the catalog "foundation", you can run those files with:
interchange --runjobs=foundation=weekly
Files ending in .html (or whatever HTMLsuffix is for that catalog) are
skipped. It is not tree-recursive -- directories are ignored.
Results can be emailed to an address if you specify --email=address, and
they will be put in the jobs log file.
Alternatively jobs can be specified with --jobgroup=jobname before
the --runjobs option. In other words, this will work:
interchange --jobgroup=weekly --runjobs=foundation
This will NOT work:
interchange --runjobs=foundation --jobgroup=weekly
- -d dir, --dir=dir
- Directory for VendRoot. This is where the Interchange
configuration file will be looked for (if not redefined with
"-f"), and where the log file will go (if not redefined with the
ErrorFile directive).
- -e name, --exclude=name
- Exclude catalog from this startup.
- -email=address
- Email address to email jobs results to.
- -f file, --config=file
- Configuration file to use (default is interchange.cfg in
VendRoot).
- -h, --help
- Display help on command line options.
- -i, --inetmode
- Run with internet-domain socket only. Normally Interchange
runs with both UNIX- and internet-domain sockets (except on Windows).
- --jobgroup=job
- Sets the job for --runjobs if that is not included in the
--runjobs call. MUST precede the --runjobs entry on the command line.
interchange --jobgroup=weekly --runjobs=foundation
See --runjobs for an explanation of what this does.
- --kill [signal]
- By default, kills the server ungracefully with signal KILL
(9, usually). The optional signal will be sent instead if supplied.
- -q, --quiet
- Suppress informational messages on startup. Only errors are
shown.
- --reconfig=name
- Cause only catalog "name" to re-read its
configuration.
- --remove=catalog
- Remove a catalog from operation; any future requests will
get a not-found message.
- -r, --restart
- Stop and restart the server. This may take a long time if
many catalogs are in use, and will temporarily take the system offline. If
you want to change a UserTag, use the --add option instead.
- --serve
- This is the default if no mode options (--reconfig, --kill,
--restart, etc.) are supplied.
- --stop
- Stop server gracefully with a TERM signal.
- -t, --test
- Report problems with config files; causes a complete
configuration of the Interchange server but no server start.
- -u, --unix
- Run with unix-domain socket only. Normally Interchange runs
with both UNIX- and internet-domain sockets. This will not work on
Windows.
- -v, --version
- Display program version.
- --DEBUG=1
- Set to true value to run foreground in debug mode. It is
normal to receive warnings about various things if you run with perl
-w.
- Directive=value
- Set a Interchange global directive upon start (or
--restart). Example:
interchange SocketPerms=0666
This will start the server and override the default of SocketPerms or the
value set in interchange.cfg for this instance only. Any --restarts must
re-specify the directive if it is still to have that value.
- name:Directive=value
- Set a Interchange directive for catalog "name"
upon start (or --restart). Example:
interchange simple:VendURL="http://localhost/cgi-bin/simple"
This will start the server and override the default of VendURL for the value
set in catalog.cfg for this instance only. Any --restarts must re-specify
the directive if it is still to have that value.
SEE ALSO¶
compile_link(1),
config_prog(1),
configdump(1),
dump(1),
expire(1),
expireall(1),
localize(1),
makecat(1),
offline(1),
restart(1),
update(1),
http://www.icdevgroup.org/
LICENSE¶
Interchange comes with ABSOLUTELY NO WARRANTY. This is free software, and you
are welcome to redistribute and modify it under the terms of the GNU General
Public License.
COPYRIGHT¶
Copyright (C) 2002-2011 Interchange Development Group
Copyright (C) 1995-2002 Red Hat, Inc.
All rights reserved except those granted in the license.
AUTHOR¶
Mike Heins is the primary author of Interchange.
The Interchange Development Group is:
Daniel Browning
David Christensen
Gert van der Spoel
Greg Hanson
Jon Jensen
Jure Kodzoman
Mark Johnson
Mark Lipscombe
Mike Heins
Peter Ajamian
Ron Phipps
Stefan Hornburg (aka Racke), captain
Ton Verhagen
Please do not contact the authors directly for help with the system. Use the
Interchange mail list:
interchange-users@icdevgroup.org
Information on subscribing to the list, as well as general information and
documentation for Interchange is at:
http://www.icdevgroup.org/
ACKNOWLEDGEMENTS¶
Original author of Vend, ancestor to Minivend and Interchange, was Andrew Wilcox
<amw@wilcoxsolutions.com>. Interchange could never have come into being
without him. Interchange was based on Vend 0.2, with portions from Vend 0.3;
both were produced in 1995.
Special thanks to Retired Core Team Members:
Brev Patterson
David Kelly
Davor Ocelic
Ed LaFrance
Ethan Rowe
Jonathan Clark
JT Justman
Kevin Walsh
Paul Vinciguerra
Randy Moore
Contributions to Interchange have been made by:
Alison Smith Jonathan Walker
Andreas Koenig Jordan Adler
Andrew Rich Josh Braegger
Bill Carr Josh Lavin
Bill Dawkins Jose MX Revuelto
Bill Randle Jurgen Botz
Birgitt Funk Justin Otten
Bob Jordan Kaare Rasmussen
Brent Kelly Keiko
Brian Bullen Keith Oberlin
Brian Kosick Kim Lauritz Christensen
Brian Miller Larry Huffman
Bruce Albrecht Larry Leszczynski
Cameron Prince Lars Tode
Carl Bailey Lyn St George
Chen Naor Marc Austin
Christian Mueller Mark Stosberg
Christopher Miller Marty Tennison
Christopher Thompson Massimiliano Ciancio
Christopher Wenham Mat Jones
Dan Busarow Matthew Schick
Dan Collis-Puro Max Cohan
Dan Helfman Michael Lehmkuhl
Daniel Hutchinson Michael McCune
Daniel Thompson Michael Wilk
Dave Wingate Mick Weiss
David Adams Mike Frager
Dennis Cronin Neil Evans
Don Grodecki Nelson Ferrari
Don Hathaway Paul Delys
Donald Alexander Paul Jordan
Eric Zarko Phil Smith
Frank Bonita Raj Goel
Frederic Steinfels Ray Desjardins
Gary Benson Reid Sutherland
Gunnar Hellekson Rene Hertell
Hamish Bradick Ryan Perry
Hans-Joachim Leidinger Sergiusz Jarczyk
Heinz Wittenbecher Shozo Murahashi
Hiroyuki Cozy Kojima Sonny Cook
Ignacio Lizaran Spencer Christensen
Ivan Kohler Steve Graham
Jack Tsai Thomas J.M. Burton
Jason Holt Tim Baverstock
Jason Kohles Tom Friedel
Javier Martin Tom Tucker
Jeff Barr Tommi Labermo
Jeff Boes Toni Mueller
Jeff Carnahan Troy Davis
Jeff Fearn Victor Nolton
Jeff Nappi William Dan Terry
Jochen Wiedmann Zachary Matthews
and many others.
And, of course, the entire Perl team without whom Interchange could not
exist.