doc/new_pool.3.html

   1 <html>
   2 <head>
   3 <meta name="generator" content="groff -Thtml, see www.gnu.org">
   4 <meta name="Content-Style" content="text/css">
   5 <title>new_pool</title>
   6 </head>
   7 <body>
   8
   9 <h1 align=center>new_pool</h1>
  10 <a href="#NAME">NAME</a><br>
  11 <a href="#SYNOPSIS">SYNOPSIS</a><br>
  12 <a href="#DESCRIPTION">DESCRIPTION</a><br>
  13 <a href="#AUTHOR">AUTHOR</a><br>
  14 <a href="#LICENSE">LICENSE</a><br>
  15 <a href="#VERSION">VERSION</a><br>
  16 <a href="#SEE ALSO">SEE ALSO</a><br>
  17
  18 <hr>
  19 <!-- Creator     : groff version 1.17.2 -->
  20 <!-- CreationDate: Fri May  3 14:57:08 2002 -->
  21 <a name="NAME"></a>
  22 <h2>NAME</h2>
  23 <table width="100%" border=0 rules="none" frame="void"
  24        cols="2" cellspacing="0" cellpadding="0">
  25 <tr valign="top" align="left">
  26 <td width="10%"></td><td width="90%">
  27 new_pool - allocate a new pool</td></table>
  28 <a name="SYNOPSIS"></a>
  29 <h2>SYNOPSIS</h2>
  30
  31 <table width="100%" border=0 rules="none" frame="void"
  32        cols="2" cellspacing="0" cellpadding="0">
  33 <tr valign="top" align="left">
  34 <td width="10%"></td><td width="90%">
  35 <pre><b>#include &lt;pool.h&gt;
  36
  37 pool new_pool (void);
  38 </b></pre></td></table>
  39 <a name="DESCRIPTION"></a>
  40 <h2>DESCRIPTION</h2>
  41
  42 <table width="100%" border=0 rules="none" frame="void"
  43        cols="2" cellspacing="0" cellpadding="0">
  44 <tr valign="top" align="left">
  45 <td width="10%"></td><td width="90%">
  46 Allocate a new pool. Pools must eventually be deleted
  47 explicitly by calling <b>delete_pool(3)</b>.</td></table>
  48
  49 <table width="100%" border=0 rules="none" frame="void"
  50        cols="2" cellspacing="0" cellpadding="0">
  51 <tr valign="top" align="left">
  52 <td width="10%"></td><td width="90%">
  53 Note that <b>new_pool</b> is now deprecated. It is almost
  54 always better to create a subpool of the global pool,
  55 ie:</td></table>
  56
  57 <table width="100%" border=0 rules="none" frame="void"
  58        cols="2" cellspacing="0" cellpadding="0">
  59 <tr valign="top" align="left">
  60 <td width="10%"></td><td width="90%">
  61 <b>pool = new_subpool (global_pool);</b></td></table>
  62
  63 <table width="100%" border=0 rules="none" frame="void"
  64        cols="2" cellspacing="0" cellpadding="0">
  65 <tr valign="top" align="left">
  66 <td width="10%"></td><td width="90%">
  67 This has the distinct advantage that your new pool will be
  68 cleaned up properly if the process calls
  69 <b>exit</b>.</td></table>
  70 <a name="AUTHOR"></a>
  71 <h2>AUTHOR</h2>
  72
  73 <table width="100%" border=0 rules="none" frame="void"
  74        cols="2" cellspacing="0" cellpadding="0">
  75 <tr valign="top" align="left">
  76 <td width="10%"></td><td width="90%">
  77 Richard Jones &lt;rich@annexia.org&gt;</td></table>
  78 <a name="LICENSE"></a>
  79 <h2>LICENSE</h2>
  80
  81 <table width="100%" border=0 rules="none" frame="void"
  82        cols="2" cellspacing="0" cellpadding="0">
  83 <tr valign="top" align="left">
  84 <td width="10%"></td><td width="90%">
  85 GNU LGPL (see http://www.gnu.org/)</td></table>
  86 <a name="VERSION"></a>
  87 <h2>VERSION</h2>
  88
  89 <table width="100%" border=0 rules="none" frame="void"
  90        cols="2" cellspacing="0" cellpadding="0">
  91 <tr valign="top" align="left">
  92 <td width="10%"></td><td width="90%">
  93 c2lib-1.2.13</td></table>
  94 <a name="SEE ALSO"></a>
  95 <h2>SEE ALSO</h2>
  96
  97 <table width="100%" border=0 rules="none" frame="void"
  98        cols="2" cellspacing="0" cellpadding="0">
  99 <tr valign="top" align="left">
 100 <td width="10%"></td><td width="90%">
 101 <b>new_subpool(3)</b>, <b>global_pool(3)</b>,
 102 <b>delete_pool(3)</b>.</td></table>
 103 <hr>
 104 </body>
 105 </html>