NAME    [Toc]    [Back]

       ruserok - Allow servers to authenticate clients

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       int ruserok(
               char *host,
               int root_user,
               char *remote_user,
               char *local_user );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       Specifies the name of a remote host.  Specifies a value to
       indicate whether the effective user ID of the calling process
  is  that  of a root user.  A value of 0 (zero) indicates
 the process does not have a root user ID.   A  value
       of 1 indicates that the process has local root user privileges,
  and  the  /etc/host.equiv  file  is  not  checked.
       Points  to  a  username  that is valid at the remote host.
       Any valid username can be specified.  Points to a username
       that  is  valid at the local host.  Any valid username can
       be specified.

DESCRIPTION    [Toc]    [Back]

       The ruserok() (remote command  user  OK)  function  allows
       servers to authenticate clients requesting services.

       The  hostname  must be specified.  If the local domain and
       remote domain are the same, specifying the domain parts is
       optional.   To  determine  the domain of the host, use the
       gethostname() function. The ruserok() function checks  for
       this  host  in  the /etc/host.equiv file.  Then, if necessary,
 the subroutine checks a  file  in  the  user's  home
       directory  at  the  server called $HOME/.rhosts for a host
       and remote user ID.

RETURN VALUES    [Toc]    [Back]

       The ruserok() function returns 0 (zero) if the  subroutine
       successfully locates the name specified by the host parameter
 in the /etc/hosts.equiv file or if the IDs  specified
       by  the  host  and remote_user parameters are found in the
       $HOME/.rhosts file.

       If the name specified by the host parameter was not found,
       the ruserok() function returns a value of -1.

FILES    [Toc]    [Back]

       Contains  service  names.   Specifies  foreign  hostnames.
       Specifies the remote users of a local user account.

SEE ALSO    [Toc]    [Back]

       Functions: gethostname(2), rcmd(3), rresvport(3), sethostname(2)

       Commands: rlogind(8), rshd(8)



                                                       ruserok(3)