|
|
1.1 ! root 1: .\" Copyright (c) 1983 The Regents of the University of California. ! 2: .\" All rights reserved. ! 3: .\" ! 4: .\" Redistribution and use in source and binary forms are permitted provided ! 5: .\" that: (1) source distributions retain this entire copyright notice and ! 6: .\" comment, and (2) distributions including binaries display the following ! 7: .\" acknowledgement: ``This product includes software developed by the ! 8: .\" University of California, Berkeley and its contributors'' in the ! 9: .\" documentation or other materials provided with the distribution and in ! 10: .\" all advertising materials mentioning features or use of this software. ! 11: .\" Neither the name of the University nor the names of its contributors may ! 12: .\" be used to endorse or promote products derived from this software without ! 13: .\" specific prior written permission. ! 14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED ! 15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF ! 16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. ! 17: .\" ! 18: .\" @(#)getsockname.2 6.3 (Berkeley) 6/23/90 ! 19: .\" ! 20: .TH GETSOCKNAME 2 "June 23, 1990" ! 21: .UC 5 ! 22: .SH NAME ! 23: getsockname \- get socket name ! 24: .SH SYNOPSIS ! 25: .nf ! 26: .PP ! 27: .ft B ! 28: getsockname(s, name, namelen) ! 29: int s; ! 30: struct sockaddr *name; ! 31: int *namelen; ! 32: .fi ! 33: .SH DESCRIPTION ! 34: .I Getsockname ! 35: returns the current ! 36: .I name ! 37: for the specified socket. The ! 38: .I namelen ! 39: parameter should be initialized to indicate ! 40: the amount of space pointed to by ! 41: .IR name . ! 42: On return it contains the actual size of the name ! 43: returned (in bytes). ! 44: .SH DIAGNOSTICS ! 45: A 0 is returned if the call succeeds, \-1 if it fails. ! 46: .SH ERRORS ! 47: The call succeeds unless: ! 48: .TP 15 ! 49: [EBADF] ! 50: The argument \fIs\fP is not a valid descriptor. ! 51: .TP 15 ! 52: [ENOTSOCK] ! 53: The argument \fIs\fP is a file, not a socket. ! 54: .TP 15 ! 55: [ENOBUFS] ! 56: Insufficient resources were available in the system ! 57: to perform the operation. ! 58: .TP 15 ! 59: [EFAULT] ! 60: The ! 61: .I name ! 62: parameter points to memory not in a valid part of the ! 63: process address space. ! 64: .SH "SEE ALSO" ! 65: bind(2), socket(2) ! 66: .SH BUGS ! 67: Names bound to sockets in the UNIX domain are inaccessible; ! 68: .I getsockname ! 69: returns a zero length name.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.