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
137
138
139
140
141
142
143
144
|
.\" 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
.\" Mise a Jour 18/05/99 - LDP-man-pages-1.23
.TH TRUNCATE 2 "18 Mai 1999" Linux "Manuel du programmeur Linux"
.SH NOM
truncate, ftruncate \- Tronquer un fichier une longueur donne.
.SH SYNOPSIS
.B #include <unistd.h>
.sp
.BI "int truncate(const char *" path ", off_t " length );
.br
.BI "int ftruncate(int " fd ", off_t " length );
.SH DESCRIPTION
.B Truncate
tronque le fichier rfrenc par
.I path
ou par le descripteur
.I fd
une longueur maximale de
.I length
octets.
Si le fichier tait plus long, les donnes supplmentaires sont perdues.
Avec
.BR ftruncate ,
le fichier doit tre ouvert en criture.
.SH "VALEUR RENVOYE"
.BR truncate ,
et
.BR ftruncate
renvoient 0 s'ils russissent et \-1 s'ils chouent, auquel cas
.I errno
contient le code d'erreur.
.SH ERREURS
Pour
.BR truncate :
.TP 0.8i
.B ENOTDIR
un composant du chemin d'accs n'est pas un rpertoire
.TP
.B EINVAL
Un mauvais caractre dans le chemin d'accs.
.TP
.B ENAMETOOLONG
Un composant du chemin dpasse 255 caractres ou
le chemin complet dpasse 1023 caractres.
.TP
.B ENOENT
Le fichier n'existe pas
.TP
.B EACCES
Un composant du chemin d'accs ne permet pas le parcours
.TP
.B EACCES
Le fichier n'est pas accessible en criture.
.TP
.B ELOOP
Le chemin contient une rfrence circulaire ( travers un lien symbolique)
.TP
.B EISDIR
Le fichier est en ralite un rpertoire
.TP
.B EROFS
Le fichier se trouve sur un systme de fichiers en lecture seule.
.TP
.B ETXTBSY
Le fichier est un programme actuellement en cours d'excution.
.TP
.B EIO
Une erreur d'entre/sortie s'est produite pendant la mise 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 criture.
.SH CONFORMIT
BSD 4.4, SVr4 (cette fonction est apparue dans BSD 4.2).
SVr4 mentionne des conditions d'erreurs supplmentaires pour
.BR truncate
EINTR, EMFILE, EMULTIHOP, ENAMETOOLONG, ENFILE, ENOLINK, ENOTDIR. La
version SVr4 de
.BR ftruncate
dispose des conditions d'erreur supplmentaires EAGAIN et EINTR.
POSIX dispose de
.I ftruncate
mais pas de
.IR truncate .
.SH BUGS
Ces appels devraient tre gnraliss pour permettre la suppression
d'une zone quelconque d'un fichier.
.SH "VOIR AUSSI"
.BR open (2)
.SH TRADUCTION
Christophe Blaess, 1997.
|
