ruby-vpi 8.2.0 → 9.0.0

data/ext/README

@@ -1,124 +0,0 @@
-Class|Module Naming Convention
-------------------------------
-
-FooBar
-  C module named "FooBar".
-
-RFooBar
-  Ruby class or module named "FooBar".
-
-RFooBar_rb_do_stuff
-  Ruby function named "do_stuff" which is callable from Ruby like this: "FooBar.new.do_stuff" or "FooBar::do_stuff" or ...
-
-RFooBar_doStuff
-  Service function named "doStuff" which is callable from C only.
-
-RFooBar__someStuff
-  Something named "someStuff", which is neither a Ruby function nor a service function, that belongs to "FooBar". Think of the two underscores "__" as being two colons "::" in Ruby.
-
-
-Variable Naming Convention
---------------------------
-
-fooBar
-  Ordinary variable named "fooBar".
-
-a?p?(r|v)?FooBar
-  Variable named "FooBar" which has additional properties denoted by the optional prefixes.
-
-aFooBar
-  Function argument named named "FooBar". For example: "int divide(int aDividend, aDivisor);".
-
-pFooBar
-  Pointer named "FooBar".
-
-rFooBar
-  Ruby object (instance of a Ruby class) named "FooBar".
-
-vFooBar
-  Verilog object named "FooBar".
-
-
-Code Formatting Convention
---------------------------
-
-Indenting
-  Use a single tab character to indent by one level. If you feel that tab characters occupy too much space or indent too deeply, then configure your text editor to *visually* display tab characters using less space. This is similar to the output produced by the filter "expand -t 2" in UNIX.
-
-  level 1
-    level 2
-      level 3
-        ... and so on ...
-    level 2
-  level 1
-
-Line breaking
-  Do not break a long line into multiple lines. Let it be as long as it wants and configure your text editor to *visually* wrap long lines and indent them so they are easy to read. This is similar to the output produced by the filter "fmt -cs" in UNIX.
-
-  For example:
-
-  /**
-    Foo is a fantastic bar which can be seen from atop the majestic peaks of baz. However, let us not forget the beauty of sparkling rubies beneath its rugged, earthy exterior. Yes, this line is very long, and that is the point.
-  */
-
-Vertical spacing
-  Use 1 line comment before the start of a group of related statements if necessary.
-
-  Use 1 line within a group of related statements.
-
-  Use 2 lines to mark the boundary between groups of related statements.
-
-  Use 3 lines to mark the boundary of a completely disjoint block of code, which has its own groups of related statements.
-
-Braces alignment
-  Put an open brace on same line as the start of the block statement. For example:
-
-  if(foo) {
-    doFoo();
-
-    if(bar) {
-      doBar();
-    }
-  }
-  else {
-    doRuby();
-  }
-
-Delimiting operators
-  When there are many operators in a single statement, indent the first element beneath the block-starter and put the operator at the start of subsequent elements. For example:
-
-  static unsigned long int
-    foo
-    , bar
-    , baz
-  ;
-
-  doStuff(
-    foo
-    , bar
-    , baz
-  );
-
-  if(
-    foo
-    && bar
-    || baz
-  ) {
-    doStuff();
-  }
-
-
-Code Documenting Convention
----------------------------
-
-Doxygen
-  Use Javadoc style (at "@" to start a documenting command) instead of LaTeX style (backslash "\" to start a documenting command) whenever possible. All public functions, variables, etc. must have such comments. For example:
-
-  /**
-    Writes out a foo and returns a bar.
-
-    @param	aFoo	The foo to write out.
-    @return	A bar.
-  */
-  bar doStuff(foo aFoo);
-

data/ext/relay.cin

@@ -1,146 +0,0 @@
-/*
-  Copyright 2006 Suraj N. Kurapati
-  Copyright 1999 Kazuhiro HIWADA
-
-  This file is part of Ruby-VPI.
-
-  Ruby-VPI is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License
-  as published by the Free Software Foundation; either version 2
-  of the License, or (at your option) any later version.
-
-  Ruby-VPI 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
-  GNU General Public License for more details.
-
-  You should have received a copy of the GNU General Public License
-  along with Ruby-VPI; if not, write to the Free Software Foundation,
-  Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
-*/
-
-#ifndef RELAY_CIN
-#define RELAY_CIN
-
-  #include <stdlib.h>
-  #include <pthread.h>
-  #include <ruby.h>
-  #include <assert.h>
-
-  #include "verilog.h"
-  #include "common.h"
-
-  #include "relay.hin"
-  #include "swig.hin"
-
-
-  static pthread_t relay__rubyThread;
-  static pthread_mutex_t relay__rubyLock;
-  static pthread_mutex_t relay__verilogLock;
-
-  static void relay_init() {
-    pthread_mutex_init(&relay__rubyLock, NULL);
-    pthread_mutex_lock(&relay__rubyLock);
-    pthread_mutex_init(&relay__verilogLock, NULL);
-    pthread_mutex_lock(&relay__verilogLock);
-  }
-
-  static void relay_ruby() {
-    pthread_mutex_unlock(&relay__rubyLock);
-    pthread_mutex_lock(&relay__verilogLock);
-  }
-
-  static void relay_verilog() {
-    pthread_mutex_unlock(&relay__verilogLock);
-    pthread_mutex_lock(&relay__rubyLock);
-  }
-
-  typedef struct {
-    PLI_BYTE8** mArgs;	/// Array of command-line arguments.
-    uint mCount;	/// Number of command-line arguments.
-  } relay__RubyOptions__def;
-
-  /**
-    @param	apRubyOptions	relay__RubyOptions__def structure which contains command-line options passsed to the Ruby interpreter.
-    @note	The structure will be freed *deeply* after use.
-  */
-  static void* ruby_run_handshake(void* apRubyOptions) {
-    // initialize Ruby interpreter
-    ruby_init();
-    ruby_init_loadpath();
-
-    swig_init();
-
-      // pass command-line arguments to the interpreter
-      relay__RubyOptions__def* pRubyOptions = (relay__RubyOptions__def*) apRubyOptions;
-
-      PLI_BYTE8** argv = pRubyOptions->mArgs;
-      uint argc = pRubyOptions->mCount;
-
-      ruby_options(argc, argv);
-
-      // free the memory used by command-line options
-      uint i;
-      for (i = 0; i < argc; i++) {
-        free(argv[i]);
-      }
-
-      free(argv);
-      free(pRubyOptions);
-
-
-    // start Ruby interpreter
-    ruby_run();
-
-
-    // Ruby interpreter is now finished, so clean it up before terminating this thread
-    ruby_finalize();
-    return NULL;
-  }
-
-  static void relay_ruby_run() {
-    relay__RubyOptions__def* pRubyOptions = malloc(sizeof(relay__RubyOptions__def));
-
-    if (pRubyOptions) {
-      pRubyOptions->mArgs = NULL;
-      pRubyOptions->mCount = 0;
-
-      // transform the arguments passed to this function by Verilog into command-line arguments for Ruby interpeter
-      vpiHandle vCall = vpi_handle(vpiSysTfCall, NULL);
-
-      if (vCall) {
-        vpiHandle vCallArgs = vpi_iterate(vpiArgument, vCall);
-
-        if (vCallArgs) {
-          vpiHandle vArg;
-          s_vpi_value argVal;
-          argVal.format = vpiStringVal;
-
-          while ((vArg = vpi_scan(vCallArgs)) != NULL) {
-            vpi_get_value(vArg, &argVal);
-
-            pRubyOptions->mCount++;
-
-
-            if (pRubyOptions->mArgs == NULL)
-              pRubyOptions->mArgs = malloc(sizeof(PLI_BYTE8*) * pRubyOptions->mCount);
-            else
-              pRubyOptions->mArgs = realloc(pRubyOptions->mArgs, sizeof(PLI_BYTE8*) * pRubyOptions->mCount);
-
-            assert(pRubyOptions->mArgs != NULL);
-
-
-            pRubyOptions->mArgs[pRubyOptions->mCount-1] = strdup(argVal.value.str);
-          }
-        }
-      }
-
-      pthread_create(&relay__rubyThread, 0, ruby_run_handshake, pRubyOptions);
-      return;
-    }
-
-    common_printf("error: unable to allocate memory for Ruby's command-line arguments.");
-    exit(EXIT_FAILURE);
-  }
-
-#endif

data/ext/ruby-vpi.c

@@ -1,36 +0,0 @@
-/*
-  Copyright 2006 Suraj N. Kurapati
-  Copyright 1999 Kazuhiro HIWADA
-
-  This file is part of Ruby-VPI.
-
-  Ruby-VPI is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License
-  as published by the Free Software Foundation; either version 2
-  of the License, or (at your option) any later version.
-
-  Ruby-VPI 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
-  GNU General Public License for more details.
-
-  You should have received a copy of the GNU General Public License
-  along with Ruby-VPI; if not, write to the Free Software Foundation,
-  Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
-*/
-
-/**\file
-  The Ruby-VPI extension, in a nutshell.
-*/
-
-#ifdef __cplusplus
-  extern "C" {
-#endif
-
-  #include "swig.cin"
-  #include "vlog.cin"
-  #include "relay.cin"
-
-#ifdef __cplusplus
-  }
-#endif

data/ext/vlog.cin

@@ -1,92 +0,0 @@
-/*
-  Copyright 2006 Suraj N. Kurapati
-  Copyright 1999 Kazuhiro HIWADA
-
-  This file is part of Ruby-VPI.
-
-  Ruby-VPI is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License
-  as published by the Free Software Foundation; either version 2
-  of the License, or (at your option) any later version.
-
-  Ruby-VPI 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
-  GNU General Public License for more details.
-
-  You should have received a copy of the GNU General Public License
-  along with Ruby-VPI; if not, write to the Free Software Foundation,
-  Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
-*/
-
-#ifndef VLOG_CIN
-#define VLOG_CIN
-
-  #include <assert.h>
-  #include "common.h"
-  #include "relay.hin"
-  #include "vlog.hin"
-
-
-  verilog_tf_funcSig(vlog_ruby_relay) {
-    // transfer control to ruby
-    relay_ruby();
-
-
-    // transfer control to verilog
-    verilog_tf_funcReturn(0);
-  }
-
-  verilog_tf_funcSig(vlog_ruby_init) {
-    // setup control transfer mechanism
-    relay_init();
-
-
-    // start ruby interpreter and transfer control to it
-    relay_ruby_run();
-
-
-    // transfer control to verilog
-    verilog_tf_funcReturn(0);
-  }
-
-  #ifndef SYNOPSYS_VCS
-    static void vlog_bind_task(PLI_BYTE8* apTaskName, verilog_tf_funcPtr(apTaskDef)) {
-      s_vpi_systf_data tf;
-
-      tf.type = vpiSysTask;
-      tf.sysfunctype = 0;
-      tf.tfname = apTaskName;
-      tf.calltf = (verilog_tf_funcPtr_strict())apTaskDef;
-      tf.compiletf = NULL;
-      tf.sizetf = NULL;
-      tf.user_data = NULL;
-
-      vpi_register_systf(&tf);
-    }
-
-    /**
-      Binds the default VPI tasks (provided by Ruby-VPI) before the Verilog simulator begins to simulate.
-    */
-    static void vlog_startup() {
-      vlog_bind_task("$ruby_init", vlog_ruby_init);
-      vlog_bind_task("$ruby_relay", vlog_ruby_relay);
-    }
-
-    void (*vlog_startup_routines[])() = { vlog_startup, 0 };
-
-    #ifdef PRAGMATIC_CVER
-      /**
-        Invokes each routine specified in the vlog_startup_routines array.
-
-        This code was originally taken from GPL Cver 2.11a: Copyright (c) 1991-2005 Pragmatic C Software Corp.
-      */
-      void vlog_startup_routines_bootstrap() {
-        uint i;
-        for (i = 0; vlog_startup_routines[i] != NULL; i++)
-          vlog_startup_routines[i]();
-      }
-    #endif
-  #endif
-
-#endif

data/lib/ruby-vpi/synopsys_vcs.tab

@@ -1,2 +0,0 @@
-$ruby_init	call=vlog_ruby_init	acc=wn:*
-$ruby_relay	call=vlog_ruby_relay	acc=wn:*

data/ref/c/relay_8cin.html

@@ -1,204 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
-<title>Ruby-VPI: relay.cin File Reference</title>
-<link href="doxygen.css" rel="stylesheet" type="text/css">
-<link href="tabs.css" rel="stylesheet" type="text/css">
-</head><body>
-<!-- Generated by Doxygen 1.4.7 -->
-<div class="tabs">
-  <ul>
-    <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
-    <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
-    <li id="current"><a href="files.html"><span>Files</span></a></li>
-  </ul></div>
-<div class="tabs">
-  <ul>
-    <li><a href="files.html"><span>File&nbsp;List</span></a></li>
-    <li><a href="globals.html"><span>Globals</span></a></li>
-  </ul></div>
-<h1>relay.cin File Reference</h1><code>#include &lt;stdlib.h&gt;</code><br>
-<code>#include &lt;pthread.h&gt;</code><br>
-<code>#include &lt;ruby.h&gt;</code><br>
-<code>#include &lt;assert.h&gt;</code><br>
-<code>#include &quot;<a class="el" href="verilog_8h.html">verilog.h</a>&quot;</code><br>
-<code>#include &quot;<a class="el" href="common_8h.html">common.h</a>&quot;</code><br>
-<code>#include &quot;<a class="el" href="relay_8hin.html">relay.hin</a>&quot;</code><br>
-<code>#include &quot;<a class="el" href="swig_8hin.html">swig.hin</a>&quot;</code><br>
-<table border="0" cellpadding="0" cellspacing="0">
-<tr><td></td></tr>
-<tr><td colspan="2"><br><h2>Data Structures</h2></td></tr>
-<tr><td class="memItemLeft" nowrap align="right" valign="top">struct &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrelay____RubyOptions____def.html">relay__RubyOptions__def</a></td></tr>
-
-<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
-<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="relay_8cin.html#3200e521b223bc6f09430c60ddebb8be">relay_init</a> ()</td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="relay_8cin.html#2780928864223802e61d338188f95a60">relay_ruby</a> ()</td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="relay_8cin.html#f7fcb35f079ab7f3f568adf6f7bb9c2f">relay_verilog</a> ()</td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top">static void *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="relay_8cin.html#c9322be286809df2b947ef11da69e2fd">ruby_run_handshake</a> (void *apRubyOptions)</td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="relay_8cin.html#84bc77ed3fd41c02a85a338390abdc7a">relay_ruby_run</a> ()</td></tr>
-
-<tr><td colspan="2"><br><h2>Variables</h2></td></tr>
-<tr><td class="memItemLeft" nowrap align="right" valign="top">static pthread_t&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="relay_8cin.html#b7e726577af7e3a6e01b747b741a8112">relay__rubyThread</a></td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top">static pthread_mutex_t&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="relay_8cin.html#28b9f9f296b0ef144d005c01ac1fe49f">relay__rubyLock</a></td></tr>
-
-<tr><td class="memItemLeft" nowrap align="right" valign="top">static pthread_mutex_t&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="relay_8cin.html#16c2cdb7e43e9d99b680843830f8a2f1">relay__verilogLock</a></td></tr>
-
-</table>
-<hr><h2>Function Documentation</h2>
-<a class="anchor" name="3200e521b223bc6f09430c60ddebb8be"></a><!-- doxytag: member="relay.cin::relay_init" ref="3200e521b223bc6f09430c60ddebb8be" args="()" -->
-<div class="memitem">
-<div class="memproto">
-      <table class="memname">
-        <tr>
-          <td class="memname">static void relay_init           </td>
-          <td>(</td>
-          <td class="paramname">          </td>
-          <td>&nbsp;)&nbsp;</td>
-          <td width="100%"><code> [static]</code></td>
-        </tr>
-      </table>
-</div>
-<div class="memdoc">
-
-<p>
-
-</div>
-</div><p>
-<a class="anchor" name="2780928864223802e61d338188f95a60"></a><!-- doxytag: member="relay.cin::relay_ruby" ref="2780928864223802e61d338188f95a60" args="()" -->
-<div class="memitem">
-<div class="memproto">
-      <table class="memname">
-        <tr>
-          <td class="memname">static void relay_ruby           </td>
-          <td>(</td>
-          <td class="paramname">          </td>
-          <td>&nbsp;)&nbsp;</td>
-          <td width="100%"><code> [static]</code></td>
-        </tr>
-      </table>
-</div>
-<div class="memdoc">
-
-<p>
-
-</div>
-</div><p>
-<a class="anchor" name="84bc77ed3fd41c02a85a338390abdc7a"></a><!-- doxytag: member="relay.cin::relay_ruby_run" ref="84bc77ed3fd41c02a85a338390abdc7a" args="()" -->
-<div class="memitem">
-<div class="memproto">
-      <table class="memname">
-        <tr>
-          <td class="memname">static void relay_ruby_run           </td>
-          <td>(</td>
-          <td class="paramname">          </td>
-          <td>&nbsp;)&nbsp;</td>
-          <td width="100%"><code> [static]</code></td>
-        </tr>
-      </table>
-</div>
-<div class="memdoc">
-
-<p>
-
-</div>
-</div><p>
-<a class="anchor" name="f7fcb35f079ab7f3f568adf6f7bb9c2f"></a><!-- doxytag: member="relay.cin::relay_verilog" ref="f7fcb35f079ab7f3f568adf6f7bb9c2f" args="()" -->
-<div class="memitem">
-<div class="memproto">
-      <table class="memname">
-        <tr>
-          <td class="memname">static void relay_verilog           </td>
-          <td>(</td>
-          <td class="paramname">          </td>
-          <td>&nbsp;)&nbsp;</td>
-          <td width="100%"><code> [static]</code></td>
-        </tr>
-      </table>
-</div>
-<div class="memdoc">
-
-<p>
-
-</div>
-</div><p>
-<a class="anchor" name="c9322be286809df2b947ef11da69e2fd"></a><!-- doxytag: member="relay.cin::ruby_run_handshake" ref="c9322be286809df2b947ef11da69e2fd" args="(void *apRubyOptions)" -->
-<div class="memitem">
-<div class="memproto">
-      <table class="memname">
-        <tr>
-          <td class="memname">static void* ruby_run_handshake           </td>
-          <td>(</td>
-          <td class="paramtype">void *&nbsp;</td>
-          <td class="paramname"> <em>apRubyOptions</em>          </td>
-          <td>&nbsp;)&nbsp;</td>
-          <td width="100%"><code> [static]</code></td>
-        </tr>
-      </table>
-</div>
-<div class="memdoc">
-
-<p>
-<dl compact><dt><b>Parameters:</b></dt><dd>
-  <table border="0" cellspacing="2" cellpadding="0">
-    <tr><td valign="top"></td><td valign="top"><em>apRubyOptions</em>&nbsp;</td><td><a class="el" href="structrelay____RubyOptions____def.html">relay__RubyOptions__def</a> structure which contains command-line options passsed to the Ruby interpreter. </td></tr>
-  </table>
-</dl>
-<dl compact><dt><b>Note:</b></dt><dd>The structure will be freed *deeply* after use. </dd></dl>
-
-</div>
-</div><p>
-<hr><h2>Variable Documentation</h2>
-<a class="anchor" name="28b9f9f296b0ef144d005c01ac1fe49f"></a><!-- doxytag: member="relay.cin::relay__rubyLock" ref="28b9f9f296b0ef144d005c01ac1fe49f" args="" -->
-<div class="memitem">
-<div class="memproto">
-      <table class="memname">
-        <tr>
-          <td class="memname">pthread_mutex_t <a class="el" href="relay_8cin.html#28b9f9f296b0ef144d005c01ac1fe49f">relay__rubyLock</a><code> [static]</code>          </td>
-        </tr>
-      </table>
-</div>
-<div class="memdoc">
-
-<p>
-
-</div>
-</div><p>
-<a class="anchor" name="b7e726577af7e3a6e01b747b741a8112"></a><!-- doxytag: member="relay.cin::relay__rubyThread" ref="b7e726577af7e3a6e01b747b741a8112" args="" -->
-<div class="memitem">
-<div class="memproto">
-      <table class="memname">
-        <tr>
-          <td class="memname">pthread_t <a class="el" href="relay_8cin.html#b7e726577af7e3a6e01b747b741a8112">relay__rubyThread</a><code> [static]</code>          </td>
-        </tr>
-      </table>
-</div>
-<div class="memdoc">
-
-<p>
-
-</div>
-</div><p>
-<a class="anchor" name="16c2cdb7e43e9d99b680843830f8a2f1"></a><!-- doxytag: member="relay.cin::relay__verilogLock" ref="16c2cdb7e43e9d99b680843830f8a2f1" args="" -->
-<div class="memitem">
-<div class="memproto">
-      <table class="memname">
-        <tr>
-          <td class="memname">pthread_mutex_t <a class="el" href="relay_8cin.html#16c2cdb7e43e9d99b680843830f8a2f1">relay__verilogLock</a><code> [static]</code>          </td>
-        </tr>
-      </table>
-</div>
-<div class="memdoc">
-
-<p>
-
-</div>
-</div><p>
-<hr size="1"><address style="align: right;"><small>Generated on Tue Oct 24 12:19:09 2006 for Ruby-VPI by&nbsp;
-<a href="http://www.doxygen.org/index.html">
-<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.7 </small></address>
-</body>
-</html>