jimzah/freebsd-src
1
0
Fork 0
mirror of https://github.com/freebsd/freebsd-src.git synced 2024-11-28 04:43:32 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

Document that truncate can also be used to extend the size of a file,

Browse Source 
but doing so is not truly portable.
This commit is contained in:
Alexander Langer 1996-06-07 01:34:47 +00:00
parent 4eaf2ef2cd
commit 79020cf23f
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=16165
1 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
lib/libc/sys/truncate.2
View File

@ -37,7 +37,7 @@
.Sh NAME
.Nm truncate ,
.Nm ftruncate
.Nd truncate a file to a specified length
.Nd truncate or extend a file to a specified length
.Sh SYNOPSIS
.Fd #include <unistd.h>
.Ft int
@ -50,11 +50,13 @@ causes the file named by
.Fa path
or referenced by
.Fa fd
to be truncated to at most
to be truncated or extended to
.Fa length
bytes in size. If the file previously
was larger than this size, the extra data
is lost.
If the file was smaller than this size,
extra zeros are appended.
With
.Fn ftruncate ,
the file must be open for writing.
@ -116,6 +118,10 @@ is not open for writing.
.Sh BUGS
These calls should be generalized to allow ranges
of bytes in a file to be discarded.
.Pp
Use of
.Fn truncate
to extend a file is not portable.
.Sh HISTORY
The
.Nm