Linux Certif

Toute la documentation sur la certification Linux LPI

interchange.1p

NAME

interchange - an e-commerce and general HTTP database display system

SYNOPSIS

interchange [--options] [file]

VERSION

5.7.6

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-2010 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
     Davor Ocelic
     Ethan Rowe
     Gert van der Spoel
     Greg Hanson
     Jon Jensen
     JT Justman
     Jure Kodzoman
     Kevin Walsh
     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
     Ed LaFrance
     Jonathan Clark
     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.