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
|
.\"
.\" $Id: capget.2,v 1.4 1999/09/09 16:43:26 morgan Exp $
.\" written by Andrew Morgan <morgan@linux.kernel.org>
.\" may be distributed as per GPL
.\" Modified by David A. Wheeler <dwheeler@ida.org>
.\"
.\" Traduction 04/01/2000 par Christophe Blaess (ccb@club-internet.fr)
.\" LDP-man-pages 1.28
.\" mj 26/06/2000 LDP 1.30
.TH CAPGET 2 "4 Janvier 2000" Linux "Manuel du programmeur Linux"
.SH NOM
capget, capset \- Configurer les capacits d'un processus.
.SH SYNOPSIS
.B #undef _POSIX_SOURCE
.br
.B #include <sys/capability.h>
.sp
.BI "int capget(cap_user_header_t " entete ", cap_user_data_t " donnees );
.sp
.BI "int capset(cap_user_header_t " entete ", const cap_user_data_t " donnees );
.SH DESCRIPTION
Depuis Linux 2.2, la toute puissance du Super-Utilisateur (root) a t scinde en
plusieurs ensembles distincts.
Chaque processus dispose d'un ensemble de capacits effectives permettant d'identitifier
ses droits raliser certaines actions.
Chaque processus a aussi un ensemble de capacits hritables, qu'il peut transmettre
au travers d'un execve(2) et un ensemble de capacits ventuelles qu'il peut rendre
effectives ou hritables.
.PP
Ces deux fonctions constituent l'interface brute du noyau pour configurer ou lire les
capcits d'un processus. Non seulement ces appels-systme sont spcifique Linux,
mais l'API du noyau est susceptible de changer dans l'avenir. L'utilisation de
ces fonctions (en particulier le format du type
.BR cap_user_*_t )
risque de varier lors de nouvelles mises jour du noyau.
.sp
L'interface portable est constitue des fonctions
.IR cap_set_proc (3)
et
.IR cap_get_proc (3);
si possible utilisez plutt ces routines dans vos applications.
Si vous dsirez vraiment utiliser les extension Linux, essayez d'employer
plutt les interfaces
.IR capsetp (3)
et
.IR capgetp (3)
qui sont plus faciles utiliser.
.SH "VALEUR RENVOYE"
Si elles russissent, ces routines renvoient 0. Sinon elles renvoient
-1 et configurent
.I errno
avec le code d'erreur appropri
.SH ERREURS
.TP
.SB EINVAL
Un argument est invalide
.TP
.SB EPERM
On a essay d'ajouter une capacit dans l'ensemble ventuel, ou de placer
une capacit dans l'ensemble effectif ou hritable qui ne se trouvait pas
dans l'ensemble ventuel.
.SH VOIR AUSSI
L'interface portable pour les fonctions de configuration et de lecture des
permissions est fournie par la bibliothque
.B libcap
disponible :
.br
.B ftp://linux.kernel.org/pub/linux/libs/security/linux-privs
.SH TRADUCTION
Christophe Blaess, 2000.
|
