Documentation

xPCFSOpenFile

Open file on target computer

Prototype

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

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 eight 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 can have a maximum of 260 characters: The file part can have at most 12 characters: eight for the file name, one for the period, and at most three for the file extension. A file name longer than eight characters is truncated to six characters followed by '~1'.

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

Introduced before R2006a

Was this topic helpful?