getpeername.2

<B>Digital的Unix操作系统VAX 4.2源码</B>

.\" SCCSID: @(#)getpeername.2	8.1	9/11/90
.TH getpeername 2
.SH Name
getpeername \- get name of connected peer
.SH Syntax
.nf
.B #include <sys/types.h>
.B #include <sys/socket.h>
.PP
.ft B
getpeername(s, name, namelen)
int s;
struct sockaddr *name;
int *namelen;
.fi
.SH Description
.NXR "getpeername system call"
.NXR "socket" "getting peer name"
The
.PN getpeername
returns the name of the peer connected to
socket
.IR s .
The
.I namelen
parameter should be initialized to indicate
the amount of space pointed to by
.IR name .
On return, it contains the actual size, in bytes, of the name
returned.
.SH Return Values
A zero is returned if the call succeeds, and \-1 is returned if it fails.
.SH Restrictions
Names bound to sockets in the UNIX domain are inaccessible;
.PN getpeername
returns a zero length name.
.SH Diagnostics
The call succeeds unless:
.TP 15
[EBADF]
The argument \fIs\fP is not a valid descriptor.
.TP 15
[ENOTSOCK]
The argument \fIs\fP is a file, not a socket.
.TP 15
[ENOTCONN]
The socket is not connected.
.TP 15
[ENOBUFS]
Insufficient resources were available in the system
to perform the operation.
.TP 15
[EFAULT]
The 
.I name
parameter points to memory not in a valid part of the
process address space.
.SH See Also
bind(2), getsockname(2), socket(2)