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
|
.TH "context_new" "3" "20 December 2011" "dwalsh@redhat.com" "SELinux API documentation"
.SH "NAME"
context_new, context_str, context_free, context_type_get, context_type_set, context_range_get, context_range_set,context_role_get, context_role_set, context_user_get, context_user_set \- Routines to manipulate SELinux security contexts
.
.SH "SYNOPSIS"
.B #include <selinux/context.h>
.sp
.BI "context_t context_new(const char *" context_str );
.sp
.BI "const char * context_str(context_t " con );
.sp
.BI "void context_free(context_t " con );
.sp
.BI "const char * context_type_get(context_t " con );
.sp
.BI "const char * context_range_get(context_t " con );
.sp
.BI "const char * context_role_get(context_t " con );
.sp
.BI "const char * context_user_get(context_t " con );
.sp
.BI "int context_type_set(context_t " con ", const char *" type );
.sp
.BI "int context_range_set(context_t " con ", const char *" range );
.sp
.BI "int context_role_set(context_t " con ", const char *" role );
.sp
.BI "int context_user_set(context_t " con ", const char *" user );
.
.SH "DESCRIPTION"
These functions allow an application to manipulate the fields of a
security context string without requiring it to know the format of the
string.
.BR context_new ()
returns a new context initialized to a context string.
.BR context_str ()
returns a pointer to the string value of the
.BR context_t ,
valid until the next call to
.BR context_str ()
or
.BR context_free ()
for the same
.BR context_t* .
.BR context_free ()
frees the storage used by a context.
.BR context_type_get (),
.BR context_range_get (),
.BR context_role_get (),
.BR \%context_user_get ()
get a pointer to the string value of a context component.
.B Note:
Values returned by the get functions are only valid until the next call
to a set function or
.BR context_free ()
for the same
.B context_t
structure.
.BR context_type_set (),
.BR context_range_set (),
.BR context_role_set (),
.BR \%context_user_set ()
set a context component.
.
.SH "RETURN VALUE"
On success, zero is returned. On failure, \-1 is returned and
.I errno
is set appropriately.
.
.SH "SEE ALSO"
.BR selinux "(8)"
|
