<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>ipc_addid</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="The Linux Kernel API" /><link rel="up" href="ch05.html#id2654382" title="IPC utilities" /><link rel="prev" href="re238.html" title="ipc_get_maxid" /><link rel="next" href="re240.html" title="ipcget_new" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>ipc_addid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re238.html">Prev</a> </td><th width="60%" align="center">IPC utilities</th><td width="20%" align="right"> <a accesskey="n" href="re240.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="ipc_addid"><a id="API-ipc-addid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ipc_addid —
add an IPC identifier
</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">int <b class="fsfunc">ipc_addid </b>(</code></td><td>struct ipc_ids * <var class="pdparam">ids</var>, </td></tr><tr><td> </td><td>struct kern_ipc_perm * <var class="pdparam">new</var>, </td></tr><tr><td> </td><td>int <var class="pdparam">size</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Arguments"><a id="id2655174"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ids</code></em></span></dt><dd><p>
IPC identifier set
</p></dd><dt><span class="term"><em class="parameter"><code>new</code></em></span></dt><dd><p>
new IPC permission set
</p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
limit for the number of used ids
</p></dd></dl></div></div><div class="refsect1" title="Description"><a id="id2655235"></a><h2>Description</h2><p>
Add an entry 'new' to the IPC ids idr. The permissions object is
initialised and the first free entry is set up and the id assigned
is returned. The 'new' entry is returned in a locked state on success.
On failure the entry is not locked and a negative err-code is returned.
</p><p>
Called with ipc_ids.rw_mutex held as a writer.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re238.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch05.html#id2654382">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re240.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>ipc_get_maxid</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>ipcget_new</span></td></tr></table></div></body></html>
