|
|
1.1 root 1: .TH GETPEERNAME 2 "21 July 1983"
2: .UC 4
3: .SH NAME
4: getpeername \- get name of connected peer
5: .SH SYNOPSIS
6: .nf
7: .PP
8: .ft B
9: getpeername(s, name, namelen)
10: int s;
11: struct sockaddr *name;
12: int *namelen;
13: .fi
14: .SH DESCRIPTION
15: .I Getpeername
16: returns the name of the peer connected to
17: socket
18: .IR s .
19: The
20: .I namelen
21: parameter should be initialized to indicate
22: the amount of space pointed to by
23: .IR name .
24: On return it contains the actual size of the name
25: returned (in bytes).
26: .SH DIAGNOSTICS
27: A 0 is returned if the call succeeds, \-1 if it fails.
28: .SH ERRORS
29: The call succeeds unless:
30: .TP 15
31: [EBADF]
32: The argument \fIs\fP is not a valid descriptor.
33: .TP 15
34: [ENOTSOCK]
35: The argument \fIs\fP is a file, not a socket.
36: .TP 15
37: [ENOTCONN]
38: The socket is not connected.
39: .TP 15
40: [ENOBUFS]
41: Insufficient resources were available in the system
42: to perform the operation.
43: .TP 15
44: [EFAULT]
45: The
46: .I name
47: parameter points to memory not in a valid part of the
48: process address space.
49: .SH "SEE ALSO"
50: bind(2), socket(2), getsockname(2)
51: .SH BUGS
52: Names bound to sockets in the UNIX domain are inaccessible;
53: .I getpeername
54: returns a zero length name.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.