← Back to branch summary

~clint-fewbar/ubuntu/precise/erlang/merge-15b

« back to all changes in this revision

Viewing changes to lib/ic/doc/src/ch_c_mapping.xml

  • Committer: Bazaar Package Importer
  • Author(s): Clint Byrum
  • Date: 2011-05-05 15:48:43 UTC
  • mfrom: (3.5.13 sid)
  • Revision ID: james.westby@ubuntu.com-20110505154843-0om6ekzg6m7ugj27
Tags: 1:14.b.2-dfsg-3ubuntu1
* Merge from debian unstable.  Remaining changes:
  - Drop libwxgtk2.8-dev build dependency. Wx isn't in main, and not
    supposed to.
  - Drop erlang-wx binary.
  - Drop erlang-wx dependency from -megaco, -common-test, and -reltool, they
    do not really need wx. Also drop it from -debugger; the GUI needs wx,
    but it apparently has CLI bits as well, and is also needed by -megaco,
    so let's keep the package for now.
  - debian/patches/series: Do what I meant, and enable build-options.patch
    instead.
* Additional changes:
  - Drop erlang-wx from -et
* Dropped Changes:
  - patches/pcre-crash.patch: CVE-2008-2371: outer level option with
    alternatives caused crash. (Applied Upstream)
  - fix for ssl certificate verification in newSSL: 
    ssl_cacertfile_fix.patch (Applied Upstream)
  - debian/patches/series: Enable native.patch again, to get stripped beam
    files and reduce the package size again. (build-options is what
    actually accomplished this)
  - Remove build-options.patch on advice from upstream and because it caused
    odd build failures.

Show diffs side-by-side

added added

removed removed

Lines of Context:
lib/ic/doc/src/ch_c_mapping.xml
4
4
<chapter>
5
5
  <header>
6
6
    <copyright>
7
 
      <year>1998</year><year>2009</year>
 
7
      <year>1998</year><year>2010</year>
8
8
      <holder>Ericsson AB. All Rights Reserved.</holder>
9
9
    </copyright>
10
10
    <legalnotice>
13
13
      compliance with the License. You should have received a copy of the
14
14
      Erlang Public License along with this software. If not, it can be
15
15
      retrieved online at http://www.erlang.org/.
16
 
    
 
16
 
17
17
      Software distributed under the License is distributed on an "AS IS"
18
18
      basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
19
19
      the License for the specific language governing rights and limitations
20
20
      under the License.
21
 
    
 
21
 
22
22
    </legalnotice>
23
23
 
24
24
    <title>IDL to C mapping</title>
770
770
        <p>While the <c>erlang::binary</c> idl type has the same C-definition as 
771
771
          a generated sequence of octets :</p>
772
772
        <code type="none"><![CDATA[
773
 
\011  module erlang
774
 
\011  {
775
 
 
776
 
\011  ....
777
 
 
778
 
\011  // an erlang binary
779
 
\011  typedef sequence<octet> binary;
780
 
\011  
781
 
\011  };
 
773
      module erlang
 
774
      {
 
775
 
 
776
      ....
 
777
 
 
778
      // an erlang binary
 
779
      typedef sequence<octet> binary;
 
780
      
 
781
      };
782
782
        ]]></code>
783
783
        <p>it provides a way on sending trasparent  data between C and Erlang.</p>
784
784
        <p>The C-definition (ic.h) for an erlang binary is :</p>
785
785
        <code type="none">
786
 
\011  typedef struct {
787
 
\011  CORBA_unsigned_long _maximum;
788
 
\011  CORBA_unsigned_long _length;
789
 
\011  CORBA_octet* _buffer;
790
 
\011  } erlang_binary;                        /* ERLANG BINARY */
 
786
      typedef struct {
 
787
      CORBA_unsigned_long _maximum;
 
788
      CORBA_unsigned_long _length;
 
789
      CORBA_octet* _buffer;
 
790
      } erlang_binary;                        /* ERLANG BINARY */
791
791
        </code>
792
792
        <p>The differences (between <c>erlang::binary</c> and <c><![CDATA[sequence< octet >]]></c>) are :</p>
793
793
        <list type="bulleted">
804
804
              octets</p>
805
805
          </item>
806
806
        </list>
807
 
        <p>The erlang binary IDL type is defined in <c>erlang.idl</c>, while it's 
 
807
        <p>The erlang binary IDL type is defined in <c>erlang.idl</c>, while its 
808
808
          C definition is located in the <c>ic.h</c> header file, both in the 
809
809
          <c><![CDATA[IC-< vsn >/include]]></c> directory.
810
810
          The user will have to include the file <c>erlang.idl</c> in order to use the