File: brk.2

package info (click to toggle)
manpages-fr 1.58.1-3
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 10,104 kB
  • ctags: 4
  • sloc: makefile: 106; sh: 8
file content (90 lines) | stat: -rw-r--r-- 3,126 bytes parent folder | download
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
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (c) 1993 Michael Haardt
.\" (u31b3hs@pool.informatik.rwth-aachen.de),
.\" Fri Apr  2 11:32:09 MET DST 1993
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
.\" USA.
.\"
.\" Modified Wed Jul 21 19:52:58 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Sun Aug 21 17:40:38 1994 by Rik Faith (faith@cs.unc.edu)
.\"
.\" Traduction 9/10/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" Mise a jour 19/07/1997
.\" Mise a jour 30/05/2001 LDP-man-pages-1.36
.\" Mise a jour 30/07/2003 LDP-man-pages-1.58
.TH BRK 2 "30 juillet 2003" LDP "Manuel du programmeur Linux"
.SH NOM
brk, sbrk \- Modifier la taille du segment de donnes.
.SH SYNOPSIS
.B #include <unistd.h>
.sp
.BI "int brk(void *" fin_segment_donne );
.br
.BI "void *sbrk(ptrdiff_t " incrment );
.SH DESCRIPTION
.B brk
positionne la fin du segment de donnes (le premier mot mmoire hors
de la zone accessible)  l'adresse spcifie par
.IR fin_segment_donne.
Cette valeur doit tre raisonnable, le systme doit avoir suffisamment
de mmoire, et le processus ne doit pas dpasser sa taille maximale de
segment de donnes (voir
.BR setrlimit (2)).

.B sbrk
incrmente l'espace de donnes du programme de
.I incrment
octets. 
.B sbrk
n'est pas un appel systme, juste une fonction de la bibliothque C.
Appeler
.B sbrk
avec un incrment nul permet d'obtenir l'emplacement de la limite
actuelle.
.SH "VALEUR RENVOYE"
.B brk
renvoie 0 s'il russit.
.B sbrk
retourne un pointeur sur le dbut de la nouvelle zone de donnes. 
En cas d'chec \-1 est renvoy, et
.I errno
contient le code d'erreur
.BR ENOMEM .
.SH "CONFORMIT"   
BSD 4.3

.BR brk " et " sbrk
ne sont pas dfinis dans le C Standard, et sont volontairement exclus
des standards POSIX.1 (paragraphes B.1.1.1.3 et B.8.3.3).
.\" .SH NOTES
.\" Various systems use various types for the parameter of
.\" .BR sbrk ().
.\" One sees int (e.g. XPGv4, HP-UX 11), ssize_t (e.g. Irix 5.3),
.\" ptrdiff_t (libc4, libc5, ulibc, glibc2.0, 2.1),
.\" intptr_t (e.g. XPGv5, AIX, SunOS 5.9, FreeBSD 4.7, Tru64 5.1, glibc2.2).
.\" XPGv6 obsoletes this function.
.SH "VOIR AUSSI"
.BR execve (2),
.BR getrlimit (2),
.BR malloc (3).
.SH TRADUCTION
Christophe Blaess, 1996-2003.