| Skip Navigation Links | |
| Exit Print View | |
 | man pages section 3: Basic Library Functions Oracle Solaris 11 Information Library |
| Skip Navigation Links | |
| Exit Print View | |
| man pages section 3: Basic Library Functions Oracle Solaris 11 Information Library |
enable_extended_FILE_stdio(3C)
posix_spawnattr_getschedparam(3C)
posix_spawnattr_getschedpolicy(3C)
posix_spawnattr_getsigdefault(3C)
posix_spawnattr_getsigignore_np(3C)
posix_spawnattr_getsigmask(3C)
posix_spawnattr_setschedparam(3C)
posix_spawnattr_setschedpolicy(3C)
posix_spawnattr_setsigdefault(3C)
posix_spawnattr_setsigignore_np(3C)
posix_spawnattr_setsigmask(3C)
posix_spawn_file_actions_addclose(3C)
posix_spawn_file_actions_addclosefrom_np(3C)
posix_spawn_file_actions_adddup2(3C)
posix_spawn_file_actions_addopen(3C)
posix_spawn_file_actions_destroy(3C)
posix_spawn_file_actions_init(3C)
pthread_attr_getdetachstate(3C)
pthread_attr_getinheritsched(3C)
pthread_attr_getschedparam(3C)
pthread_attr_getschedpolicy(3C)
pthread_attr_setdetachstate(3C)
pthread_attr_setinheritsched(3C)
pthread_attr_setschedparam(3C)
pthread_attr_setschedpolicy(3C)
pthread_barrierattr_destroy(3C)
pthread_barrierattr_getpshared(3C)
pthread_barrierattr_setpshared(3C)
pthread_condattr_getpshared(3C)
pthread_condattr_setpshared(3C)
pthread_cond_reltimedwait_np(3C)
pthread_key_create_once_np(3C)
pthread_mutexattr_getprioceiling(3C)
pthread_mutexattr_getprotocol(3C)
pthread_mutexattr_getpshared(3C)
pthread_mutexattr_getrobust(3C)
pthread_mutexattr_setprioceiling(3C)
pthread_mutexattr_setprotocol(3C)
pthread_mutexattr_setpshared(3C)
pthread_mutexattr_setrobust(3C)
pthread_mutex_getprioceiling(3C)
pthread_mutex_reltimedlock_np(3C)
pthread_mutex_setprioceiling(3C)
pthread_rwlockattr_destroy(3C)
pthread_rwlockattr_getpshared(3C)
pthread_rwlockattr_setpshared(3C)
pthread_rwlock_reltimedrdlock_np(3C)
pthread_rwlock_reltimedwrlock_np(3C)
pthread_rwlock_timedrdlock(3C)
pthread_rwlock_timedwrlock(3C)
rctlblk_get_enforced_value(3C)
- set a file to a specified length
#include <unistd.h>inttruncate(const char *path,off_tlength);
intftruncate(intfildes,off_tlength);
Thetruncate() function causes the regular file named bypath to havea size equal tolength bytes.
If the file previously was larger thanlength, the extra data isdiscarded. If the file was previously shorter than length, its size isincreased, and the extended area appears as if it were zero-filled.
The application must ensure that the process has write permission for thefile.
This function does not modify the file offset for any open filedescriptions associated with the file.
Theftruncate() function causes the regular file referenced byfildes to betruncated tolength. If the size of the file previously exceededlength,the extra data is no longer available to reads on the file. Ifthe file previously was smaller than this size,ftruncate() increases the sizeof the file with the extended area appearing as if it werezero-filled. The value of the seek pointer is not modified by acall toftruncate().
Theftruncate() function works only with regular files and shared memory. Iffildes refers to a shared memory object,ftruncate() sets the size ofthe shared memory object tolength. Iffildes refers to a directory oris not a valid file descriptor open for writing,ftruncate() fails.
If the effect offtruncate() is to decrease the size of ashared memory object or memory mapped file and whole pages beyond thenew end were previously mapped, then the whole pages beyond the newend shall be discarded.
If the effect offtruncate() is to increase the size of ashared memory object, it is unspecified if the contents of any mappedpages between the old end-of-file and the new are flushed to theunderlying object.
These functions do not modify the file offset for any open filedescriptions associated with the file. On successful completion, if the filesize is changed, these functions will mark for update thest_ctime andst_mtime fields of the file, and if the file is a regular file,theS_ISUID andS_ISGID bits of the file mode are left unchanged.
If the request would cause the file size to exceed the softfile size limit for the process, the request will fail and aSIGXFSZ signal will be generated for the process.
Upon successful completion,ftruncate() andtruncate() return0. Otherwise,-1 is returnedanderrno is set to indicate the error.
Theftruncate() andtruncate() functions will fail if:
A signal was caught during execution.
Thelength argument was less than 0.
Thelength argument was greater than the maximum file size.
An I/O error occurred while reading from or writing to a file system.
The named file resides on a read-only file system.
Thetruncate() function will fail if:
A component of the path prefix denies search permission, or write permission is denied on the file.
Thepath argument points outside the process' allocated address space.
Thepath argument is not an ordinary file.
The named file is a directory.
Too many symbolic links were encountered in resolvingpath.
The maximum number of file descriptors available to the process has been reached.
The length of the specified pathname exceeds {PATH_MAX} bytes, or the length of a component of the pathname exceeds {NAME_MAX} bytes.
A component ofpath does not name an existing file orpath is an empty string.
Additional space could not be allocated for the system file table.
A component of the path prefix ofpath is not a directory.
Thepath argument points to a remote machine and the link to that machine is no longer active.
Theftruncate() function will fail if:
The file exists, mandatory file/record locking is set, and there are outstanding record locks on the file (seechmod(2)).
Thefildes argument is not a file descriptor open for writing.
The file is a regular file andlength is greater than the offset maximum established in the open file description associated withfildes.
Thefildes argument references a file that was opened without write permission.
Thefildes argument does not correspond to an ordinary file.
Thefildes argument points to a remote machine and the link to that machine is no longer active.
Thetruncate() function may fail if:
Pathname resolution of a symbolic link produced an intermediate result whose length exceeds {PATH_MAX}.
Thetruncate() andftruncate() functions have transitional interfaces for 64-bit file offsets. Seelf64(5).
Seeattributes(5) for descriptions of the following attributes:
|
chmod(2),fcntl(2),open(2),attributes(5),lf64(5),standards(5)
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices |   |