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

  
 
  

home | help
explain_ge...ame_or_die(3)  Library Functions Manual  explain_ge...ame_or_die(3)

NAME
     explain_getsockname_or_die - get socket name and report errors

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

DESCRIPTION
     The explain_getsockname_or_die function is used to call the  getsockname(2)
     system call.  On failure an explanation will be printed to stderr, obtained
     from  explain_getsockname(3),  and  then  the process terminates by calling
     exit(EXIT_FAILURE).

     This function is intended to be used in a fashion similar to the  following
     example:
	    struct sockaddr sock_addr;
	    socklen_t sock_addr_size = sizeof(sock_addr);
	    explain_getsockname_or_die(fildes, &sock_addr, &sock_addr_size);

     fildes  The  fildes,  exactly  as to be passed to the getsockname(2) system
	     call.

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

     sock_addr_size
	     The sock_addr_size, exactly as to be passed to  the  getsockname(2)
	     system call.

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

SEE ALSO
     getsockname(2)
	     get socket name

     explain_getsockname(3)
	     explain getsockname(2) errors

     exit(2)
	     terminate the calling process

COPYRIGHT
     libexplain version 1.3
     Copyright (C) 2009 Peter Miller

						      explain_ge...ame_or_die(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=explain_getsockname_or_die&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help