1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
.\" Copyright (c) 1983, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by the University of
.\" California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" @(#)truncate.2 6.9 (Berkeley) 3/10/91
.\"
.\" Modified Sat Jul 24 12:46:33 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Tue Oct 22 22:36:33 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Tranlsated Wed Jul 30 1997 by Nicols Lichtmaier <nick@debian.org>
.\"
.TH TRUNCATE 2 "24 de Julio de 1993" "Pgina de manual de BSD" "Manual del Programador Linux"
.SH NOMBRE
truncate, ftruncate \- trunca un fichero al largo especificado
.SH SINOPSIS
.B #include <unistd.h>
.sp
.BI "int truncate(const char *" nombre ", size_t " largo );
.br
.BI "int ftruncate(int " df ", size_t " largo );
.SH DESCRIPCIN
.B Truncate
causa que el fichero nombrado por
.IR nombre ,
o referido por
.IR df ,
quede trunco en un tamao de como mucho
.I largo
bytes. Si el fichero era ms grande que este valor los datos sobrantes se
pierden. Con
.B ftruncate
el fichero debe haber sido abierto para escritura.
.SH "VALOR REGRESADO"
En xito regresa cero. En error regresa \-1 y la variable
.I errno
es asignada apropiadamente.
.SH ERRORES
Para
.BR truncate :
.TP 0.8i
.B ENOTDIR
Un componente prefijo del nombre no es un directorio.
.TP
.B ENAMETOOLONG
Uno de los componentes del nombre excede los 255 caracteres,
o el nombre entero excede los 1023 caracteres.
.TP
.B ENOENT
El fichero nombrado no existe.
.TP
.B EACCES
Es negado el permiso de ejecucin para un componente prefijo del nombre.
.TP
.B EACCES
El fichero nombrado no es escribible por el usuario.
.TP
.B ELOOP
Demasiados enlaces simblicos fueron encontrados al traducir el nombre de
fichero.
.TP
.B EISDIR
El fichero nombrado es un directorio.
.TP
.B EROFS
El fichero nombrado reside en un sistema de ficheros de slo-lectura.
.TP
.B ETXTBSY
El fichero nombrado es un ejecutable que est siendo ejecutado actualmente.
.TP
.B EIO
Un error de E/S ocurri mientras se actualizaba el inodo.
.TP
.B EFAULT
.I Path
apunta fuero del espacio de direccines correspondiente al proceso.
.PP
Para
.BR Ftruncate :
.TP 0.8i
.B EBADF
El valor
.I df
no es un descriptor vlido.
.TP
.B EINVAL
El valor
.I df
hace referencia a un socket, no a un fichero.
.TP
.B EINVAL
El valor
.I df
representa un descriptor que no est abierto para escritura.
.SH "CONFORMA CON"
BSD 4.4, SVr4 (estas llamadas de funcin aparecieron primero en BSD 4.2). SVr4
documenta las siguientes condiciones de error adicionales para
.BR truncate :
EINTR, EMFILE, EMULTIHP, ENAMETOOLONG, ENFILE,
ENOLINK, ENOTDIR. SVr4 documenta para
.B ftruncate
las condiciones de error adicionales EAGAIN y EINTR.
.SH BUGS
Estas llamadas deberan ser generalizadas para permitir que sean descartados
rangos de bytes.
.SH "VASE TAMBIN"
.BR open (2)
|
