.\" $Id: getuduser.3,v 1.1 2000/08/07 23:15:03 emmerson Exp $
.TH GETUDENT 3 "$Date: 2000/08/07 23:15:03 $" "Printed: \n(yr.\n(mo.\n(dy" "UNIDATA LIBRARY FUNCTIONS"
.SH NAME
getuduser \- return user database entry of Unidata user
.SH SYNOPSIS
.nf
.ft B
.sp
#include <unistd.h>
.sp
const struct passwd *getudent(void);
.ft
.fi
.SH DESCRIPTION
.LP
This function returns the user database entry for the Unidata user \-\- 
or NULL if no such user exists.
It tries the \s-1UNIX\s+1 function `\fBgetpwnam()\fP' with a series
of user names and stops at the first valid entry.
The first name tried is the value of the environment variable \fBUDLOGNAME\fP,
if it exists.
The remaining names are, in order, "unidata", "ldm4", and "ldm".
.SH ENVIRONMENT
.nr in \w'UDLOGNAME   '
.IP UDLOGNAME \n(inu
Contains the name of the Unidata user.