File: iopl.2

package info (click to toggle)
manpages-fr 0.8-1
  • links: PTS
  • area: main
  • in suites: potato
  • size: 5,760 kB
  • ctags: 4
  • sloc: makefile: 57; sh: 8
file content (99 lines) | stat: -rw-r--r-- 3,547 bytes parent folder | download | duplicates (2)
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
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
.\" Portions extracted from linux/kernel/ioport.c (no copyright notice).
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified Tue Aug  1 16:47    1995 by Jochen Karrer 
.\"                              (cip307@cip.physik.uni-wuerzburg.de)
.\" 
.\" Traduction  10/10/1996 Christophe BLAESS (ccb@club-internet.fr)
.\" Mise a jour 8/04/97
.\" maj 09/04/99 LDP-man-pages 1.22
.\" Mise a jour 18/05/99 - LDP-man-pages-1.23
.TH IOPL 2 "18 Mai 1999" "Linux" "Manuel du programmeur Linux"
.SH NOM
iopl \- Changer le niveau de privilge d'entre/sortie.
.SH SYNOPSIS
.B #include <unistd.h>
/* pour libc5 */
.br
.B #include <sys/io.h>
/* pour glibc */
.sp
.BI "int iopl(int " level );
.SH DESCRIPTION
.B iopl
change le niveau de privilge pour les entres/sorties du processus
courant, en utilisant la valeur spcifie dans
.IR level .

Cette fontion est indispensable pour permettre aux serveurs X compatibles
8514 de fonctionner sous Linux. Comme ces serveurs X ont besoin de l'accs
aux 65536 ports d'entre/sortie, la fonction
.B ioperm
ne serait pas suffisante.

En plus de disposer d'un accs illimit aux ports d'entree/sortie, un processus
tournant  un niveau de privilge lev pourra galement inhiber les interruptions.
Ceci risque d'engendrer un plantage du systme, et est fortement dconseill.

Les permissions sont hrites aussi bien par fork que par exec.

Le niveau de privilge d'entre/sortie pour un utilisateur normal vaut 0.
.SH "VALEUR RENVOYE"
.BR iopl
renvoie 0 s'il russit, ou \-1 s'il choue, auquel cas
.I errno
contient le code d'erreur.
.SH ERREURS
.TP 0.8i
.B EINVAL
.I level
est plus grand que 3.
.TP
.B EPERM
L'utilisateur actuel n'est pas le Super\-User.

.SH "NOTES EXTRAITES DES SOURCES DU NOYAU"
.B iopl
doit tre utilis lorsque l'on veut accder aux ports au-dessus de
la limite 0x3FF. Pour obtenir une image bitmap des 65536 ports, il
faudrait disposer de 8Ko de bitmap par processus, ce qui est un peu
excessif.
.SH "CONFORMIT"
\fBiopl\fP est spcifique  Linux et ne doit pas tre utilis dans
des programmes conus pour tre portables.
.SH "NOTES"
Libc5 considre qu'il s'agit d'un appel-systme et fournit le prototype
dans
.IR <unistd.h> .
Glibc1 n'offre pas de prototype. Glibc2 fournit un prototype  la fois dans
.I <sys/io.h>
et dans
.IR <sys/perm.h> .
Evitez ce dernier, il n'est disponible que sur les i386.
.SH "VOIR AUSSI"
.BR ioperm (2)

.SH TRADUCTION
Christophe Blaess, 1997.