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 ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_000_005_572"> </a>NAME</h4><blockquote>getgroups - get supplementary group IDs</blockquote><h4><a name = "tag_000_005_573"> </a>SYNOPSIS</h4><blockquote><pre><code>#include <<a href="systypes.h.html">sys/types.h</a>>#include <<a href="unistd.h.html">unistd.h</a>>int getgroups(int <i>gidsetsize</i>, gid_t <i>grouplist</i>[]);</code></pre></blockquote><h4><a name = "tag_000_005_574"> </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"> </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"> </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"> </a>EXAMPLES</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_578"> </a>APPLICATION USAGE</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_579"> </a>FUTURE DIRECTIONS</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_580"> </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"><sys/types.h></a></i>,<i><a href="unistd.h.html"><unistd.h></a></i>.</blockquote><h4>DERIVATION</h4><blockquote>Derived from the POSIX.1-1988 standard.</blockquote><hr size=2 noshade><center><font size=2>UNIX ® is a registered Trademark of The Open Group.<br>Copyright © 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 + -
显示快捷键?