getpwent(efun)		External Function		getpwent(efun)

NAME
    getpwent - get password entry

SYNOPSIS
    string getpwent(string user);

AVAILABILITY
    privileged efun

DESCRIPTION
    getpwent will return the encrypted password stored in the user
    password database. it can then be used for checking whether a
    user entered a valid password at login.

    this function may only be called from authorized programs.
    (authorized programs = all programs that live in /secure)
    non-authorized calls will cause a privilege violation exception.

BUGS
    none

RETURN VALUES

    0, if the queried user does not exist
    the encrypted password of an existing user

SEE ALSO
    addpwent, setpwent, delpwent

Holy Mission MUD	Last change: 14 Apr 1994

