getsockname.2

来自「<B>Digital的Unix操作系统VAX 4.2源码</B>」· 2 代码 · 共 59 行

.\" SCCSID: @(#)getsockname.2	8.1	9/11/90
.TH getsockname 2
.SH Name
getsockname \- get socket name
.SH Syntax
.nf
.ft B
#include <sys/types.h>
#include <sys/socket.h>
.PP
.ft B
getsockname(s, name, namelen)
int s;
struct sockaddr *name;
int *namelen;
.fi
.SH Description
.NXR "getsockname system call"
.NXR "socket" "getting name"
The
.PN getsockname
system call returns the current 
.I name
for the specified socket descriptor 
.B 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, \-1 if it fails.
.SH Restrictions
Names bound to sockets in the UNIX domain are inaccessible;
.PN getsockname
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
[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), socket(2)