Return to truncate.2 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man2

Annotation of cci/usr/src/man/man2/truncate.2, revision 1.1

1.1     ! root        1: .TH TRUNCATE 2 "7 July 1983"
        !             2: .UC 4
        !             3: .SH NAME
        !             4: truncate \- truncate a file to a specified length
        !             5: .SH SYNOPSIS
        !             6: .nf
        !             7: .ft B
        !             8: truncate(path, length)
        !             9: char *path;
        !            10: int length;
        !            11: .PP
        !            12: .ft B
        !            13: ftruncate(fd, length)
        !            14: int fd, length;
        !            15: .fi
        !            16: .SH DESCRIPTION
        !            17: .I Truncate
        !            18: causes the file named by
        !            19: .I path
        !            20: or referenced by
        !            21: .I fd
        !            22: to be truncated to at most
        !            23: .I length
        !            24: bytes in size.  If the file previously
        !            25: was larger than this size, the extra data
        !            26: is lost.
        !            27: With
        !            28: .IR ftruncate ,
        !            29: the file must be open for writing.
        !            30: .SH "RETURN VALUES
        !            31: A value of 0 is returned if the call succeeds.  If the call
        !            32: fails a \-1 is returned, and the global variable \fIerrno\fP
        !            33: specifies the error.
        !            34: .SH "ERRORS
        !            35: .I Truncate
        !            36: succeeds unless:
        !            37: .TP 15
        !            38: [EPERM]
        !            39: The pathname contains a character with the high-order bit set.
        !            40: .TP 15
        !            41: [ENOENT]
        !            42: The pathname was too long.
        !            43: .TP 15
        !            44: [ENOTDIR]
        !            45: A component of the path prefix of \fIpath\fP is not a directory.
        !            46: .TP 15
        !            47: [ENOENT]
        !            48: The named file does not exist.
        !            49: .TP 15
        !            50: [EACCES]
        !            51: A component of the \fIpath\fP prefix denies search permission.
        !            52: .TP 15
        !            53: [EISDIR]
        !            54: The named file is a directory.
        !            55: .TP 15
        !            56: [EROFS]
        !            57: The named file resides on a read-only file system.
        !            58: .TP 15
        !            59: [ETXTBSY]
        !            60: The file is a pure procedure (shared text) file that is being executed.
        !            61: .TP 15
        !            62: [EFAULT]
        !            63: .I Name
        !            64: points outside the process's allocated address space.
        !            65: .PP
        !            66: .I Ftruncate
        !            67: succeeds unless:
        !            68: .TP 15
        !            69: [EBADF]
        !            70: The
        !            71: .I fd
        !            72: is not a valid descriptor.
        !            73: .TP 15
        !            74: [EINVAL]
        !            75: The
        !            76: .I fd
        !            77: references a socket, not a file.
        !            78: .SH "SEE ALSO"
        !            79: open(2)
        !            80: .SH BUGS
        !            81: Partial blocks discarded as the result of truncation
        !            82: are not zero filled; this can result in holes in files
        !            83: which do not read as zero.
        !            84: .PP
        !            85: These calls should be generalized to allow ranges
        !            86: of bytes in a file to be discarded.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.