Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
explain_getpeername_or_die(Library Functions Manuexplain_getpeername_or_die(3)

NAME
       explain_getpeername_or_die - get	name of	peer socket and	report errors

SYNOPSIS
       #include	<libexplain/getpeername.h>
       void explain_getpeername_or_die(int fildes, struct sockaddr *sock_addr,
       socklen_t *sock_addr_size);

DESCRIPTION
       The explain_getpeername_or_die function is used to  call	 the  getpeer-
       name(2)	system	call.	On  failure  an	explanation will be printed to
       stderr, obtained	from explain_getpeername(3), and then the process ter-
       minates by calling exit(EXIT_FAILURE).

       This  function  is intended to be used in a fashion similar to the fol-
       lowing example:
	      struct sockadd sock_addr;
	      socklen_t	sock_addr_size = sizeof(sock_addr);
	      explain_getpeername_or_die(fildes, &sock_addr, &sock_addr_size);

       fildes  The fildes, exactly as to be passed to the getpeername(2)  sys-
	       tem call.

       sock_addr
	       The  sock_addr,	exactly	 as to be passed to the	getpeername(2)
	       system call.

       sock_addr_size
	       The sock_addr_size, exactly as to be  passed  to	 the  getpeer-
	       name(2) system call.

       Returns:
	       This  function  only returns on success,	see getpeername(2) for
	       more information.  On failure, prints an	explanation and	exits.

SEE ALSO
       getpeername(2)
	       get name	of connected peer socket

       explain_getpeername(3)
	       explain getpeername(2) errors

       exit(2) terminate the calling process

COPYRIGHT
       libexplain version 1.3
       Copyright (C) 2009 Peter	Miller

						 explain_getpeername_or_die(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=explain_getpeername_or_die&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help