.TH "getseuserbyname" "3" "29 September 2005" "dwalsh@redhat.com" "SE Linux 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.

.br

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.