compiler/clib/creat.c

   1 /*
   2     Copyright © 1995-2003, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     ANSI C function creat().
   6 */
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11 #include <unistd.h>
  12 #include <fcntl.h>
  13
  14         int creat (
  15
  16 /*  SYNOPSIS */
  17         const char * pathname,
  18         int          mode)
  19
  20 /*  FUNCTION
  21         Creates a file with the specified mode and name.
  22
  23     INPUTS
  24         pathname - Path and filename of the file you want to open.
  25         mode - The access flags.
  26
  27     RESULT
  28         -1 for error or a file descriptor for use with write().
  29
  30     NOTES
  31         If the filesystem doesn't allow to specify different access modes
  32         for users, groups and others, then the user modes are used.
  33
  34         This is the same as open (pathname, O_CREAT|O_WRONLY|O_TRUNC, mode);
  35
  36         This function must not be used in a shared library or
  37         in a threaded application.
  38
  39     EXAMPLE
  40
  41     BUGS
  42
  43     SEE ALSO
  44         open(), close(), write(), fopen()
  45
  46     INTERNALS
  47
  48 ******************************************************************************/
  49 {
  50     return open (pathname, O_CREAT|O_WRONLY|O_TRUNC, mode);
  51 } /* creat */
  52