Changeset 7978 in project


Ignore:
Timestamp:
01/28/08 18:58:11 (12 years ago)
Author:
rm
Message:

Changes applied for rm (97.76.48.98) through svnwiki:

describing basic interface

File:
1 edited

Legend:

Unmodified
Added
Removed
  • wiki/flux

    r7977 r7978  
    77=== Introduction
    88
    9 A new paradigm on RPC
    10 
    11 * THIS DOCUMENTATION IS A WORK IN PROGRESS AND IS THUS INCOMPLETE
     9Flux (Fast Light Unified eXchange) is a new paradigm in distributed computing.
     10Flux uses the concept of nodes or "agents" to create a distrbuted environment.
     11Agents do not have any previous knowledge of how to perform tasks unless first
     12instructed.  Asychronous reponse data can be retrieved by also supplying the
     13remote node the code with which to respond.  This paradigm is meant to keep
     14control over source code in the hands of the developer.  Flux can be used
     15as an RPC system as well, the largest difference here is that in traditional
     16RPC systems the remote end already knows how to perform an action and has
     17an interface exposed.  In Flux we provide the interface to the remote node.
     18Flux also has a simple directory mechanism so that nodes can find each
     19other.  Requests can be direct or indirect, either to a single node by name
     20or to all nodes by setting the node name to #:all using the directory.
    1221
    1322=== Authors
     
    5867{{(require-extension flux)}}
    5968
    60 ===== flux:send-to
     69===== start-node
    6170
    62  [procedure] (flux:send-to HOST `(CODE))
     71 [procedure] (start-node "node-name" node-ip-address node-port directory-ip-address directory-port local-repl)
    6372
    64  Send code to a remote node
     73    This procedure starts a node, you must supply a string for node-name, ip-address of the local machine,
     74    a port number, as well as the directory ip-address and port number (this can be the local node as well).
     75    The last option local-repl takes a boolean and determines whether a local repl "console" should be
     76    started for this node.  You can also run multiple "nodes" within a single process for testing purposes.
     77
     78===== send-to
     79
     80 [procedure] (send-to remote-node `(CODE))
     81
     82    This procedure will allow you to send code to a specific remote node or all nodes if remote-node is replaced
     83    with #:all.  Code must be pre-fixed with unquote.  Please see the examples below for more details.
     84
     85===== delete-self
     86 
     87 [procedure] (delete-self directory-ip-address directory-port node-ip-address node-port)
     88
     89    This procedure should be called as part of your shutdown routine (this is handled in flux-capacitor by a UNIX signal handler).
     90    It's purpose is to remove the node cleanly from the directory.
    6591
    6692=== Examples
     
    78104* v0.1
    79105
     106
Note: See TracChangeset for help on using the changeset viewer.