11.16 SYS_OPEN (0x01)

Opens a file on the host system.

The file path is specified either as relative to the current directory of the host process, or absolute, using the path conventions of the host operating system.
ARM targets interpret the special path name :tt as meaning the console input stream, for an open-read or the console output stream, for an open-write. Opening these streams is performed as part of the standard startup code for those applications that reference the C stdio streams.


On entry, R1 contains a pointer to a three-word argument block:
word 1
A pointer to a null-terminated string containing a file or device name.
word 2
An integer that specifies the file opening mode. The following table gives the valid values for the integer, and their corresponding ISO C fopen() mode.
word 3
An integer that gives the length of the string pointed to by word 1.
The length does not include the terminating null character that must be present.

Table 11-3 Value of mode

mode 0 1 2 3 4 5 6 7 8 9 10 11
ISO C fopen modea r rb r+ r+b w wb w+ w+b a ab a+ a+b


On exit, R0 contains:
  • a nonzero handle if the call is successful
  • –1 if the call is not successful.
The non-ANSI option t is not supported.
Non-ConfidentialPDF file icon PDF versionARM DUI0375F
Copyright © 2007, 2008, 2011, 2012, 2014 ARM. All rights reserved.