Index for Section 3

Alphabetical listing for R

Bottom of page

ruserok(3)
NAME
  ruserok - Allow servers to authenticate clients

SYNOPSIS
  #include <unistd.h>

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

LIBRARY
  Standard C Library (libc)

PARAMETERS
  host
      Specifies the name of a remote host.

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

  remote_user
      Points to a username that is valid at the remote host. Any valid
      username can be specified.

  local_user
      Points to a username that is valid at the local host.  Any valid
      username can be specified.

DESCRIPTION
  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
  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
  /etc/services
      Contains service names.

  /etc/host.equiv
      Specifies foreign hostnames.

  $HOME/.rhosts
      Specifies the remote users of a local user account.

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

  Commands: rlogind(8), rshd(8)

Index for Section 3

Alphabetical listing for R

Top of page