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

FreeBSD Manual Pages

  
 
  

home | help
HCLOSE(3)		   libdill Library Functions		     HCLOSE(3)

NAME
       hclose -	hard-closes a handle

SYNOPSIS
	      #include <libdill.h>

	      int hclose(
		  int h);

DESCRIPTION
       This  function  closes a	handle.	 Once all handles pointing to the same
       underlying object have been closed, the object is  deallocated  immedi-
       ately, without blocking.

       The  function guarantees	that all associated resources are deallocated.
       However,	it does	not guarantee that the handle's	work  will  have  been
       fully finished.	E.g., outbound network data may	not be flushed.

       In  the	case  of network protocol sockets the entire protocol stack is
       closed, the topmost protocol as well as all the protocols beneath it.

       h: The handle.

RETURN VALUE
       In case of success the function returns 0.  In case of error it returns
       -1 and sets errno to one	of the values below.

ERRORS
       o EBADF:	Invalid	handle.

       o ENOTSUP: The handle does not support this operation.

EXAMPLE
	      int ch[2];
	      chmake(ch);
	      hclose(ch[0]);
	      hclose(ch[1]);

SEE ALSO
       hmake(3)	hown(3)	hquery(3)

libdill								     HCLOSE(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | SEE ALSO

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

home | help