RTEMS 4.9.3 On-Line Library

Files and Directories Manager truncate - truncate a file to a specified length

RTEMS POSIX API User's Guide

4.4.31: truncate - truncate a file to a specified length

CALLING SEQUENCE:

#include <unistd.h>

int trunctate(
  const char *path,
  size_t      length
);

STATUS CODES:

ENOTDIR: A component of the path prefix is not a directory.
EINVAL: The pathname contains a character with the high-order bit set.
ENAMETOOLONG: A component of a pathname exceeded 255 characters, or an entire path name exceeded 1023 characters.
ENOENT: The named file does not exist.
EACCES: The named file is not writable by the user.
EACCES: Search permission is denied for a component of the path prefix.
ELOOP: Too many symbolic links were encountered in translating the pathname
EISDIR: The named file is a directory.
EROFS: The named file resides on a read-only file system
ETXTBSY: The file is a pure procedure (shared text) file that is being executed
EIO: An I/O error occurred updating the inode.
EFAULT: Path points outside the process's allocated address space.
EBADF: The fd is not a valid descriptor.

DESCRIPTION:

truncate() causes the file named by path or referenced by fd to be truncated to at most length bytes in size. If the file previously was larger than this size, the extra data is lost. With ftruncate(), the file must be open for writing.

NOTES:

NONE

RTEMS POSIX API User's Guide