cvs commit: src/sys/ufs/ufs ufs_vnops.c

[Ceri Davies]

On Thu, Jun 01, 2006 at 02:00:00PM +0400, Maxim Konovalov wrote:
> On Thu, 1 Jun 2006, 10:49+0100, Ceri Davies wrote:
> 
> > On Thu, Jun 01, 2006 at 12:05:23PM +0930, Greg 'groggy' Lehey wrote:
> > > On Wednesday, 31 May 2006 at 13:15:29 +0000, Maxim Konovalov wrote:
> > > > maxim       2006-05-31 13:15:29 UTC
> > > >
> > > >   FreeBSD src repository
> > > >
> > > >   Modified files:
> > > >     sys/ufs/ufs          ufs_vnops.c
> > > >   Log:
> > > >   o According to POSIX, the result of ftruncate(2) is unspecified
> > > >   for file types other than VREG, VDIR and shared memory objects.
> > > >   We already handle VREG, VLNK and VDIR cases.  Silently ignore
> > > >
> > > >   Revision  Changes    Path
> > > >   1.276     +22 -4     src/sys/ufs/ufs/ufs_vnops.c
> > >
> > > Is this worth a man page update?
> >
> > Undoubtedly.  Does the attached look like enough?  I'm not sure if we
> > want to add a STANDARDS section for this when it's valid behaviour.
> 
> @@ -69,6 +69,10 @@
>  the file must be open for writing.
>  .Sh RETURN VALUES
>  .Rv -std
> +If the file to be modified is not a directory or
> +a regular file, the
> +.Fn truncate
> +call will return the value 0.
>  .Sh ERRORS
>  The
>  .Fn truncate
> 
> We need to mention truncate(2) does nothing for such files.

Whoops, yeah of course.

Index: src/lib/libc/sys/truncate.2
===================================================================
RCS file: /home/ncvs/src/lib/libc/sys/truncate.2,v
retrieving revision 1.17
diff -u -r1.17 truncate.2
--- src/lib/libc/sys/truncate.2	20 Jan 2005 09:17:05 -0000	1.17
+++ src/lib/libc/sys/truncate.2	1 Jun 2006 10:04:18 -0000
@@ -32,7 +32,7 @@
 .\"     @(#)truncate.2	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD: src/lib/libc/sys/truncate.2,v 1.17 2005/01/20 09:17:05 ru Exp $
 .\"
-.Dd June 4, 1993
+.Dd June 1, 2006
 .Dt TRUNCATE 2
 .Os
 .Sh NAME
@@ -69,6 +69,10 @@
 the file must be open for writing.
 .Sh RETURN VALUES
 .Rv -std
+If the file to be modified is not a directory or
+a regular file, the
+.Fn truncate
+call has no effect and returns the value 0.
 .Sh ERRORS
 The
 .Fn truncate

Ceri
-- 
That must be wonderful!  I don't understand it at all.
                                                  -- Moliere
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-src/attachments/20060601/abd1d026/attachment.pgp