getgroups.html

来自「unix 下的C开发手册,还用详细的例程。」· HTML 代码 · 共 91 行

HTML
91
字号
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>getgroups</title></head><body bgcolor=white><center><font size=2>The Single UNIX &reg; Specification, Version 2<br>Copyright &copy; 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_000_005_572">&nbsp;</a>NAME</h4><blockquote>getgroups - get supplementary group IDs</blockquote><h4><a name = "tag_000_005_573">&nbsp;</a>SYNOPSIS</h4><blockquote><pre><code>#include &lt;<a href="systypes.h.html">sys/types.h</a>&gt;#include &lt;<a href="unistd.h.html">unistd.h</a>&gt;int getgroups(int <i>gidsetsize</i>, gid_t <i>grouplist</i>[]);</code></pre></blockquote><h4><a name = "tag_000_005_574">&nbsp;</a>DESCRIPTION</h4><blockquote>The<i>getgroups()</i>function fills in the array<i>grouplist</i>with the current supplementary group IDs of the calling process.<p>The<i>gidsetsize</i>argument specifies the number of elements in the array<i>grouplist</i>.The actual number of supplementary group IDs stored in thearray is returned.The values of array entries with indices greater than or equal tothe value returned are undefined.<p>If<i>gidsetsize</i>is 0,<i>getgroups()</i>returns the number of supplementary group IDs associated with thecalling process without modifying the array pointed to by<i>grouplist</i>.<p>It is unspecified whether the effective group ID of the callingprocess is included in, or omitted from, the returned list ofsupplementary group IDs.</blockquote><h4><a name = "tag_000_005_575">&nbsp;</a>RETURN VALUE</h4><blockquote>Upon successful completion, the number of supplementary group IDsis returned.A return value of -1 indicates failure and<i>errno</i>is set to indicate the error.</blockquote><h4><a name = "tag_000_005_576">&nbsp;</a>ERRORS</h4><blockquote>The<i>getgroups()</i>function will fail if:<dl compact><dt>[EINVAL]<dd>The<i>gidsetsize</i>argument is non-zero and is less than the number of supplementary group IDs.</dl></blockquote><h4><a name = "tag_000_005_577">&nbsp;</a>EXAMPLES</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_578">&nbsp;</a>APPLICATION USAGE</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_579">&nbsp;</a>FUTURE DIRECTIONS</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_580">&nbsp;</a>SEE ALSO</h4><blockquote><i><a href="getegid.html">getegid()</a></i>,<i><a href="setgid.html">setgid()</a></i>,<i><a href="systypes.h.html">&lt;sys/types.h&gt;</a></i>,<i><a href="unistd.h.html">&lt;unistd.h&gt;</a></i>.</blockquote><h4>DERIVATION</h4><blockquote>Derived from the POSIX.1-1988 standard.</blockquote><hr size=2 noshade><center><font size=2>UNIX &reg; is a registered Trademark of The Open Group.<br>Copyright &copy; 1997 The Open Group<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]</font></center><hr size=2 noshade></body></html>

⌨️ 快捷键说明

复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?