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