58 lines
1.4 KiB
Groff
58 lines
1.4 KiB
Groff
'\"macro stdmacro
|
|
.\" Copyright (c) 1983 Regents of the University of California.
|
|
.\" All rights reserved. The Berkeley software License Agreement
|
|
.\" specifies the terms and conditions for redistribution.
|
|
.\"
|
|
.\" @(#)getsockname.2 6.1 (Berkeley) 5/15/85
|
|
.\"
|
|
.TH GETSOCKNAME 2
|
|
.UC 5
|
|
.SH NAME
|
|
getsockname \- get socket name
|
|
.SH SYNOPSIS
|
|
.B #include <sys/types.h>
|
|
.br
|
|
.B #include <sys/socket.h>
|
|
.sp
|
|
.B "int getsockname (int s, struct sockaddr \(**name, int \(**namelen);"
|
|
.SH DESCRIPTION
|
|
.I Getsockname
|
|
returns the current
|
|
.I name
|
|
for the specified socket. 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 of the name
|
|
returned (in bytes).
|
|
.SH DIAGNOSTICS
|
|
A 0 is returned if the call succeeds, \-1 if it fails.
|
|
.SH ERRORS
|
|
The call succeeds unless:
|
|
.TP 15
|
|
[EBADF]
|
|
The argument \f2s\fP is not a valid descriptor.
|
|
.TP 15
|
|
[ENOTSOCK]
|
|
The argument \f2s\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)
|
|
.SH NOTES
|
|
ABI-compliant versions of the above call can be obtained from
|
|
.IR libsocket.so .
|
|
.PP
|
|
This call does not return useful results when used on sockets of type
|
|
AF_UNIX, unless the socket was explicitly bound to a pathname.
|
|
'\".so /pubs/tools/origin.bsd
|