File: capget.2

package info (click to toggle)
manpages-pt 20040726-8
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 2,988 kB
  • sloc: sh: 45; makefile: 16
file content (66 lines) | stat: -rw-r--r-- 2,448 bytes parent folder | download | duplicates (6)
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
.\" -*- nroff -*-
.\" $Id: capget.2,v 1.2 2000/11/09 15:55:06 ricardo Exp $
.\" written by Andrew Morgan <morgan@linux.kernel.org>
.\" may be distributed as per GPL
.\" Modified by David A. Wheeler <dwheeler@ida.org>
.\"
.TH CAPGET 2 "9/09/1999" "Linux 2.2" "Manual do Programador Linux"
.SH NOME
capget, capset \- seleciona/obtm as habilidades do processo
.SH SINOPSE
.B #undef _POSIX_SOURCE
.br
.B #include <sys/capability.h>
.sp
.BI "int capget(cap_user_header_t " header ", cap_user_data_t " data );
.sp
.BI "int capset(cap_user_header_t " header ", const cap_user_data_t " data );
.SH DESCRIO
Como pertence ao Linux 2.2, o poder do superusurio foi dividido
em um conjunto distinto de habilidades.
Cada um dos processos tem um conjunto efetivo de habilidades identificando
quais habilidades (se alguma) podem ser usadas atualmente.
Cada um dos processos tambm tem um conjunto hereditrio de habilidades que pode
ser passado atrves de um execve(2) e um conjunto de habilidades permitidas
que ele pode fazer efetivas ou hereditrias.
.PP
Estas duas funes so a interface pura do kernel para obteno e
selecionamento de habilidades. No somente so especficas para o Linux,
mas a API do kernel  apta para mudar e
usar estas funes (em particular o formanto de tipos
.B cap_user_*_t
)  sujeita a mudanas em cada uma das revises do kernel.
.sp
As interfaces portveis so
.IR cap_set_proc (3)
e
.IR cap_get_proc (3);
se possvel voc pode usar estas interfaces em aplicaes.
Se voc desejar usar as extenses Linux em aplicaes, voc precisaria
usar as interfaces fceis de uso
.IR capsetp (3)
e
.IR capgetp (3).
.SH "VALORES DE RETORNO"
Em caso de sucesso, zero  retornado. Em caso de erro, -1  retornado, e
.I errno
 selecionado apropriadamente.
.SH ERROS
.TP
.SB EINVAL
Um dos argumentos  invlido.
.TP
.SB EPERM
Existiu uma tentativa de fazer adicionar uma habilidae para conjuntos permitidos, ou para selecionar
uma habilidade em conjuntos efetivos ou hereditrios que no no
conjunto permitido.
.SH "INFORMAES ADICIONAIS"
A interface portvel para interrogao e selecionamento de
funes  disponibilizada pela biblioteca
.B libcap
que esta disponibilizada a partir de:
.br
.B ftp://linux.kernel.org/pub/linux/libs/security/linux-privs
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWAndr L. Fassone Canova <lonelywolf@blv.com.br> (traduo)\fR
\&\fR\&\f(CWFbio Henrique F. Silva <fabiohfs@mail.com> (reviso)\fR