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

96 lines
3.2 KiB
HTML

<!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>open64()--Open File (Large File Enabled)</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 -->
<!-- This file has undergone html cleanup May 2002 by JET -->
<!-- End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<!-- Java sync-link -->
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
</script>
<a name="Top_Of_Page"></a>
<h2>open64()--Open File (Large File Enabled)</h2>
<div class="box" style="width: 70%;">
<br>
&nbsp;&nbsp;Syntax<br>
<pre>
#include &lt;fcntl.h&gt;
int open64(const char <em>*path</em>, int <em>oflag</em>, . . .);
</pre>
&nbsp;&nbsp;Service Program Name: QP0LLIB1<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: Conditional; see Usage Notes for <a href="open.htm">open()</a>.<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The <strong>open64()</strong> function, similar to the <strong>
open()</strong> function, opens a file and returns a number called a file
descriptor. <strong>open64()</strong> differs from <strong>open()</strong> in
that it automatically opens the file with the O_LARGEFILE flag set. For a
further description of the open flags, see <a href="open.htm#HDROPNFLAG">Using
the oflag Parameter</a> in the <strong>open()</strong> API.</p>
<p>For a discussion of the parameters, authorities required, return values,
related information, and examples for the <strong>open()</strong> and <strong>
open64()</strong> APIs, see <a href="open.htm">open()--Open File</a>.</p>
<p>See <a href="open64u.htm">QlgOpen64()--Open File (Large File Enabled)</a>
for a description and an example of supplying the <em>path</em> in any
CCSID.</p>
<br>
<h3>Usage Notes</h3>
<ol type="1">
<li>When you develop in C-based languages, the prototypes for the 64-bit APIs
are normally hidden. To use the <strong>open64()</strong> API, you must compile
the source with the _LARGE_FILE_API macro defined.<br>
<br>
</li>
<li>All of the usage notes for <strong>open()</strong> apply to <strong>
open64()</strong> and <strong>QlgOpen64()</strong>. See <a href=
"open.htm#HDROPENUSG">Usage Notes</a> in the <strong>open()</strong> API.</li>
</ol>
<hr>
API introduced: V4R4
<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>