NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERROR MESSAGES | ATTRIBUTES
#include <arpa/ftpd/systemFilesys.h>off_t systemAsciiOff(FtpConn *conn, char *name, int offset);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
This function converts an offset relative to the FTP-encoded version of the text in a file, to an offset relative to the text version. The routine reads an FTP-encoded file specified by name, converting it on-the-fly to text format.
Starting from the beginning of the file, the function counts byte by byte until it reaches the number of bytes specified by the argument offset. End of line (EOL) characters are physically encoded on 2 bytes ('\n' + '\r'), but for each EOL encountered, only one byte is added to the measured offset. Therefore, if a file contains EOL characters, the measured offset is less than the argument offset; if the file doesn't contain any EOL characters, the measured offset is equal to the argument offset.
If the argument offset is bigger than the size of name, an end of file (EOF) will be reached before offset is achieved, and an error will be returned.
If successful, returns the offset measured in the text file. If unsuccessful, returns --1.
Resource allocation problem.
File name problem.
File seek problem, including an incorrect number of characters in the file.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERROR MESSAGES | ATTRIBUTES