---

Spawn.h

/*****************************************************************************
 * Author:   Valient Gough <vgough@pobox.com>
 *
 *****************************************************************************
 * Copyright (c) 2001, Valient Gough
 *
 * This library is free software; you can distribute it and/or modify it under
 * the terms of the GNU Lesser General Public License (LGPL), as published by
 * the Free Software Foundation; either version 2.1 of the License, or (at your
 * option) any later version.
 *
 * This library is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the LGPL in the file COPYING for more
 * details.
 *
 */

#ifndef _Spawn_incl_
#define _Spawn_incl_

#include <rel/VMap.h>

#include <string>

namespace rel
{
    class TypeStream;

    // Spawn is a module to spawn external clients, and return a communication
    // channel to talk to them.
    namespace Spawn
    {

        // returns VMapPtr.
        // The stream should contain the executable name/path in the first
        // argument, followed by zero or more arguments to be passed to the
        // program (all string type - as they are passed on the command line).
        OpaqueValue spawnChild(const TypeStream *args);

    };


} // namespace rel

#endif

---