📄 getgrgid_r.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>getgrgid</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_554"> </a>NAME</h4><blockquote>getgrgid, getgrgid_r - get group database entry for a group ID</blockquote><h4><a name = "tag_000_005_555"> </a>SYNOPSIS</h4><blockquote><pre><code>#include <<a href="systypes.h.html">sys/types.h</a>>#include <<a href="grp.h.html">grp.h</a>>struct group *getgrgid(gid_t <i>gid</i>);int getgrgid_r(gid_t <i>gid</i>, struct group *<i>grp</i>, char *<i>buffer</i>, size_t <i>bufsize</i>, struct group **<i>result</i>);</code></pre></blockquote><h4><a name = "tag_000_005_556"> </a>DESCRIPTION</h4><blockquote>The<i>getgrgid()</i>function searches the group database for an entry with a matching<i>gid</i>.<p>The<i>getgrgid()</i>interface need not be reentrant.<p>The<i>getgrgid_r()</i>function updates the<b>group</b>structure pointed to by<i>grp</i>and stores a pointer to that structureat the location pointed to by<i>result.</i>The structure contains an entryfrom the group database with a matching<i>gid</i>.Storage referenced by the group structure is allocatedfrom the memory provided with the<i>buffer</i>parameter, which is<i>bufsize</i>characters in size.The maximum size needed for this buffer can be determined with the{_SC_GETGR_R_SIZE_MAX}<i><a href="sysconf.html">sysconf()</a></i>parameter.A NULL pointer is returned at the location pointed to by<i>result</i>on error or if the requested entry is not found.</blockquote><h4><a name = "tag_000_005_557"> </a>RETURN VALUE</h4><blockquote>Upon successful completion,<i>getgrgid()</i>returns a pointer to a<b>struct group</b>with the structure defined in<i><a href="grp.h.html"><grp.h></a></i>with a matching entry if one is found.The<i>getgrgid()</i>function returns a null pointer if either the requested entry wasnot found, or an error occurred.On error,<i>errno</i>will be set to indicate the error.<p>The return value may point to a static area which is overwrittenby a subsequent call to<i><a href="getgrent.html">getgrent()</a></i>,<i>getgrgid()</i>or<i><a href="getgrnam.html">getgrnam()</a></i>.<p>If successful, the<i>getgrgid_r()</i>function returns zero.Otherwise, an error number is returned to indicate the error.</blockquote><h4><a name = "tag_000_005_558"> </a>ERRORS</h4><blockquote>The<i>getgrgid()</i>function may fail if:<br><dl compact><dt>[EIO]<dd>An I/O error has occurred.<dt>[EINTR]<dd>A signal was caught during<i>getgrgid()</i>.<dt>[EMFILE]<dd>{OPEN_MAX} file descriptors are currently open in the calling process.<dt>[ENFILE]<dd>The maximum allowable number of files is currently open in thesystem.</dl><p>The <i>getgrgid_r()</i>function may fail if:<dl compact><dt>[ERANGE]<dd>Insufficient storage was supplied via<i>buffer</i>and<i>bufsize</i>to contain the data to be referenced by the resulting<b>group</b>structure.</dl></blockquote><h4><a name = "tag_000_005_559"> </a>EXAMPLES</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_560"> </a>APPLICATION USAGE</h4><blockquote>Applications wishing to check for error situations should set<i>errno</i>to 0 before calling<i>getgrgid()</i>.If<i>errno</i>is set on return,an error occurred.</blockquote><h4><a name = "tag_000_005_561"> </a>FUTURE DIRECTIONS</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_562"> </a>SEE ALSO</h4><blockquote><i><a href="endgrent.html">endgrent()</a></i>,<i><a href="getgrnam.html">getgrnam()</a></i>,<i><a href="grp.h.html"><grp.h></a></i>,<i><a href="limits.h.html"><limits.h></a></i>,<i><a href="systypes.h.html"><sys/types.h></a></i>.</blockquote><h4>DERIVATION</h4><blockquote><i>getgrgid()</i> derived from System V Release 2.0.<P><i>getgrgid_r()</i> derived from the POSIX Threads Extension (1003.1c-1995).</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 + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -