.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.