Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

getpeerucred(3c) [opensolaris man page]

getpeerucred(3C)					   Standard C Library Functions 					  getpeerucred(3C)

NAME
getpeerucred - get connected socket or STREAM peer's credentials SYNOPSIS
#include <ucred.h> int getpeerucred(int fd, ucred_t **ucred); DESCRIPTION
The getpeerucred() function returns the credentials of the peer endpoint of a connection-oriented socket (SOCK_STREAM) or STREAM fd at the time the endpoint was created or the connection was established. A process that initiates a connection retrieves the credentials of its peer at the time the peer's endpoint was created. A process that listens for connections retrieves the credentials of the peer at the time the peer initiated the connection. When successful, getpeerucred() stores the pointer to a freshly allocated ucred_t in the memory location pointed to by the ucred argument if that memory location contains the null pointer. If the memory location is non-null, it will reuse the existing ucred_t. When ucred is no longer needed, a credential allocated by getpeerucred() should be freed with ucred_free(3C). It is possible that all fields of the ucred_t are not available to all peer endpoints and all callers. RETURN VALUES
Upon successful completion, getpeerucred() returns 0. Otherwise, it returns -1 and errno is set to indicate the error. ERRORS
The getpeerucred() function will fail if: EAGAIN There is not enough memory available to allocate sufficient memory to hold the user credential. The application can try again later. EBADF The fd argument is not a valid file descriptor. EFAULT The pointer location pointed to by the ucred_t ** argument points to an invalid, non-null address. EINVAL The socket is connected but the peer credentials are unknown. ENOMEM The physical limits of the system are exceeded by the memory allocation needed to hold the user credential. ENOTCONN The socket or STREAM is not connected or the STREAM's peer is unknown. ENOTSUP This operation is not supported on this file descriptor. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
door_ucred(3C), ucred_get(3C), attributes(5), connld(7M) NOTES
The system currently supports both sides of connection endpoints for local AF_UNIX, AF_INET, and AF_INET6 sockets, /dev/tcp, /dev/ticots, and /dev/ticotsord XTI/TLI connections, and pipe file descriptors sent using I_SENDFD as a result of the open of a named pipe with the "connld" module pushed. SunOS 5.11 26 May 2004 getpeerucred(3C)

Check Out this Related Man Page

Ucred(3PERL)						      Perl Library Functions						      Ucred(3PERL)

NAME
Ucred - Perl interface to User Credentials SYNOPSIS
use Sun::Solaris::Ucred qw(:ALL); DESCRIPTION
This module provides wrappers for the Ucred-related system and library calls. Constants None. Functions ucred_get($pid) This function returns the credential of the process specified by $pid if the process exists and the calling process is permitted to obtain the credentials of that process. getpeerucred($fd) If $fd is a connected connection-oriented TLI endpoint, a connected SOCK_STREAM, or a SOCK_SEQPKT socket, getpeerucred() returns the user credential of the peer at the time the connection was established, if availble. ucred_geteuid($ucred) This function returns the effective uid of a user credential, if available. ucred_getruid($ucred) This function returns the real uid of a user credential, if available. ucred_getsuid($ucred) This function returns the saved uid of a user credential, if available. ucred_getegid($ucred) This function returns the effective group of a user credential, if available. ucred_getrgid($ucred) This function returns the real group of a user credential, if available. ucred_getsgid($ucred) This function returns the saved group of a user credential, if available. ucred_getgroups($ucred) This function returns the list of supplemental groups of a user credential, if available.An array of groups is returned in ARRAY con- text; the number of groups is returned in SCALAR context. ucred_getprivset($ucred, $which) This function returns the privilege set specified by $which of a user credential, if available. ucred_getpflags($ucred, $flags) This function returns the value of a specific process flag of a user credential, if available. ucred_getpid($ucred) This function returns the process ID of a user credential, if available. ucred_getprojid($ucred) This function returns the project ID of a user credential, if available. ucred_getzoneid($ucred) This function returns the zone ID of a user credential, if available. Class methods None. Object methods None. Exports By default nothing is exported from this module. The following tags can be used to selectively import constants and functions defined in this module: :SYSCALLS ucred_get(), getpeerucred() :LIBCALLS ucred_geteuid(), ucred_getruid(), ucred_getsuid(), ucred_getegid(), ucred_getrgid(), ucred_getsgid(), ucred_getgroups(), ucred_getprivset(), ucred_getpflags(), ucred_getpid(), ucred_getzone() :ALL :SYSCALLS(), :LIBCALLS() ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWpl5u | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ SEE ALSO
getpeerucred(3C), ucred_get(3C), attributes(5) SunOS 5.11 30 Jan 2004 Ucred(3PERL)
Man Page