← Back to branch summary

~ubuntu-branches/ubuntu/trusty/erlang/trusty

« back to all changes in this revision

Viewing changes to lib/erl_interface/doc/src/erl_connect.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/erl_interface/doc/src/erl_connect.xml
4
4
<cref>
5
5
  <header>
6
6
    <copyright>
7
 
      <year>1996</year><year>2009</year>
 
7
      <year>1996</year><year>2010</year>
8
8
      <holder>Ericsson AB. All Rights Reserved.</holder>
9
9
    </copyright>
10
10
    <legalnotice>
451
451
        <p><c><![CDATA[port]]></c> is the local name to register, and should be the
452
452
          same as the port number that was previously bound to the socket.</p>
453
453
        <p>To unregister with epmd, simply close the returned
454
 
          descriptor. See also <c><![CDATA[erl_unpublish()]]></c>.
 
454
          descriptor.
455
455
          </p>
456
456
        <p>On success, the functions return a descriptor connecting the
457
457
          calling process to epmd. On failure, they return -1 and set
507
507
    </func>
508
508
    <func>
509
509
      <name><ret>int</ret><nametext>erl_unpublish(alive)</nametext></name>
510
 
      <fsummary>Unpublish a node name</fsummary>
 
510
      <fsummary>Forcefully unpublish a node name</fsummary>
511
511
      <type>
512
512
        <v>char *alive;</v>
513
513
      </type>
514
514
      <desc>
515
 
        <p>This function can be called by a process to unregister a
516
 
          specified node name from epmd on the localhost. This may be
517
 
          useful, for example, when epmd has not detected the failure of a
518
 
          node, and will not allow the name to be reused. If you use this
519
 
          function to unregister your own process, be sure to also close
520
 
          the descriptor that was returned by <c><![CDATA[erl_publish()]]></c>.</p>
521
 
        <note>
522
 
          <p>Careless use of this function may have unpredictable
523
 
            results, if the registered node is in fact still running.</p>
524
 
        </note>
 
515
       <p>This function can be called by a process to unregister a
 
516
          specified node from epmd on the localhost. This is however usually not 
 
517
          allowed, unless epmd was started with the -relaxed_command_check 
 
518
          flag, which it normally isn't.</p>
 
519
 
 
520
          <p>To unregister a node you have published, you should instead
 
521
          close the descriptor that was returned by  
 
522
          <c><![CDATA[ei_publish()]]></c>.</p> 
 
523
 
 
524
        <warning>
 
525
          <p>This function is deprecated and will be removed in a future 
 
526
          release.</p>
 
527
        </warning>
525
528
        <p><c><![CDATA[alive]]></c> is the name of the node to unregister, i.e., the
526
529
          first component of the nodename, without the <c><![CDATA[@hostname]]></c>.</p>
527
530
        <p>If the node was successfully unregistered from epmd, the