ruserok(3)ruserok(3)NAMEruserok - 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
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
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
Contains service names. Specifies foreign hostnames. 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)ruserok(3)