Annotation of 43BSDTahoe/man/man2/getpeername.2, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)getpeername.2       6.2 (Berkeley) 5/13/86
                      6: .\"
                      7: .TH GETPEERNAME 2 "May 13, 1986"
                      8: .UC 5
                      9: .SH NAME
                     10: getpeername \- get name of connected peer
                     11: .SH SYNOPSIS
                     12: .nf
                     13: .PP
                     14: .ft B
                     15: getpeername(s, name, namelen)
                     16: int s;
                     17: struct sockaddr *name;
                     18: int *namelen;
                     19: .fi
                     20: .SH DESCRIPTION
                     21: .I Getpeername
                     22: returns the name of the peer connected to
                     23: socket
                     24: .IR s .
                     25: The
                     26: .I namelen
                     27: parameter should be initialized to indicate
                     28: the amount of space pointed to by
                     29: .IR name .
                     30: On return it contains the actual size of the name
                     31: returned (in bytes).
                     32: The name is truncated if the buffer provided is too small.
                     33: .SH DIAGNOSTICS
                     34: A 0 is returned if the call succeeds, \-1 if it fails.
                     35: .SH ERRORS
                     36: The call succeeds unless:
                     37: .TP 15
                     38: [EBADF]
                     39: The argument \fIs\fP is not a valid descriptor.
                     40: .TP 15
                     41: [ENOTSOCK]
                     42: The argument \fIs\fP is a file, not a socket.
                     43: .TP 15
                     44: [ENOTCONN]
                     45: The socket is not connected.
                     46: .TP 15
                     47: [ENOBUFS]
                     48: Insufficient resources were available in the system
                     49: to perform the operation.
                     50: .TP 15
                     51: [EFAULT]
                     52: The 
                     53: .I name
                     54: parameter points to memory not in a valid part of the
                     55: process address space.
                     56: .SH "SEE ALSO"
                     57: accept(2), bind(2), socket(2), getsockname(2)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.