Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.16.4  Dcreate                                                    TOS

 Name:         »Create directory« - Create a directory.

 Opcode:       57

 Syntax:       int32_t Dcreate ( CONST int8_t *path );

 Description:  The GEMDOS routine Dcreate creates a directory with the 
               pathname path, which has to be terminated with the 
               ASCII character 0, on the specified drive.

               Note: Due to defective error-handling in GEMDOS 
               Versions < 0.15, the file-system could be damaged in 
               some circumstances. Furthermore, no check was made 
               whether a file with the specified name already exists.

               As of MagiC 3, the call is passed on by the kernel as 
               xfs_dcreate with creation mode Fxattr %0100000111101101 
               (i.e. a 'directory file' with access permissions 
               RWXRwXRwX). The XFS should not delete any files or 
               subdirectories of the same name, but return the error- 
               code EACCDN in this case. Invalid filenames "." or ".." 
               must also be intercepted by the XFS.

 Return value: The function can return the following results:

                E_OK    No error has arisen
                EPTHNF  Directory not found
                EACCDN  Access denied

 Availability: All GEMDOS versions.

 Group:        Directory functions

 See also:     Binding   Ddelete   ASCII table