ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/gtgnar64.htm

83 lines
2.7 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>getgrnam_r_ts64()--Get Group Information Using Group Name</title>
<!-- Begin Header Records -->
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<!-- Change History: -->
<!-- file cleaned -->
<!-- GTGNAR64 SCR A converted by B2H R4.1 (346) (CMS) by V2CDIJAB at -->
<!-- RCHVMW2 on 18 Sep 2000 at 09:55:07 -->
<!-- This file has undergone html cleanup May 2002 by JET -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<!--End Header Records --><!-- Java sync-link -->
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
</script>
<a name="Top_Of_Page"></a>
<h2>getgrnam_r_ts64()--Get Group Information Using Group Name</h2>
<div class="box" style="width: 70%;">
<br>
&nbsp;&nbsp;Syntax<br>
<pre>
#include &lt;sys/types.h&gt;
#include &lt;grp.h&gt;
int getgrnam_r_ts64(
const char <em>* __ptr64 name</em>,
struct group <em>* __ptr64 grp</em>,
char <em>* __ptr64 buffer</em>,
size_t <em>bufsize</em>,
struct group <em>* __ptr64 * __ptr64 result</em>);
</pre>
&nbsp;&nbsp;Service Program Name: QSYPAPI64<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: Yes<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The <strong>getgrnam_r_ts64()</strong> function updates the group structure
pointed to by <em>grp</em> and stores a pointer to that structure in the
location pointed to by <em>result</em>. The structure contains an entry from
the user database with a matching <em>name</em>. <strong>
getgrnam_r_ts64()</strong> differs from <strong>getgrnam_r()</strong> in that
it accepts 8-byte teraspace pointers.</p>
<p>For a discussion of the parameters, authorities required, return values,
related information, usage notes, and an example for the <strong>
getgrnam_r()</strong> API, see <a href="gtgrnamr.htm">getgrnam_r()</a>--Get
Group Information Using Group Name.</p>
<hr>
API introduced: V5R1
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"unix.htm">UNIX-Type APIs</a> | <a href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</center>
</body>
</html>