Topic       : Pure C Library Documentation
Author      : John Kormylo
Version     : LIB.HYP 1.0
Subject     : Documentation/Pure C Library
Nodes       : 1309
Index Size  : 32068
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : en
@default    : 
@help       : Help
@options    : +g -i -s +x +z -t4
@width      : 75
View Ref-File[ open ]

#include <stdio.h>

int open( const char* filename, int access, ... );

  <filename> is a string containing a filename (see Pathnames).
  <access> contains the option bitflags:
           O_RDONLY (0x00) read only
           O_WRONLY (0x01) write only
           O_RDWR   (0x02) read and write
           O_APPEND (0x08) start at end of file
           O_CREAT  (0x20) create new file
           O_TRUNC  (0x40) truncate file length to zero (on write)
           O_EXCL   (0X80) exclusive (error if O_CREAT used on old
                           file).
  <...> is there for compatibility only.  Arguments are not used.


Function opens a file and returns its GEMDOS handle.
It returns -1 on an error (see errno).

See also UNIX I/O, creat() and Fopen().