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.1  Dchroot                                                    TOS

 Name:         »Dchroot« - Change the root directory for the calling 
               process.

 Opcode:       330 (0x014a)

 Syntax:       int32_t Dchroot( int8_t *path );

 Description:  The path parameter is a pathname of the folder that 
               will be the new root directory for the calling process. 
               Directories and files which are outside of the 
               specified tree will no longer be accessible.

               Dchroot does not automatically change the current 
               directory to the newly specified root. Also, the call 
               needs root privileges to operate properly. This 
               function is used by e.g. ftpd to limit the user 
               privileges in accessing file-systems.

 Return value: Returns the E_OK on success, or a negative GEMDOS 
               error-code otherwise.

 Availability  As of FreeMiNT version 1.15.4

 Group:        Directories functions

 See also:     Binding   Dopendir   Dreaddir   MagiC