xPCFSOpenFile

Open file on target computer

Prototype

int xPCFSOpenFile(int port, const char *filename,
const char *permission);

Note

Do not use this C API type definition. Support for this type definition relies on support for the C API, which will be removed in a future release.

Arguments

port

Enter the value returned by the function xPCOpenTcpIpPort.

filename

Enter the name of a file on the target computer.

permission

Enter the read/write permission with which to open the file. Values are r (read) or w (read/write).

Return

Returns the file handle for the opened file. If function detects an error, it returns -1.

Description

The xPCFSOpenFile function opens the specified file, filename, on the target computer. If the file does not exist, the xPCFSOpenFile function creates filename, then opens it. You can open a file for read or read/write access.

There are the following limitations:

  • You can have at most 128 files open on the target computer at the same time.

  • The largest single file that you can create on the target computer is 4 GB.

  • A fully qualified folder name can have a maximum of 248 characters, including the drive letter, colon, and backslash.

  • A fully qualified file name in the operating system on the target computer can have a maximum of 260 characters. If the file name is longer than eight-dot-three format (eight character file name, period, three character extension), the operating system represents the file name in truncated form (for example, six characters followed by '~1'). MATLAB commands can access the file using the fully qualified file name or the truncated representation of the name. Some block parameters, such as the Scope block filename parameter, require 8.3 format for the file name.

  • Do not write data to the private folder on your target computer. It is reserved for Simulink® Real-Time™ internal use.

Introduced before R2006a