]> Zhao Yanbai Git Server - minix.git/commitdiff
Added truncate/ftruncate manpage.
authorBen Gras <ben@minix3.org>
Mon, 13 Feb 2006 12:53:50 +0000 (12:53 +0000)
committerBen Gras <ben@minix3.org>
Mon, 13 Feb 2006 12:53:50 +0000 (12:53 +0000)
man/man2/truncate.2 [new file with mode: 0644]

diff --git a/man/man2/truncate.2 b/man/man2/truncate.2
new file mode 100644 (file)
index 0000000..4102e6d
--- /dev/null
@@ -0,0 +1,30 @@
+.TH TRUNCATE 2 "Feb 13, 2006"
+.UC 4
+.SH NAME
+truncate, ftruncate \- truncate a file to a specified length (may extend)
+.SH SYNOPSIS
+.ft B
+.nf
+#include <unistd.h>
+
+int truncate(char *filename, off_t length);
+int ftruncate(int fd, off_t length);
+.fi
+.ft R
+.SH DESCRIPTION
+.B Truncate
+causes the file 
+.B filename
+to be set to the length
+.B length
+causing data after that size to be lost. If the file is set to a 
+length larger than the current file size, the new region can be
+written to but reads as zeroes. There will be no disk blocks reserved
+for it. This is a hole.
+.PP
+.B Ftruncate
+does the same thing as 
+.B truncate
+but operates on a file descriptor instead of a filename.
+.SH "SEE ALSO
+.BR fcntl (2)