Content-type: text/html Man page of ruserok

ruserok

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

ruserok - Allows servers to authenticate clients  

LIBRARY

Standard C Library (libc.a)  

SYNOPSIS

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

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.  

RELATED INFORMATION

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

Commands: rlogind(8), rshd(8) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:16 GMT, October 02, 2010