388 lines
24 KiB
HTML
388 lines
24 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="reference" />
|
|
<meta name="DC.Title" content="Integrated file system APIs" />
|
|
<meta name="abstract" content="Use this table as a quick reference for UNIX-type optical file system APIs." />
|
|
<meta name="description" content="Use this table as a quick reference for UNIX-type optical file system APIs." />
|
|
<meta name="DC.Relation" scheme="URI" content="ifs.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2000, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2000, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="unixapitable" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- 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. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Integrated file system APIs</title>
|
|
</head>
|
|
<body id="unixapitable"><a name="unixapitable"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Integrated file system APIs</h1>
|
|
<div><p>Use this table as a quick reference for UNIX-type optical file
|
|
system APIs.</p>
|
|
<div class="section"><p>Like all file systems, the optical file system has unique rules
|
|
and restrictions for applications that access optical functions through the
|
|
integrated file system. Several of the UNIX-type APIs and generic commands
|
|
are not supported. Others are only partially supported, or restricted. </p>
|
|
<p>Review
|
|
the following tables to better understand supported and unsupported APIs and
|
|
commands.</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><caption>Table 1. Optical
|
|
implementation of UNIX-type APIs</caption><tbody><tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e26"><strong>UNIX-type API</strong></th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e26 "><strong>Supported</strong></td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e26 "><strong>Comments and usage notes</strong></td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e36">access (Determine File Accessibility)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e36 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e36 ">Requires *X authority to the parent optical volume.
|
|
For non-Universal Disk Format (UDF) volumes, no other authority is required.
|
|
For UDF formatted volumes, the following authorization rules apply:<ul><li>Requires *X authority to each directory in the path preceding the object
|
|
tested.</li>
|
|
<li>Requires *R authority when R_OK is specified.</li>
|
|
<li>Requires *W authority when W_OK is specified.</li>
|
|
<li>Requires *X authority when X_OK is specified.</li>
|
|
<li>Requires *RX authority when R_OK|X_OK is specified.</li>
|
|
<li>Requires *WX authority when W_OK|X_OK is specified.</li>
|
|
<li>Requires *RX authority when R_OK|W_OK is specified.</li>
|
|
<li>Requires no authority when F_OK is specified.</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e60">accessx (Determine File accessibility based on the <strong>who</strong> parameter)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e60 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e60 ">Does not require *X authority to the parent optical
|
|
volume. For UDF volumes, the following authorization rules apply:<div class="p">Valid
|
|
values for the <strong>who</strong> parameter are:<ul><li>ACC_INVOKER</li>
|
|
<li>ACC_SELF</li>
|
|
<li>ACC_ALL</li>
|
|
<li>ACC_OTHERS</li>
|
|
</ul>
|
|
<ol><li>Requires *R authority when R_OK is specified</li>
|
|
<li>Requires *W authority when W_OK is specified</li>
|
|
<li>Requires *X authority when X_OK is specified</li>
|
|
</ol>
|
|
</div>
|
|
<p>Authority checks are mutually exclusive.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e93">chdir (Change Current Directory)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e93 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e93 ">Requires *X authority to the parent optical volume. <p>For
|
|
non-UDF volumes, no other authority is required. </p>
|
|
<p>For UDF formatted
|
|
volumes, *X authority is required to each directory in the path</p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e104">chmod (Change File Authorizations)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e104 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e104 ">Only supported for UDF formatted optical volumes. Requires
|
|
*CHANGE authority to the parent optical volume. Requires *X authority to each
|
|
directory in the path preceding the object. To perform this operation, you
|
|
must be the owner of the file or have *ALLOBJ special authority.</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e111">chown (Change Owner and Group of File)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e111 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e111 ">Only supported for UDF formatted optical volumes. Requires
|
|
*CHANGE authority to the parent optical volume. Requires *X authority to each
|
|
directory in the path preceding the object. To perform this operation, you
|
|
must be the owner of the file, or have *ALLOBJ special authority. Files and
|
|
directories on non-UDF formatted volumes are owned by QDFTOWN user profile.</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e118">close (Close File Descriptor)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e118 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e118 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e124">closedir (Close Directory)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e124 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e124 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e130">creat (Create or Rewrite File)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e130 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e130 ">Requires *CHANGE authority to the parent optical volume.
|
|
For non-UDF volumes, no other authority is required. For UDF formatted volumes,
|
|
*X authority is required to each directory in the path and *WX authority to
|
|
the parent directory.<p> The change and modification time stamps for the parent
|
|
directory are not updated. </p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e139">dup (Duplicate Open File Descriptor)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e139 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e139 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e145">dup2 (Duplicate Open File Descriptor to Another Descriptor)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e145 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e145 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e151">fchmod (Change File Authorizations by Descriptor)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e151 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e151 ">Only supported for UDF formatted optical volumes. To
|
|
perform this operation, you must be the owner of the file or have *ALLOBJ
|
|
special authority.</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e158">fchown (Change Owner and Group of File by Descriptor)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e158 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e158 ">Only supported for UDF formatted optical volumes. To
|
|
perform this operation, you must be the owner of the file or have *ALLOBJ
|
|
special authority. Files and directories on non-UDF formatted volumes are
|
|
owned by QDFTOWN user profile.</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e165">fcntl (Perform File Control Command)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e165 ">No</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e165 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e171">fpathconf (Get Configurable Path Name Variables by Descriptor)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e171 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e171 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e177">fstat (Get File Information by Descriptor)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e177 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e177 ">Owner, group, and other mode bits are always on, regardless
|
|
of the user's authority to the file. <p>File access time stamp is not changed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e186">fsync (Synchronize Changes to File)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e186 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e186 ">For UDF formatted volumes, data is forced to optical
|
|
disk. For non-UDF formatted volumes, data is forced to internal disk storage
|
|
that is recoverable through held optical files.</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e193">ftruncate (Truncate File)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e193 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e193 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e199">getcwd (Get Current<sup>®</sup> Directory)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e199 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e199 ">Requires *X authority to the parent optical volume.
|
|
For non-UDF volumes, no other authority is required. For UDF formatted volumes,
|
|
*RX authority is required to each directory in the path name preceding the
|
|
object.</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e209">getegid</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e209 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e209 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e215">geteuid</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e215 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e215 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e221">getgid</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e221 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e221 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e227">getgrid</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e227 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e227 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e233">getgrnam</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e233 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e233 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e239">getgroups</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e239 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e239 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e245">getpwnam</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e245 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e245 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e251">getpwuid</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e251 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e251 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e257">getuid</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e257 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e257 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e263">ioctl (Perform File I/O Control Request)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e263 ">No</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e263 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e269">link (Create Link to File)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e269 ">No</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e269 ">QOPT does not support links.</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e276">lseek (Get File Read/Write Offset)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e276 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e276 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e282">lstat (Get File or Link Information)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e282 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e282 ">File access time stamp is not changed. <p>Requires *X
|
|
authority to the parent optical volume. For non-UDF volumes, no other authority
|
|
is required. For UDF formatted volumes, *X authority is required to each directory
|
|
in the path preceding the object and *R authority is required to the object.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e291">mkdir (Make Directory)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e291 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e291 ">Requires *CHANGE authority to the parent optical volume.
|
|
For non-UDF volumes, no other authority is required. For UDF formatted volumes,
|
|
*X authority is required to each directory in the path and *WX authority to
|
|
the parent directory.<p> The change and modification time stamps for the parent
|
|
directory are not updated. </p>
|
|
<p>Owner ID and group ID are not set.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e302">open (Open File)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e302 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e302 ">If the file is opened for write access , *CHANGE authority
|
|
is required to the parent optical volume. <p>If the file is opened for read
|
|
access, *USE authority is required to the parent optical volume.</p>
|
|
<div class="p">For
|
|
UDF formatted volumes, the following additional authorization rules apply:<ul><li>Requires *R authority when object is being opened O_RDONLY.</li>
|
|
<li>Requires *W authority when object is being opened O_WRONLY.</li>
|
|
<li>Requires *RW authority when object is being opened O_RDWR.</li>
|
|
<li>Requires *WX to the parent directory when object does not exist and O_CREAT
|
|
is specified.</li>
|
|
</ul>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e322">opendir (Open Directory)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e322 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e322 ">Requires *USE authority to the parent optical volume.<p>For
|
|
UDF formatted volumes, *X authority is required to each directory in the path
|
|
preceding the object, and *R authority is required to the object being opened.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e331">pathconf (Get Configuration Path Name Variables)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e331 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e331 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e337">Qp0lGetPathFromFileId</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e337 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e337 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e343">Qp0lRenameKeep</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e343 ">Partial</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e343 ">QOPT does not support renaming a directory. The object
|
|
must be a file. <p>Requires *CHANGE authority to the parent optical volume.
|
|
For non-UDF volumes, no other authority is required. UDF formatted volumes
|
|
require *X authority to each directory in the path, and *WX authority to the
|
|
parent directory, and *W authority to the file. If renaming the volume, *RWX
|
|
is required to the root (/) directory of the volume.</p>
|
|
<p>New and old files
|
|
must exist in the same directory.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e354">Qp0lRenameUnLink</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e354 ">Partial</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e354 ">QOPT does not support renaming a directory. The object
|
|
must be a file. <p>Requires *CHANGE authority to the parent optical volume.
|
|
For non-UDF volumes, no other authority is required. UDF formatted volumes
|
|
require *X authority to each directory in the path, *WX authority to the parent
|
|
directory, and *W authority to the file. If renaming the volume, *RWX is required
|
|
to the root (/) directory of the volume.</p>
|
|
<p>The object that is identified
|
|
by a new path cannot exist.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e365">read (Read from File)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e365 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e365 ">The file access time is not updated. When reading from
|
|
files on volumes formatted in Universal Disk Format (UDF), byte locks on the
|
|
range being read are ignored. The same is true for readv().</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e372">readdir (Read Directory Entry)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e372 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e372 ">The directory access time is not updated.</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e379">readlink (Read Value of Symbolic Link)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e379 ">No</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e379 ">QOPT does not have symbolic links.</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e386">rename (Rename File or Directory)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e386 ">Partial</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e386 ">QOPT does not support renaming a directory. The object
|
|
must be a file or a volume. <p> Requires *CHANGE authority to the parent optical
|
|
volume. For non-UDF volumes, no other authority is required. UDF formatted
|
|
volumes require *X authority to each directory in the path, *WX authority
|
|
to the parent directory, and *W authority to the file. If renaming the volume,
|
|
*RWX is required to the root (/) directory of the volume.</p>
|
|
<p>The object
|
|
that is identified by a new path cannot exist.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e397">rewinddir</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e397 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e397 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e403">rmdir (Remove Directory)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e403 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e403 ">Requires *CHANGE authority to the parent optical volume.
|
|
For non-UDF volumes, no other authority is required. For UDF formatted volumes,
|
|
*X authority is required to each directory in the path and *WX authority is
|
|
required to the parent directory.<p>Change and modification time stamps for
|
|
the parent directory are not updated. </p>
|
|
<p>The operation will not be allowed
|
|
if the directory is busy.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e414">stat (Get File Information)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e414 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e414 ">File access time stamp is not changed. <p>Requires *X
|
|
authority to the parent optical volume. For non-UDF volumes, no other authority
|
|
is required. For UDF formatted volumes, *X authority is required to each directory
|
|
in the path preceding the object and *R authority is required to the object.
|
|
When issued to an optical volume, the size returned is the volume capacity
|
|
or 2␠147␠483␠647, whichever is smaller. </p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e423">symlink (Make Symbolic Link)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e423 ">No</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e423 ">QOPT does not support symbolic links.</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e430">sysconf (Get System Configuration Variables)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e430 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e430 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e436">unlink (Remove Link to File)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e436 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e436 ">Requires *CHANGE authority to the parent optical volume.
|
|
For non-UDF volumes, no other authority is required. For UDF formatted volumes,
|
|
*X authority is required to each directory in the path and *RX authority is
|
|
required to the parent directory.<p> Change and modification time stamps for
|
|
parent directory are not updated. </p>
|
|
<p>Link to a file cannot be removed
|
|
when a job has the file opened.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e447">unmask (Set Authorization Mask for Job)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e447 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e447 "> </td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e453">utime (Set File Access and Modification Times)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e453 ">No</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e453 ">QOPT does not support setting the file access or modification
|
|
time.</td>
|
|
</tr>
|
|
<tr><th valign="top" width="33.57664233576642%" class="firstcol" id="d0e460">write (Write to File)</th>
|
|
<td valign="top" width="13.503649635036496%" headers="d0e460 ">Yes</td>
|
|
<td valign="top" width="52.919708029197075%" headers="d0e460 ">Change and modification time stamps for the file are
|
|
updated when the file is closed. When writing to files on volumes formatted
|
|
in Universal Disk Format (UDF), byte locks on the range being written are
|
|
ignored. The same is true for writev().</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="ifs.htm" title="Read this topic collection to learn how to use UNIX-type APIs to program your optical file system.">Integrated file system programming</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |