*** UNIX MANUAL PAGE BROWSER ***

ruserok(3) Library Functions Manual ruserok(3) NAME ruserok - Allows servers to authenticate clients LIBRARY Standard C Library (libc.a) SYNOPSIS int ruserok ( char *host, int root_user, char *re- mote_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 au- thenticate 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 re- mote_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 ruserok(3)