comparison docs/ccguide/access.refentry @ 594:c0da1728ed5b

All refentries finished.
author roug
date Fri, 15 Nov 2002 21:49:51 +0000
parents fcb97f0ba24b
children
comparison
equal deleted inserted replaced
593:0fda6c7fe48e 594:c0da1728ed5b
6 6
7 <refsynopsisdiv> 7 <refsynopsisdiv>
8 <funcsynopsis> 8 <funcsynopsis>
9 <funcprototype> 9 <funcprototype>
10 <funcdef><function>access</function></funcdef> 10 <funcdef><function>access</function></funcdef>
11 <paramdef>char *<parameter>name</parameter></paramdef> 11 <paramdef>char *<parameter>fname</parameter></paramdef>
12 <paramdef>int <parameter>perm</parameter></paramdef> 12 <paramdef>int <parameter>perm</parameter></paramdef>
13 </funcprototype> 13 </funcprototype>
14 </funcsynopsis> 14 </funcsynopsis>
15 15
16 </refsynopsisdiv> 16 </refsynopsisdiv>
17 17
18 <refsect1><title>Description</title> 18 <refsect1><title>Description</title>
19 <para> 19 <para>
20 Placeholder 20 Access returns 0 if the access modes specified in "perm" are
21 correct for the user to access "fname". -1 is returned if the
22 file cannot be accessed.
23 </para>
24 <para>
25 The value for "perm" may be any legal OS-9 mode as used for
26 "open()" or "creat()", it may be zero, which tests whether the
27 file exists, or the path to it may be searched.
28 </para>
29 </refsect1>
30 <refsect1><title>Caveats</title>
31 <para>
32 NOTE that the "perm" value is <emphasis>not</emphasis> compatible with other
33 systems.
21 </para> 34 </para>
22 </refsect1> 35 </refsect1>
23 <refsect1><title>Diagnostics</title> 36 <refsect1><title>Diagnostics</title>
24 <para> 37 <para>
25 The appropiate error indication, if a value of -1 is returned, 38 The appropiate error indication, if a value of -1 is returned,