'\" t
.\"     Title: nn_close
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2021-02-08
.\"    Manual: NNG Reference Manual
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "NN_CLOSE" "3compat" "2021-02-08" "\ \&" "NNG Reference Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
nn_close \- close socket (compatible API)
.SH "SYNOPSIS"
.sp
.if n .RS 4
.nf
.fam C
#include <nanomsg/nn.h>

int nn_close(int sock);
.fam
.fi
.if n .RE
.SH "DESCRIPTION"
.sp
The \f(CRnn_close()\fP function closes the socket \fIsock\fP.
Any operations that are currently in progress will be terminated, and will
fail with error \f(CREBADF\fP.
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B Note
.ps -1
.br
.sp
This function is provided for API
compatibility with legacy \fIlibnanomsg\fP.
Consider using the relevant modern API instead.
.sp .5v
.RE
.SH "RETURN VALUES"
.sp
This function returns zero on success, and \-1 on failure.
.SH "ERRORS"
.sp
\f(CREBADF\fP
.RS 4
The socket is not open.
.RE
.sp
\f(CRETERM\fP
.RS 4
The library is shutting down.
.RE
.SH "SEE ALSO"
.sp
nn_errno(3compat),
nn_socket(3compat),
nng_compat(3compat),
nng(7)