summaryrefslogtreecommitdiffstats
path: root/man2/getsockname.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/getsockname.2')
-rw-r--r--man2/getsockname.297
1 files changed, 97 insertions, 0 deletions
diff --git a/man2/getsockname.2 b/man2/getsockname.2
new file mode 100644
index 000000000..969c646e6
--- /dev/null
+++ b/man2/getsockname.2
@@ -0,0 +1,97 @@
+.\" Copyright (c) 1983, 1991 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\" must display the following acknowledgement:
+.\" This product includes software developed by the University of
+.\" California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\" may be used to endorse or promote products derived from this software
+.\" without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\" @(#)getsockname.2 6.4 (Berkeley) 3/10/91
+.\"
+.\" Modified Sat Jul 24 16:30:29 1993 by Rik Faith <faith@cs.unc.edu>
+.\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
+.\" Modified Sun Mar 28 21:26:46 1999 by Andries Brouwer <aeb@cwi.nl>
+.\"
+.TH GETSOCKNAME 2 1993-07-24 "BSD Man Page" "Linux Programmer's Manual"
+.SH NAME
+getsockname \- get socket name
+.SH SYNOPSIS
+.nf
+.B #include <sys/socket.h>
+.sp
+.BI "int getsockname(int " s ", struct sockaddr *" name ", socklen_t *" namelen );
+.fi
+.SH DESCRIPTION
+.B 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 "RETURN VALUE"
+On success, zero is returned. On error, \-1 is returned, and
+.I errno
+is set appropriately.
+.SH ERRORS
+.TP
+.B EBADF
+The argument
+.I s
+is not a valid descriptor.
+.TP
+.B EFAULT
+The
+.I name
+parameter points to memory not in a valid part of the
+process address space.
+.TP
+.B ENOBUFS
+Insufficient resources were available in the system
+to perform the operation.
+.TP
+.B ENOTSOCK
+The argument
+.I s
+is a file, not a socket.
+.SH "CONFORMING TO"
+SVr4, 4.4BSD (the
+.B getsockname
+function call appeared in 4.2BSD). SVr4 documents additional ENOMEM
+and ENOSR error codes.
+.SH NOTE
+The third argument of
+.B getsockname
+is in reality an `int *' (and this is what BSD 4.* and libc4 and libc5 have).
+Some POSIX confusion resulted in the present socklen_t, also used by glibc.
+See also
+.BR accept (2).
+.SH "SEE ALSO"
+.BR bind (2),
+.BR socket (2)