DragonFly On-Line Manual Pages
INTERCHANGE(1) User Contributed Perl Documentation INTERCHANGE(1)
NAME
interchange - an e-commerce and general HTTP database display system
SYNOPSIS
interchange [--options] [file]
VERSION
5.6.1
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.0 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-2008 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:
Dan Browning David Kelly Davor Ocelic Ethan Rowe Gert van der Spoel
Greg Hanson Jon Jensen Jonathan Clark Kevin Walsh Mark Johnson Mike
Heins Paul Vinciguerra Peter Ajamian Stefan Hornburg (aka Racke),
captain Randy Moore Ron Phipps 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.
Contributions to Interchange have been made by:
Andreas Koenig Jason Holt
Bill Carr Jason Kohles
Bill Dawkins Javier Martin
Bill Randle Jeff Carnahan
Birgitt Funk Jeff Nappi
Bob Jordan Jochen Wiedmann
Brev Patterson Jose MX Revuelto
Brian Bullen Jure Kodzoman
Brian Kosick Jurgen Botz
Bruce Albrecht Keiko
Cameron Prince Keith Oberlin
Chen Naor Kim Lauritz Christensen
Christian Mueller Larry Leszczynski
Christopher Miller Marc Austin
Christopher Thompson Mark Stosberg
Dan Busarow Massimiliano Ciancio
Dan Helfman Matthew Schick
Daniel Thompson Michael McCune
Dave Wingate Michael Wilk
David Adams Mike Frager
Dennis Cronin Neil Evans
Don Grodecki Nelson Ferrari
Ed LaFrance Raj Goel
Frank Bonita Ray Desjardins
Frederic Steinfels Shozo Murahashi
Gunnar Hellekson Sonny Cook
Hamish Bradick Tim Baverstock
Hans-Joachim Leidinger Tom Friedel
Heinz Wittenbecher Tommi Laberno
Hiroyuki Cozy Kojima Troy Davis
Ignacio Lizaran Victor Nolton
Jack Tsai William Dan Terry
and many others
and, of course, the entire Perl team without whom Interchange could not
exist.
POD ERRORS
Hey! The above document had some coding errors, which are explained
below:
Around line 1071:
Non-ASCII character seen before =encoding in 'Jose'. Assuming
ISO8859-1
perl v5.20.2 2015-08-31 INTERCHANGE(1)