selinux/libselinux/man/man3/getseuserbyname.3
2008-08-19 15:30:36 -04:00

29 lines
932 B
Groff

.TH "getseuserbyname" "3" "29 September 2005" "dwalsh@redhat.com" "SELinux API documentation"
.SH "NAME"
getseuserbyname \- get SELinux username and level for a given Linux username
.SH "SYNOPSIS"
.B #include <selinux/selinux.h>
.sp
.BI "int getseuserbyname(const char *" linuxuser ", char **" selinuxuser ", char **" level ");
.SH "DESCRIPTION"
.B getseuserbyname
retrieves the SELinux username and security level associated with
a given Linux username. The SELinux username and security level can
then be passed to other libselinux functions such as
get_ordered_context_list_with_level and get_default_context_with_level.
The returned SELinux username and level should be freed by the caller
using free.
.SH "RETURN VALUE"
On success, 0 is returned.
On failure, \-1 is returned and errno is set appropriately.
The errors documented for the stat(2) system call are also applicable
here.
.SH "SEE ALSO"
.BR selinux "(8)"