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
133
134
135
136
|
.\" 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)
.\"
.\" Traduction 15/10/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" Mise a Jour 15/04/97
.TH TRUNCATE 2 "15 Avril 1997" BSD "Manuel du programmeur Linux"
.SH NOM
truncate, ftruncate \- Tronquer un fichier a une longueur donnee.
.SH SYNOPSIS
.B #include <unistd.h>
.sp
.BI "int truncate(const char *" path ", size_t " length );
.br
.BI "int ftruncate(int " fd ", size_t " length );
.SH DESCRIPTION
.B Truncate
tronque le fichier reference par
.I path
ou par le descripteur
.I fd
a une longueur maximale de
.I length
octets.
Si le fichier etait plus long les donnees supplementaires sont perdues.
Avec
.BR ftruncate ,
le fichier doit etre ouvert en ecriture.
.SH "VALEUR RENVOYEE"
.BR truncate ,
et
.BR ftruncate
renvoient 0 s'ils reussissent et \-1 s'ils echouent, auquel cas
.I errno
contient le code d'erreur.
.SH ERREURS
Pour
.BR truncate :
.TP 0.8i
.B ENOTDIR
un composant du chemin d'acces n'est pas un repertoire
.TP
.B EINVAL
Un mauvais caractere dans le chemin d'acces.
.TP
.B ENAMETOOLONG
Un composant du chemin depasse 255 caracteres ou
le chemin complet depasse 1023 caracteres.
.TP
.B ENOENT
Le fichier n'existe pas
.TP
.B EACCES
Un composant du chemin d'acces ne permet pas le parcours
.TP
.B EACCES
Le fichier n'est pas accessible en ecriture.
.TP
.B ELOOP
Le chemin contient une reference circulaire (a travers un lien symbolique)
.TP
.B EISDIR
Le fichier est en realite un repertoire
.TP
.B EROFS
Le fichier se trouve sur un systeme de fichiers en lecture seule.
.TP
.B ETXTBSY
Le fichier est un programme actuellement en cours d'execution.
.TP
.B EIO
Une erreur d'entree/sortie s'est produite pendant la mise a jour.
.TP
.B EFAULT
.I Path
pointe en dehors de l'espace d'adressage accessible.
.PP
Pour
.BR Ftruncate :
.TP 0.8i
.B EBADF
.I fd
n'est pas un descripteur valide.
.TP
.B EINVAL
.I fd
est une socket, pas un fichier.
.TP
.B EINVAL
.I fd
n'est pas ouvert en ecriture.
.SH CONFORMITE
BSD 4.4, SVr4 (cette fonction est apparue dans BSD 4.2). SVr4 mentionne
des conditions d'erreurs supplementaires pour
.BR truncate
EINTR, EMFILE, EMULTIHOP, ENAMETOOLONG, ENFILE, ENOLINK, ENOTDIR. La
version SVr4 de
.BR ftruncate
dispose des conditions d'erreur supplementaires EAGAIN et EINTR.
.SH BUGS
Ces appels devraient etre generalises pour permettre la suppression
d'une zone quelconque d'un fichier.
.SH "VOIR AUSSI"
.BR open (2)
|
