friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/ifstime.htm

1195 lines
32 KiB
HTML
Raw Blame History

<!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>Integrated File System APIs--Time Stamp Updates</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: -->
<!-- YYMMDD USERID Change description -->
<!-- Unix2 SCRIPT J converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
<!-- 010301 JTROUS Change to include fchdir, pread, pread64, pwrite, -->
<!-- pwrite64 for V5R2, DCR 98686 -->
<!-- 040401 JKUGEL Change to include accessx related APIs, 98686 -->
<!-- 010511 JTROUS Change to include qpofptos documentation, 98841 -->
<!-- 020131 JTROUS Changes from API Review 3, V5R2 -->
<!-- File cleanup completed Feb 2002 by v2cdijab -->
<!-- 020313 JTROUS Changes for scan processing, V5R3, DCR 98680 -->
<!-- 020410 RTHEIS Add fclear() and fclear64(), V5R3, DCR 99096 -->
<!-- 030317 ERICKSD Add Qp0lRRO(), DCR99188.04 -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<!-- End Header Records -->
<!-- Java sync-link -->
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<a name="Top_Of_Page"></a>
<h2>Integrated File System APIs--Time Stamp Updates</h2>
<p>Each object (file and directory) has three time values associated with
it:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>Access Time</em></td>
<td align="left" valign="top">The time that the data in the object is
accessed.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Change Time</em></td>
<td align="left" valign="top">The time that the attributes of the object are
changed.</td>
</tr>
<tr>
<td align="left" valign="top"><em>Modify Time</em></td>
<td align="left" valign="top">The time that the data in the object is
changed.</td>
</tr>
</table>
<p>These values are returned by the <strong>stat()</strong>, <strong>
fstat()</strong>, <strong>lstat()</strong>, and
<strong>QlgStat()</strong> APIs.</p>
<p>When it is stated that an API sets or updates one of these time values, the
value may be &quot;marked for update&quot; by the API rather than actually updated. When
a subsequent <strong>stat()</strong>, <strong>fstat()</strong>, <strong>
lstat()</strong>, and <strong>
QlgStat()</strong> API is
called, or the file is closed by all processes, the times that were previously
&quot;marked for update&quot; are updated and the update marks are cleared.</p>
<p>The value of these times is measured in seconds since the Epoch. The Epoch
is the time 0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated
Universal Time. If the system date is set prior to 1970, all time values will
be zero. The following table shows which of these times are &quot;marked for update&quot;
by each of the APIs.<br>
</p>
<table border width="90%">
<tr>
<th align="left" valign="bottom" colspan="4"><em>Time Stamp Updates for
Integrated File System APIs</em></th>
</tr>
<tr>
<th align="left" valign="top">Function</th>
<th align="left" valign="top">Access</th>
<th align="left" valign="top">Change</th>
<th align="left" valign="top">Modify</th>
</tr>
<tr>
<td align="left" valign="top" width="55%">access</td>
<td align="left" valign="top" width="15%">No</td>
<td align="left" valign="top" width="15%">No</td>
<td align="left" valign="top" width="15%">No</td>
</tr>
<tr>
<td align="left" valign="top">accessx</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">chdir</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">chmod</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">chown</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">close</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">closedir</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">creat<sup>1</sup> (new file)</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">creat<sup>1</sup> (parent directory of new
file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">creat<sup>2</sup> (existing file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">DosSetFileLocks</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">DosSetRelMaxFH</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">dup</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">dup2</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">faccessx</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">fchdir</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">fchmod</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">fchown</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">fclear</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">fclear64</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">fcntl</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">fpathconf</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">fstat</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">fstatvfs</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">fsync</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">ftruncate</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">getcwd</td>
<td align="left" valign="top">Yes<sup>3</sup></td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getegid</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">geteuid</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getgid</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getgrgid</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getgrgid_r</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getgrnam</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getgrnam_r</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getgroups</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getpwnam</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getpwnam_r</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getpwuid</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getpwuid_r</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">getuid</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">givedescriptor</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">ioctl</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">lchown</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">link<sup>4</sup> (file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">link<sup>4</sup> (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">lseek</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">lstat</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">mkdir<sup>5</sup> (new directory)</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">mkdir<sup>5</sup> (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">mkfifo<sup>6</sup> (new directory)</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">mkfifo<sup>6</sup> (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">open O_CREAT<sup>7</sup> (new file)</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">open O_CREAT<sup>7</sup> (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">open O_TRUNC<sup>8</sup> (existing file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">open<sup>9</sup> (existing file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">opendir</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">pathconf</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">pread</td>
<td align="left" valign="top">Yes<sup>14</sup></td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">pread64</td>
<td align="left" valign="top">Yes<sup>14</sup></td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">pwrite</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">pwrite64</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgAccess</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgAccessx</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgChdir</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgChmod</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgChown</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgCreat<sup>1</sup> (new file)</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgCreat<sup>1</sup> (parent directory of new
file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgCreat<sup>2</sup> (existing file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgCvtPathToQSYSObjName</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgGetAttr</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgGetcwd</td>
<td align="left" valign="top">Yes<sup>3</sup></td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgGetPathFromFileID</td>
<td align="left" valign="top">Yes<sup>10</sup></td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgLchown</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgLink<sup>4</sup> (file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgLink<sup>4</sup> (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgLstat</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgMkdir<sup>5</sup> (new directory)</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgMkdir<sup>5</sup> (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgMkfifo<sup>5</sup> (new directory)</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgMkfifo<sup>5</sup> (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgOpen O_CREAT<sup>7</sup> (new file)</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgOpen O_CREAT<sup>7</sup> (parent
directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgOpen O_TRUNC<sup>8</sup> (existing file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgOpen<sup>9</sup> (existing file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgOpendir</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgPathconf</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgProcessSubtree</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgReaddir</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgReaddir_r</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgReadlink</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgRenameKeep (parent directories)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgRenameUnlink (parent directories)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgRmdir (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgSetAttr</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgStat</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgStatvfs</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgSymlink<sup>11</sup> (new link)</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgSymlink<sup>11</sup> (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QlgUtime<sup>13</sup></td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgUnlink<sup>12</sup> (file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QlgUnlink<sup>12</sup> (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QP0FPTOS</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QP0LCHSG</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">Qp0lCvtPathToQSYSObjName</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">Qp0lGetAttr</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">Qp0lGetPathFromFileID</td>
<td align="left" valign="top">Yes<sup>10</sup></td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">Qp0lProcessSubtree</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">Qp0lRenameKeep (parent directories)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">Qp0lRenameUnlink (parent directories)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">QP0LROR</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QP0LRRO</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">QP0LRTSG</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">Qp0lSetAttr</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">qsysetegid()</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">qsyseteuid()</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">qsysetgid()</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">qsysetregid()</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">qsysetreuid()</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">qsysetuid()</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">read</td>
<td align="left" valign="top">Yes<sup>14</sup></td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">readv</td>
<td align="left" valign="top">Yes<sup>14</sup></td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">readdir</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">readdir_r</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">readlink</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">rewinddir</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">rmdir (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">select</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">stat</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">statvfs</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">symlink<sup>11</sup> (new link)</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">symlink<sup>11</sup> (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">sysconf</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">takedescriptor</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">umask</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">unlink<sup>12</sup> (file)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">unlink<sup>12</sup> (parent directory)</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">utime<sup>13</sup></td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">No</td>
</tr>
<tr>
<td align="left" valign="top">write</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top">writev</td>
<td align="left" valign="top">No</td>
<td align="left" valign="top">Yes</td>
<td align="left" valign="top">Yes</td>
</tr>
<tr>
<td align="left" valign="top" colspan="4"><strong>Notes:</strong>
<ol type="1">
<li>When the file did not previously exist, a successful <strong>
creat()</strong> or <strong>QlgCreat()</strong> set the access, change, and
modification times for the new file. It also sets the change and modification
times of the directory that contains the new file (parent directory).<br>
<br>
</li>
<li>When the file previously existed, a successful <strong>creat()</strong> or
<strong>QlgCreat()</strong> sets the change and modification times for the
file.<br>
<br>
</li>
<li>The access time of each directory in the absolute path name of the current
directory (excluding the current directory itself) is updated.<br>
<br>
</li>
<li>A successful <strong>link()</strong> or <strong>QlgLink()</strong> sets the
change time of the file and the change and modification times of the directory
that contains the new link (parent directory).<br>
<br>
</li>
<li>A successful <strong>mkdir()</strong> or <strong>QlgMkdir()</strong> sets
the access, change, and modification times for the new directory. It also sets
the change and modification times of the directory that contains the new
directory (parent directory).<br>
<br>
</li>
<li>A successful <strong>mkfifo()</strong> or <strong>QlgMkfifo()</strong> sets
the access, change, and modification times for the new FIFO
(first-in-first-out) special file. It also sets the change and modification
times of the parent directory that contains the new FIFO file.<br>
<br>
</li>
<li>When O_CREAT is specified and the file did not previously exist, a
successful <strong>open()</strong> or <strong>QlgOpen()</strong> sets the
access, change, and modification times for the new file. It also sets the
change and modification times of the directory that contains the new file
(parent directory).<br>
<br>
</li>
<li>When O_TRUNC is specified and the file previously existed, a successful
<strong>open()</strong> or <strong>QlgOpen()</strong> sets the change and
modification times for the file.<br>
<br>
</li>
<li>When O_CREAT and O_TRUNC are not specified, <strong>open()</strong> or
<strong>QlgOpen()</strong> does not update any time stamps.<br>
<br>
</li>
<li>A successful <strong>Qp0lGetPathFromFileID()</strong> or <strong>
QlgGetPathFromFileID()</strong> sets the access time of each directory in the
absolute path name to the file.<br>
<br>
</li>
<li>A successful <strong>symlink()</strong> or <strong>QlgSymlink()</strong>
sets the access, change, and modification times for the new symbolic link. It
also sets the change and modification times of the directory that contains the
new directory (parent directory).<br>
<br>
</li>
<li>A successful <strong>unlink()</strong> or <strong>QlgUnlink()</strong> sets
the change and modification times of the directory that contains the file being
unlinked (parent directory). If the link count for the file is not zero, the
change time for the file is set.<br>
<br>
</li>
<li>A successful <strong>utime()</strong> or <strong>QlgUtime()</strong> sets
the access and modify times of the file as specified by the application. The
change time of the file is set to the current time.<br>
<br></li>
<li>
If the read operation was done using a scan descriptor passed to one of the
integrated file system scan related exit programs, the Access time is
<strong>not</strong> updated.
See
<a href="ifsopenexit.htm">Integrated File System Scan on Open Exit Programs</a>
and
<a href="ifscloseexit.htm">Integrated File System Scan on Close Exit Programs</a>
for more information.
</li>
</ol>
</td>
</tr>
</table>
<br>
<br>
<hr>
<table align="center" 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>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink