doc/html/ref/posix-files-and-directories.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >Files and Directories [POSIX Section 5]</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos Reference Manual"
  20 HREF="ecos-ref.html"><LINK
  21 REL="UP"
  22 TITLE="POSIX Standard Support"
  23 HREF="posix-standard-support.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Process Environment [POSIX Section 4]"
  26 HREF="posix-process-environment.html"><LINK
  27 REL="NEXT"
  28 TITLE="Input and Output [POSIX Section 6]"
  29 HREF="posix-input-and-output.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos Reference Manual</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="posix-process-environment.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 31. POSIX Standard Support</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="posix-input-and-output.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><DIV
  81 CLASS="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="POSIX-FILES-AND-DIRECTORIES">Files and Directories &#0091;POSIX Section 5&#0093;</H1
  86 ><DIV
  87 CLASS="SECT2"
  88 ><H2
  89 CLASS="SECT2"
  90 ><A
  91 NAME="AEN13039">Functions Implemented</H2
  92 ><TABLE
  93 BORDER="5"
  94 BGCOLOR="#E0E0F0"
  95 WIDTH="70%"
  96 ><TR
  97 ><TD
  98 ><PRE
  99 CLASS="SCREEN"
 100 >DIR &#0042;opendir( const char &#0042;dirname );
 101 struct dirent &#0042;readdir( DIR &#0042;dirp );
 102 int readdir&#0095;r( DIR &#0042;dirp, struct dirent &#0042;entry,
 103                struct dirent &#0042;&#0042;result );
 104 void rewinddir( DIR &#0042;dirp );
 105 int closedir( DIR &#0042;dirp );
 106 int chdir( const char &#0042;path );
 107 char &#0042;getcwd( char &#0042;buf, size&#0095;t size );
 108 int open( const char &#0042; path , int oflag , ... );
 109 int creat( const char &#0042; path, mode&#0095;t mode );
 110 int link( const char &#0042;existing, const char &#0042;new );
 111 int mkdir( const char &#0042;path, mode&#0095;t mode );
 112 int unlink( const char &#0042;path );
 113 int rmdir( const char &#0042;path );
 114 int rename( const char &#0042;old, const char &#0042;new );
 115 int stat( const char &#0042;path, struct stat &#0042;buf );
 116 int fstat( int fd, struct stat &#0042;buf );
 117 int access( const char &#0042;path, int amode );
 118 long pathconf(const char &#0042;path, int name);
 119 long fpathconf(int fd, int name);</PRE
 120 ></TD
 121 ></TR
 122 ></TABLE
 123 ></DIV
 124 ><DIV
 125 CLASS="SECT2"
 126 ><H2
 127 CLASS="SECT2"
 128 ><A
 129 NAME="AEN13042">Functions Omitted</H2
 130 ><TABLE
 131 BORDER="5"
 132 BGCOLOR="#E0E0F0"
 133 WIDTH="70%"
 134 ><TR
 135 ><TD
 136 ><PRE
 137 CLASS="SCREEN"
 138 >mode&#0095;t umask( mode&#0095;t cmask );
 139 int mkfifo( const char &#0042;path, mode&#0095;t mode );
 140 int chmod( const char &#0042;path, mode&#0095;t mode );                 &#0047;&#0047; TBA
 141 int fchmod( int fd, mode&#0095;t mode );                                &#0047;&#0047; TBA
 142 int chown( const char &#0042;path, uid&#0095;t owner, gid&#0095;t group );
 143 int utime( const char &#0042;path, const struct utimbuf &#0042;times ); &#0047;&#0047; TBA
 144 int ftruncate( int fd, off&#0095;t length );                          &#0047;&#0047; TBA</PRE
 145 ></TD
 146 ></TR
 147 ></TABLE
 148 ></DIV
 149 ><DIV
 150 CLASS="SECT2"
 151 ><H2
 152 CLASS="SECT2"
 153 ><A
 154 NAME="AEN13045">Notes</H2
 155 ><P
 156 ></P
 157 ><UL
 158 ><LI
 159 ><P
 160 >           If a call to <TT
 161 CLASS="FUNCTION"
 162 >open()</TT
 163 > or <TT
 164 CLASS="FUNCTION"
 165 >creat()</TT
 166 > supplies
 167             the third &#0095;mode&#0095; parameter, it will
 168             currently be ignored.
 169             </P
 170 ></LI
 171 ><LI
 172 ><P
 173 >           Most of the functionality of these functions depends on
 174             the underlying filesystem.
 175             </P
 176 ></LI
 177 ><LI
 178 ><P
 179 >           Currently<SPAN
 180 CLASS="emphasis"
 181 ><I
 182 CLASS="EMPHASIS"
 183 > access()</I
 184 ></SPAN
 185 > only checks the
 186             <SPAN
 187 CLASS="emphasis"
 188 ><I
 189 CLASS="EMPHASIS"
 190 >F&#0095;OK</I
 191 ></SPAN
 192 > mode explicitly, the others are
 193             all assumed to be true by default.
 194             </P
 195 ></LI
 196 ><LI
 197 ><P
 198 >           The maximum number of open files allowed is supplied by
 199             the CYGNUM&#0095;FILEIO&#0095;NFILE option. The maximum number
 200             of file descriptors is supplied by the CYGNUM&#0095;FILEIO&#0095;NFD
 201             option.
 202             </P
 203 ></LI
 204 ></UL
 205 ></DIV
 206 ></DIV
 207 ><DIV
 208 CLASS="NAVFOOTER"
 209 ><HR
 210 ALIGN="LEFT"
 211 WIDTH="100%"><TABLE
 212 SUMMARY="Footer navigation table"
 213 WIDTH="100%"
 214 BORDER="0"
 215 CELLPADDING="0"
 216 CELLSPACING="0"
 217 ><TR
 218 ><TD
 219 WIDTH="33%"
 220 ALIGN="left"
 221 VALIGN="top"
 222 ><A
 223 HREF="posix-process-environment.html"
 224 ACCESSKEY="P"
 225 >Prev</A
 226 ></TD
 227 ><TD
 228 WIDTH="34%"
 229 ALIGN="center"
 230 VALIGN="top"
 231 ><A
 232 HREF="ecos-ref.html"
 233 ACCESSKEY="H"
 234 >Home</A
 235 ></TD
 236 ><TD
 237 WIDTH="33%"
 238 ALIGN="right"
 239 VALIGN="top"
 240 ><A
 241 HREF="posix-input-and-output.html"
 242 ACCESSKEY="N"
 243 >Next</A
 244 ></TD
 245 ></TR
 246 ><TR
 247 ><TD
 248 WIDTH="33%"
 249 ALIGN="left"
 250 VALIGN="top"
 251 >Process Environment &#0091;POSIX Section 4&#0093;</TD
 252 ><TD
 253 WIDTH="34%"
 254 ALIGN="center"
 255 VALIGN="top"
 256 ><A
 257 HREF="posix-standard-support.html"
 258 ACCESSKEY="U"
 259 >Up</A
 260 ></TD
 261 ><TD
 262 WIDTH="33%"
 263 ALIGN="right"
 264 VALIGN="top"
 265 >Input and Output &#0091;POSIX Section 6&#0093;</TD
 266 ></TR
 267 ></TABLE
 268 ></DIV
 269 ></BODY
 270 ></HTML
 271 >